Michael Piepers homepage
BeOS Programs
PalmBeach
PSION Link Protocol description
RFSV Protocol description

RFSV command STATUSDEVICE


Description of command

This command requests information to a certain DEVICE. The name of the DEVICE is transferred with the command. The supplied information are the same, as described in the command FDEVICEREAD.

It is to be noted that; all values, which are more greater than 8 bits in reverse order will transfer. The LOW byte sent as the first over the line and only then follows the HIGH byte!


Transmission direction (command) in the interface format

The commands STATUSDEVICE has always the same format. It is as a consequence built into the PLP:

Header PLP RFSV-STATUSDEVICE Foot CRC
16 10 02 32 03 02 01 Command
20 00
Size
02 00
Devicename
" C: "
10 03 12 34

Receipt direction (result) in the interface format

A valid response takes place with the command RFSV-RESPONSE and returns the delivery an error code.

Header PLP RFSV RESPONSE ...
16 10 02 33 02 03 01 Command
2a 00
Size
5a 00
Result
00 00
...
...

... Deviceinfo
...
...
Version
02 00
Type
02 00
changeable
00 00
Device size
00 00 00 00
Free space
00 00 00 00
Name
"boot"
Battery
ff ff
Reserve
16 *ff
...
...

... Foot CRC
...
...
10 03 12 34

boldValues represent fixed of values, which are used accurately in such a way!
italicValues represent examples, which have a different meaning on the basis the command.


Description of command

The command STATUS DEVICE consists of 3 information units. These have the following meanings:

Length in byte possible values Meaning
Command 2 byte 00 20 (fixed) The command identifier has always the same value!
Size 2 byte 00 02 (fixed) Always two bytes will transfer.
DEVICE name variable variable The DEVICE name is to be transferred, by which the information is required.

Description of result

The command STATUS DEVICE is answered with RESPONSE. This returns the delivery an error code and the information as result to the indicated DEVICE. If 00 00 is returned the delivery, then no error occurred.

Length in byte possible values Meaning
Command 2 byte 00 2a (fixed) The command identifier has always the same value!
Size 2 byte variable Dependent on the number of transmitted information units
Result 2 byte variable The result can obtain the following values:
NO_ERROR 00 00No error occurred
You can look at all defined errorvalues.
Version 2 byte 00 02 At present only the version 2 is supported.
Type 2 byte variable Determines, which type the DEVICE is. The following types are possible:
P_FMEDIA_UNKNOWN 00 00Unknown medium
P_FMEDIA_FLOPPY 00 01Floppy disk
P_FMEDIA_HARDDISK 00 02Harddisk
P_FMEDIA_FLASH 00 03Flash PROM
P_FMEDIA_RAM 00 04RAM
P_FMEDIA_ROM 00 05ROM
P_FMEDIA_WRITEPROTECTED 00 06Write protected medium
P_FMEDIA_FORMATTABLE 08 00The medium can be formatted
P_FMEDIA_DUAL_DENSITY 10 00the medium has double density
P_FMEDIA_INTERNAL 20 00It is an internal medium
P_FMEDIA_DYNAMIC 40 00The Size is suited dynamically
P_FMEDIA_COMPRESSIBLE 80 00Deleted data can be compressed
changeable 2 byte variable If the medium can be changed, then this value 00 01 (TRUE) has otherwise 00 00 (FALSE). This value becomes e.g.: with a floppy disk drive set.
Device size 4 byte variable The size of the complete DEVICE is indicated in bytes.
Free space 4 byte variable The number of the free storage space on DEVICES is indicated in bytes.
Volume name 16 byte 0-terminated string Here the volume name may be indicated. The name may be max. 15 byte long the last byte must be a 0-Byte.
Battery status 2 byte variable Gives the status to the battery of the DEVICE on (e.g.: with a buffered RAM)
Reserve 16 byte 16 * ff For extensions kept free workstation

Michael Piepers homepage
BeOS Programs
PalmBeach
PSION Link Protocol description
RFSV Protocol description

Last modification Jan 31 1999 by Michael Pieper