From cef4e4901c5d96892a251b9bf80b5c390452df28 Mon Sep 17 00:00:00 2001
From: Mikhail Grushinskiy <mgrouch@users.noreply.github.com>
Date: Wed, 30 Oct 2024 13:23:52 -0400
Subject: [PATCH] Create NmeaXDR.h

---
 bbn_m5atomS3_lite_TVOC_SGP30/NmeaXDR.h | 90 ++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 bbn_m5atomS3_lite_TVOC_SGP30/NmeaXDR.h

diff --git a/bbn_m5atomS3_lite_TVOC_SGP30/NmeaXDR.h b/bbn_m5atomS3_lite_TVOC_SGP30/NmeaXDR.h
new file mode 100644
index 0000000..f8a527b
--- /dev/null
+++ b/bbn_m5atomS3_lite_TVOC_SGP30/NmeaXDR.h
@@ -0,0 +1,90 @@
+#ifndef NmeaXDR_h
+#define NmeaXDR_h
+
+/*
+  XDR - Transducer Measurement
+  https://gpsd.gitlab.io/gpsd/NMEA.html#_xdr_transducer_measurement
+  https://www.eye4software.com/hydromagic/documentation/articles-and-howtos/handling-nmea0183-xdr/
+
+  Format: $--XDR,a,x.x,a,c--c, ..... *hh<CR><LF>
+  Example:
+
+  $HCXDR,A,171,D,PITCH,A,-37,D,ROLL,G,367,,MAGX,G,2420,,MAGY,G,-8984,,MAGZ*41
+  $SDXDR,C,23.15,C,WTHI*70
+
+  Transducer Types:
+     A - Angular displacement
+     C - Temperature
+     D - Depth
+     F - Frequency
+     H - Humidity
+     N - Force
+     P - Pressure
+     R - Flow
+     B - Absolute humidity
+     G - Generic
+     I - Current
+     L - Salinity
+     S - Switch, valve
+     T - Tachometer
+     U - Voltage
+     V - Volume
+     could be more
+
+  Unit of measurement                                     
+     "" - could be empty!                                 
+     A - Amperes                                          
+     B - Bars | Binary                                    
+     C - Celsius                                          
+     D - Degrees                                          
+     H - Hertz                                            
+     I - liters/second                                    
+     K - Kelvin | Density, kg/m3 kilogram per cubic metre 
+     M - Meters | Cubic Meters (m3)                       
+     N - Newton                                           
+     P - Percent of full range | Pascal                   
+     R - RPM                                              
+     S - Parts per Thousand (ppt)                               
+     V - Volts                                            
+     could be more
+*/
+
+/*
+  Bareboat Necessities Sensors NMEA-0183 XDR Sentences:
+
+  NMEA-0183 Sender 
+     BB
+
+  Transducer Types:
+     X - Extra
+      
+  Air Quality: 
+    Transducer type: X (Extra)
+    Unit of measurement: 
+    Transducer names:
+      TVOC - Total Volatile Organic Content (ppb)
+      eCO2 - CO2 (ppm)
+      rawH2 - Raw H2
+      rawEthanol - Raw Ethanol
+
+  Examples:
+
+  Total Dissolved Solids:
+  
+  $BBXDR,X,0.3955,S,TDS*12
+  $BBXDR,X,0.3958,S,TDS*1F
+  $BBXDR,X,0.3952,S,TDS*15
+  $BBXDR,X,0.3955,S,TDS*12
+
+*/
+
+#include "NmeaChecksum.h"
+
+void gen_nmea0183_xdr(const char *nmea_fmt, float value) {
+  char nmea_part[82];
+  snprintf(nmea_part, 76, nmea_fmt, value);
+  int checksum = nmea0183_checksum(nmea_part);
+  Serial.printf("%s*%02X\r\n", nmea_part, checksum);
+}
+
+#endif