Response 67h, RETAFDIR (Directory listing report)
Report Packet 67h sends a listing of the application files in the application file directory. The report is requested with Command Packet 66h.
Report Packet 67h can exceed the maximum data byte limit (248 bytes of data) for RS-232 Serial Interface Specification packets, depending on the number of application files stored in memory. Each application file directory entry occupies 17 bytes. The application file directory block (bytes 8 to 24) is repeated for every application file stored in directory. At least one application file exists (SYSTEM FILE INDEX number 0, the Default Application File). The receiver can store multiple user-defined application file records.
Report Packet 67h is divided into subpackets called pages when the data byte limit is exceeded. The PAGE INDEX and MAXIMUM PAGE INDEX bytes are used to account for the pages included in the report (0 of 2, 1 of 2, 2 of 2).
The TX BLOCK IDENTIFIER uses a roll-over counter to assign a transaction number to the report packet pages. The TX BLOCK IDENTIFIER INDEX number is useful for preventing data mismatches when stream synchronization is lost.
The following table describes the packet structure.
NOTE – All date and time fields are relative to UTC.
|
Byte |
Item |
Type |
Value |
Meaning |
|---|---|---|---|---|
|
0 |
STX |
1 (Char) |
02h |
Start transmission. |
|
1 |
STATUS |
1 (Char) |
See Receiver status byte. |
Receiver status code. |
|
2 |
PACKET TYPE |
1 (Char) |
67h |
Report Packet Type. |
|
3 |
LENGTH |
1 (Char) |
Data byte count. |
|
|
4 |
TX BLOCK IDENTIFIER |
1 (Char) |
00h–FFh |
Unique number assigned to every application file transfer. |
|
5 |
PAGE INDEX |
1 (Char) |
00h–FFh |
Page index assigned to packet page. |
|
6 |
MAXIMUM PAGE INDEX |
1 (Char) |
00h–FFh |
Page index assigned to the last packet page. |
|
7 |
# APP FILES |
1 (Char) |
00h–n |
Number of application files in directory. |
|
First application file directory record. This block is repeated for each application file. |
||||
|
8–9 |
SYSTEM FILE INDEX |
2 (Char) |
Record number assigned to the file. |
|
|
10–17 |
APP FILE NAME |
8 (Chars) |
ASCII text |
Name of application file (8 ASCII characters). |
|
18 |
CREATION YEAR |
1 (Char) |
00h–FFh |
Year when file is created. Based on the years since 1900 (1900 = 00). |
|
19 |
CREATION MONTH |
1 (Char) |
01h–0Ch |
Month of the year when file is created (1–12). |
|
20 |
CREATION DAY |
1 (Char) |
01h–1Fh |
Day of the month when file is created (1–31). |
|
21 |
CREATION HOUR |
1 (Char) |
00h–17h |
Hour when file is created (0–23). |
|
22 |
CREATION MINUTES |
1 (Char) |
00h–3Bh |
Minutes of hour when file is created (0–59). |
|
23–24 |
APP FILE SIZE |
2 (Short) |
bytes |
Size of file. |
|
Additional application file directory records. |
||||
|
Length +4 |
CHECKSUM |
(Char) |
Checksum value. |
|
|
Length +5 |
ETX |
(Char) |
|
End transmission. |
System file index values
The following table provides values for the system file index byte.
|
Byte Value |
Notes |
|
|---|---|---|
|
Dec |
Hex |
|
|
0 |
00h |
Application file record number of the default application file, which contains factory default values. |
|
1 |
01h |
Application file record number of the current application file, which contains current setting values. |
|
2–n |
02h–nh |
Application file record number for stored application files. |