Code: |
AS + 102 |
Symbolic: |
bccFlashDir |
This command will collect information and content of a flash folder of the connected device: this is a standard download transfer sequence.
REQDATA structure is the following:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U32 |
FLAGS |
Operating flags: 0x00000001 Absolute paths 0x00000002 Recursive 0x00000004 List folders 0x00000008 List files 0x00000030 Mask for date/time type: - 0x0 (default) - 0x1 Creation - 0x2 Last modification - 0x3 Last access 0x00000040 Fully qualified paths (implies absolute paths flag) 0x00000080 List hidden files/folders 0x00000100 Dereference symbolic links (#1) |
4 |
STRZ |
FILEMASK |
Folder and/or filename mask (with jollies) |
Note (#1): when showing file information for a symbolic link, show information for the file the link references rather than for the link itself.
If initial request fails, bccNack is received. Specific errors
NACK code |
Description |
Extra data |
---|---|---|
nackIllegalArgs |
Illegal parameters |
U16 What illegal: 1=Folder 2=Filename 3=Flags |
ITEMDATA structure is the following:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U8 |
HH |
Time (hour) of the item |
1 |
U8 |
MM |
Time (minute) of the item |
2 |
U8 |
SS |
Time (second) of the item |
3 |
U8 |
DD |
Date (day) of the item |
4 |
U8 |
MO |
Data (month) of the item |
5 |
U8 |
YY |
Data (year - 2000) of the item |
6 |
U32 |
ATTRIB |
Attributes: 0x00000001 Absolute folder paths 0x00000002 Reserved file 0x00000004 System file 0x00000008 Illegal file 0x00000010 File in use (left open) 0x00000020 Hidden file 0x00000040 Read-only file 0x00000080 Symbolic link 0xF0000000 File type - 0x0 Generic - 0x1 Folder (special file) - 0x2 OS standard - 0x3 OS test - 0x4 OS standard flat - 0x5 Old language (without OS) - 0x6 FIFO (queue) |
10 |
U16 |
DEVID |
Flash device ID |
12 |
U16 |
CRC16 |
CRC16 file value (0 no information available) |
14 |
U16 |
- |
Reserved |
16 |
U32 |
SIZE |
Effective item size [bytes] |
20 |
STRZ |
FILENAME |
Folder or filename |
Notes:
•bccData messages will begin with pid = 0 and will be incremented by 1 at each message.
•bccEndData contain last item and after it the transfer is completed
•The data transfer could be aborted at any time with a bccAbort command.