Beacons are status data packets sent by all active boxes once per second. This way, you can check signal quality, power status and settings of all boxes available in your timing setup. It is recommended to monitor this data and alert if an Active System can no longer be seen, power is low, or otherwise.
Call
BEACONGET\n
Reply
BEACONGET;00\n [BeaconCount:2]\n <beacon(0)>\n ... <beacon([BeaconCount]-1)>\n <beacon([BeaconCount])>\n \n
Response
|
[BeaconCount] |
The number of passings which will be returned in this request |
|
<beacon(i)> |
The returned beacon i, as described in the next section |
Example (single beacon, standard format)
← BEACONGET\n → BEACONGET;00\n → 01\n → 3039;1;10;17;64;7;1;1;31;245d;00000000;03;00;00;21;00;00\n → \n
Example (3x beacons, additional FW2.6 data fields after <CONFSET;B3;1>)
← BEACONGET\n → BEACONGET;00\n → 03\n → 06f6;0;03;25;32;5;2;0;7b;11fd;095fe75000;03;02;00;00;99;24;00;1a;14;21;+20;0;00;00;00\n → 9dd0;1;00;05;1e;5;0;0;a9;00b5;095fe72300;03;0a;00;00;bf;2d;00;1a;50;81;+26;0;00;00;00\n → 3039;1;10;15;64;5;1;1;31;255e;095fe72302;03;06;00;20;00;00;00;1a;1e;35;+1d;0;04;00;00\n → \n
Beacon Format
[ActiveDeviceID:4];[LoopStatus:1];[Mode:2];[LoopData:2];[LoopPower:2];[Channel:1];[LoopId:1];[PowerConn:1];[PowerStatus:2];[BeaconIndex:4];[Time:8];[RFU:2];[ChNoiseAvg:2];[RFU:2];[TransEnergyDetect:2];
[RFU:2];[BeaconEnergyDetect:2]
FW2.6 format after setting <CONFSET;B3;1>
[ActiveDeviceID:4];[LoopStatus:1];[Mode:2];[LoopData:2];[LoopPower:2];[Channel:1];[LoopId:1];[PowerConn:1];[PowerStatus:2];[BeaconIndex:4];[Time:10];[BeaconVersion:2];[ChNoiseAvg:2];[RFU:2];[TransponderEnergyDetect:2];
[RFU:2];[BeaconEnergyDetect:2];[BeaconSuccessRate:1];[FWVersion:2];[BoxType:2];[BoxMode:2];[Temperature:+2];[BufferOverflow:1];[BufferFillState:2];[AvgTransponderRetries:2];[AvgRepeatRetries:2]
|
[ActiveDeviceID] |
Device ID of system |
|
[LoopStatus] |
0 = loop ok |
|
[BeaconMode] |
0x00 = Active Extension or USB Timing Box in Timing Mode 0x10 = No Timing Device (Management Box, USB Timing Box in Kiosk mode etc...) 0x21 = Tracking Start 0x22 = Tracking Stop |
|
[LoopData] |
Reserved |
|
[LoopPower] |
Current power setting of the device (00 - ff) => (0 - 256) |
|
[Channel] |
Channel ID (0 - f) => (1 - 8) |
|
[LoopID] |
Loop ID, (0 - f) => (1 - 8) |
|
[PowerConn] |
0 = 12V |
|
[PowerStatus] |
If [PowerConn] == 2, [PowerStatus]== battery remaining in hours |
|
[BeaconIndex] |
Index of beacon sent, count from number of beacons sent since startup |
|
[Time] |
The current number of ticks for the system Standard Format: 32 Bit - 256th seconds FW 2.6 Format: 40 Bit - 2048th seconds |
|
[ChNoiseAvg] |
Average noise level of current channel [0..10] with 0 = no noise |
|
[TransEnergyDetect] |
Average RSSI for communication between the Active System and all transponders seen since startup Values are from 0..85. You need to calculate -90+TransEnergyDetect to get RSSI values from -90dBm...-5dBm |
|
[BeaconEnergyDetect] |
Average RSSI for communication between the Active System and the base system (Loop ID == 1) seen since startup |
|
[BeaconSuccessRate] |
0..10 - with 10 = all expected beacons received and 0, no beacons received at all |
| [FWVersion] | 26 = 2.6 |
| [BoxType] | 0A=Active Extension, 0x14=Loop Box, 0x1E=Management Box, 0x28=USB Timing Box, 0x50=Ubidium |
| [BoxMode] | See Box Mode Table |
| [Temperature] | Temperature of Main Microcontroller in C° |
| [BufferOverflow] | 1=at least one buffer overflow since last boot, 0=no buffer overflow so far |
| [BufferFillState] | 0..100% with 100% = buffer full |
| [AvgTransponderRetries] | ACKS + BUSY, 0 is good, 1..2 is OK, everything above means there is a problem |
| [AvgRepeatSuccessRate] | 0...100% - with 0% very good, 100% very bad. >50% is not good. |
RFU = Reserved for Future Use - data in these fields must be ignored