Code: |
AS + 109 |
Symbolic: |
bccFlashInfo |
This command will request information about a flash of the connected device. Request parameters are the following:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U32 |
FLAGS |
Operating flags: 0x00000001 Search by name 0x00000002 Query underlying physical device name |
4 |
U16 |
DEVID |
Flash device ID |
6 |
STRZ |
NAME |
Flash name (if search by name required) |
On success, a bccAck is received with the following data:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U16 |
TYPE |
Device type 0x0000 Generic 0x0001 Standard flash (Robox) 0x0002 Limited flash (Robox) 0x0003 Compact flash/SD/MicroSD (< 4GiB) 0x0004 Ramdisk (Robox) 0x0005 Larger SD/MicroSD (>= 4GiB) |
2 |
U16 |
DEVID |
Flash device ID |
4 |
B[32] |
DATA |
Data according TYPE |
36 |
STRZ |
NAME |
Flash name (if required) or physical device name |
On failure, a bccNack is receivedSpecific errors:
NACK code |
Description |
Extra data |
---|---|---|
nackIllegalArgs |
Illegal parameters |
U16 What illegal: 1=Flags 2=Flash device ID 3=Flash name
|
For standard flash (type 0x0001) data are following:
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U32 |
SIZE |
Flash size [bytes] |
+4 |
U32 |
FREE |
Flash free space [bytes] |
+8 |
B[24] |
|
(reserved) |
For limited flash (type 0x0002) data are following:
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U32 |
FREE |
Flash free space [bytes] |
+4 |
B[28] |
|
(reserved) |
For compact flash/SD/MicroSD (< 4GiB; type 0x0003) data are following:
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U32 |
SIZE |
Flash size [bytes] |
+4 |
U32 |
FREE |
Flash free space [bytes] |
+8 |
B[24] |
|
(reserved) |
For ramdisk (type 0x0004) data are following:
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U32 |
SIZE |
Flash size [bytes] |
+4 |
U32 |
FREE |
Flash free space [bytes] |
+8 |
B[24] |
|
(reserved) |
For larger SD/MicroSD (>= 4Gib; type 0x0005) data are following:
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U64 |
SIZE |
Flash size [bytes] |
+8 |
U64 |
FREE |
Flash free space [bytes] |
+16 |
B[16] |
|
(reserved) |