mDOS NMEA documentation
Some sensor data collected by the Medusa gamma-ray spectrometers is broadcast over a serial line in NMEA sentences, similar to the NMEA-0183 protocol. The typical baud rate used for sending these NMEA messages is 115.200 baud. Note that the NMEA output is a subset of the data that is available in JSON format. In the web interface of the mDOS system, a selection can be made from the sentences that are available.
Raw spectrum
The raw spectrum contains integer counts for each measurement channel. The number of channels (resolution) depends on the hardware configuration but is available as a field in the output. Note that this NMEA sentence may be longer than the 82 bytes specified by the NMEA-0183 protocol. The mDOS web interface contains a setting to combine multiple channels in the NMEA output. This allows reducing the number of bytes that have to be transmitted per spectrum. The cost is a reduced resolution in the spectrum. For example, if the spectrometers collects spectra of 512 channels, and 8 channels are combined in the NMEA output, the NMEA spectra will contain 512 / 8 = 64 channels each. This has no effect on the resolution of the spectra that are being stored on-board. Note that the bandwidth of serial communication is limited. In order to get more channels per spectrum, you could increase the baud rate of the serial communication, or set the spectrometer to record spectra at a lower frequency. Note that these settings are considered to be advanced user settings, there is no check if the available bandwidth is sufficient.
Meusa NMEA string example
$MSSPE,1634718239893,1.001,0.982,64,0,113,574,450,369,259,186,155,83,84,69,70,71,44,41,35,33,47,52,31,23,24,22,14,23,10,23,56,44,13,5,5,10,9,6,4,1,0,1,5,4,3,3,2,3,1,2,1,2,8,8,4,5,2,0,0,0,0,0,0,0,0,0,1*53
# | Example | Format | Description |
---|---|---|---|
0 | $MSSPE | %s | Sentence label, always $MSSPE |
1 | 1634718239893 | %d | A unix system timestamp, the number of milliseconds since Jan 1st 1970 |
2 | 1.001 | %.3f | Real time in seconds |
3 | 0.982 | %.3f | Live time in seconds |
4 | 64 | %d | Resolution of the spectrum (the number of channels) |
5 | 0 | %d | Number of counts in the first channel |
6 .. 4 + resolution | 113 .. 1 | %d | Number of counts in the other channels |
Activity concentrations
The mDOS system will analyse the recorded data and returns activity concentrations. Note that energy stabilization is required before activity concentrations can be calculated. Depending on the size of the scintillation crystal, this may take up to a few minutes. After a stabilization has been determined, it is continuously updated until the system is powered down.
Activity concentrations
$MSACT,1634738741388,1.002,0.983,0.682,1365.484,136.370,136.429,14.500,86.641,19.458*58
# | Example | Format | Description |
---|---|---|---|
0 | $MSACT | %s | Sentence label, always $MSACT |
1 | 1634738741388 | %d | A unix system timestamp, the number of milliseconds since Jan 1st 1970 |
2 | 1.002 | %.3f | Real time in seconds |
3 | 0.983 | %.3f | Live time in seconds |
4 | 0.682 | %.3f | Stabilization parameter. This number is used to translate a raw spectrum into an energy stabilized spectrum. |
5 | 1365.484 | %.3f | Activity concentration for 40K in Bq/kg |
6 | 136.370 | %3f | Uncertainty in the activity concentration for 40K in Bq/kg |
7 | 136.429 | %.3f | Activity concentration for 238U in Bq/kg |
8 | 14500 | %3f | Uncertainty in the activity concentration for 238U in Bq/kg |
9 | 86.641 | %.3f | Activity concentration for 232Th in Bq/kg |
10 | 19.458 | %3f | Uncertainty in the activity concentration for 232Th in Bq/kg |
PTH sensor
A PTH sensor is used to monitor the environmental properties air pressure, temperature and humidity.
PTH sensor
$MSPTH,1634738741389,1007.000,30.000,112.000*47
# | Example | Format | Description |
---|---|---|---|
0 | $MSPTH | %s | Sentence label, always $MSPTH |
1 | 1634738741389 | %d | A unix system timestamp, the number of milliseconds since Jan 1st 1970 |
2 | 1007.000 | %.3f | Real time in seconds |
3 | 30.000 | %.3f | Live time in seconds |
4 | 112.000 | %.3f | Stabilization parameter. This number is used to translate a raw spectrum into an energy stabilized spectrum. |
GPS
The spectrometer can process GPS data from the on-board GPS, or from an external source. The position data is available as an NMEA sentence.
GPS data
$MSGPS,1634738741389,53.211048,6.612187,2.857,1634636299006*6E
# | Example | Format | Description |
---|---|---|---|
0 | $MSPTH | %s | Sentence label, always $MSPTH |
1 | 1634738741389 | %d | A unix system timestamp, the number of milliseconds since Jan 1st 1970 |
2 | 53.211048 | %.3f | GPS latitude |
3 | 6.612187 | %.3f | GPS longitude |
4 | 2.857 | %.3f | GPS altitude in meters |
5 | 1634636299006 | %d | GPS timestamp |