EXT0003: Device Journal

• Extension dependencies: EXT000F
• Document status: Testing

This extension describes reading and clearing the journal of accumulated data (typically measurement history).

Journal Format

<DATE> (<VAL> ...)

Field	Length	Description
DATE	4 bytes	Unix timestamp (seconds since 1970-01-01 UTC)
VAL	variable	Tracked parameter values (device-specific)

All journal entries have the same length within a session.

Commands

0005 Read Journal

Read tracked parameter values. Returns maximum records that fit in response.

Request:

<TID> 3900 0006 0005 <AFTERREC>

Response:

<TID> 3900 <LEN> 0005 <LASTREC> [<RECORDS>]

Field	Length	Description
AFTERREC	4 bytes	LASTREC from previous packet (0 for first request)
LASTREC	4 bytes	Address of last entry in current packet
RECORDS	variable	Journal entries (descending date order)

Errors:

Code	Description
0010	ROM read error
0011	Invalid AFTERREC

0006 Clear Journal

Clear all journal contents. Starts asynchronous process (use 0019 for result).

Request:

<TID> 3900 0002 0006

Response:

<TID> 3900 <LEN> 0006 <PROCID> [<BUSYTIME>]

Field	Length	Description
PROCID	2 bytes	Process ID for result query
BUSYTIME	4 bytes	Max time if not background

Process Errors:

Code	Description
0010	ROM write error
0011	ROM resource expired