Added initial XDATA parser, with OIF411 support

Author: Mark Jessop

build.sh

@@ -25,6 +25,7 @@ java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations -
 java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations --nomunge tracker.js >> mobile.js
 java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations --nomunge app.js >> mobile.js
 java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations --nomunge colour-map.js >> mobile.js
+java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations --nomunge xdata.js >> mobile.js
 
 #compile plot lib and config
 java -jar "../tools/yuicompressor-2.4.8.jar" --type=js --disable-optimizations --nomunge _jquery.flot.js >> init_plot.js

js/xdata.js

@@ -0,0 +1,125 @@
+/* SondeHub XDATA Parser Library
+ *
+ * Author: Mark Jessop
+ */
+
+function parseOIF411(xdata){
+    // Attempt to parse an XDATA string from an OIF411 Ozone Sounder
+    // Returns an object with parameters to be added to the sondes telemetry.
+    //
+    // References: 
+    // https://www.vaisala.com/sites/default/files/documents/Ozone%20Sounding%20with%20Vaisala%20Radiosonde%20RS41%20User%27s%20Guide%20M211486EN-C.pdf
+    //
+    // Sample data:      0501036402B958B07500   (length = 20 characters)
+    // More sample data: 0501R20234850000006EI (length = 21 characters)
+
+    // Cast to string if not already
+    xdata = String(xdata);
+
+    // Run some checks over the input
+    if(xdata.length < 20){
+        // Invalid OIF411 dataset
+        return {};
+    }
+
+    if(xdata.substr(0,2) !== '05'){
+        // Not an OIF411 (shouldn't get here)
+        return {};
+    }
+    _output = {'xdata_instrument': 'OIF411'};
+
+    // Instrument number is common to all XDATA types.
+    _output['oif411_instrument_number'] = parseInt(xdata.substr(2,2),16);
+
+
+    if(xdata.length == 21){
+        // ID Data (Table 19)
+        // Serial number
+        _output['oif411_serial'] = xdata.substr(4,8);
+
+        // Diagnostics word. 
+        _diagnostics_word = xdata.substr(12,4);
+        if(_diagnostics_word == '0000'){
+            _output['oif411_diagnostics'] = "All OK";
+        }else if(_diagnostics_word == '0004'){
+            _output['oif411_diagnostics'] = 'Ozone pump temperature below −5 °C.';
+        }else if(_diagnostics_word == '0400'){
+            _output['oif411_diagnostics'] = 'Ozone pump battery voltage (+VBatt) is not connected to OIF411';
+        }else if (_diagnostics_word == '0404'){
+            _output['oif411_diagnostics'] = 'Ozone pump temp low, and +VBatt not connected.';
+        }else {
+            _output['oif411_diagnostics'] = 'Unknown State: ' + _diagnostics_word;
+        }
+
+        // Version number
+        _output['oif411_version'] = (parseInt(xdata.substr(16,4),16)/100).toFixed(2);
+
+        return _output
+    } else if (xdata.length == 20){
+        // Measurement Data (Table 18)
+        // Ozone pump temperature - signed int16
+        _ozone_pump_temp = parseInt(xdata.substr(4,4),16);
+        if ((_ozone_pump_temp & 0x8000) > 0) {
+            _ozone_pump_temp = _ozone_pump_temp - 0x10000;
+        }
+        _output['oif411_ozone_pump_temp'] = _ozone_pump_temp*0.01; // Degrees C
+
+        // Ozone Pump Current
+        _output['oif411_ozone_current_uA'] = parseInt(xdata.substr(8,5),16)*0.0001; // micro-Amps
+
+        // Battery Voltage
+        _output['oif411_ozone_battery_v'] = parseInt(xdata.substr(13,2),16)*0.1; // Volts
+
+        // Ozone Pump Current
+        _output['oif411_ozone_pump_curr_mA'] = parseInt(xdata.substr(15,3),16); // mA
+
+        // External Voltage
+        _output['oif411_ext_voltage'] = parseInt(xdata.substr(18,2),16)*0.1; // Volts
+
+
+        return _output
+
+    } else {
+        return {}
+    }
+}
+
+function parseXDATA(data){
+    // Accept an XDATA string, or multiple XDATA entries, delimited by '#'
+    // Attempt to parse each one, and return an object
+    // Test datasets:
+    // "0501034F02C978A06300"
+    // "0501R20234850000006EI"
+    // "0501034F02CA08B06700#800261FCA6F80012F6F40A75"
+    // "800262358C080012FE6C0A70#0501035902BA08908400"
+
+    // Split apart any contatenated xdata.
+    if(data.includes('#')){
+        data_split = data.split('#');
+    } else {
+        data_split = [data];
+    }
+
+    _output = {};
+    for(xdata_i = 0; xdata_i < data_split.length; xdata_i++){
+        _current_xdata = data_split[xdata_i];
+
+        // Get Instrument ID
+        _instrument = _current_xdata.substr(0,2);
+
+        if(_instrument === '05'){
+            // OIF411
+            _xdata_temp = parseOIF411(_current_xdata);
+            _output = Object.assign(_output,_xdata_temp);
+        } else if (_instrument === '80'){
+            // Unknown!
+            //console.log("Saw unknown XDATA instrument 0x80.")
+        } else {
+            // Unknown!
+
+        }
+    }
+
+    return _output
+
+}