On this page
data_object
Data Format
Packet layout, timestamp semantics and coordinate frame.
Packet layout
Each measurement packet contains a batch of range readings for a contiguous angular span, plus a sensor timestamp taken at the start of the batch.
| Field | Type | Description |
|---|---|---|
| Header | uint8 | Fixed sync pattern |
| Timestamp | uint32 | Sensor clock, microseconds |
| Start angle | uint16 | Hundredths of a degree |
| Points | array | Range and intensity pairs |
Coordinate frame
Angles increase clockwise when viewed from above, with zero along the connector face. Confirm the orientation against a known target before trusting it in a mapping pipeline — mounting rotation is a common source of mirrored output.
Timing
The timestamp marks the start of the scan, not the arrival of the packet. Applying the arrival time instead introduces a lag that grows with network buffering and shows up as distortion at speed.