gyro boy improvements (#236)

gyro boy improvements

libs/datalog/_locales/datalog-jsdoc-strings.json

@@ -3,6 +3,9 @@
   "datalog.addValue": "Adds a cell to the row of data",
   "datalog.addValue|param|name": "name of the cell, eg: \"x\"",
   "datalog.addValue|param|value": "value of the cell, eg: 0",
+  "datalog.flush": "Commits any buffered row to disk",
+  "datalog.setEnabled": "Turns on or off datalogging",
   "datalog.setFile": "Starts a new data logger for the given file",
+  "datalog.setFile|param|filename": "the filename, eg: \"datalog.csv\"",
   "datalog.setStorage": "* @param storage custom storage solution"
 }

libs/datalog/_locales/datalog-strings.json

@@ -1,6 +1,7 @@
 {
   "datalog.addRow|block": "datalog add row",
   "datalog.addValue|block": "datalog add %name|=%value",
+  "datalog.setEnabled|block": "datalog %enabled",
   "datalog|block": "datalog",
   "{id:category}Datalog": "Datalog"
 }

libs/datalog/datalog.ts

@@ -3,13 +3,16 @@ namespace datalog {
     let _headers: string[] = undefined;
     let _headersLength: number;
     let _values: number[];
+    let _buffer: string = "";
     let _start: number;
-    let _filename = "data.csv";
+    let _filename = "datalog.csv";
     let _storage: storage.Storage = storage.temporary;
+    let _enabled = true;
 
     function clear() {
         _headers = undefined;        
         _values = undefined;
+        _buffer = "";
     }
 
     function init() {
@@ -31,7 +34,10 @@ namespace datalog {
                 _headersLength = _storage.size(_filename);
             }
             // commit row data
-            _storage.appendCSV(_filename, _values);
+            _buffer += storage.toCSV(_values, _storage.csvSeparator);
+            // buffered writes
+            if (_buffer.length > 1024)
+                flush();
         }
 
         // clear values
@@ -44,6 +50,8 @@ namespace datalog {
     //% weight=100
     //% blockId=datalogAddRow block="datalog add row"
     export function addRow(): void {
+        if (!_enabled) return;
+        
         commit();
         init();
         const s = (control.millis() - _start) / 1000;
@@ -65,16 +73,16 @@ namespace datalog {
             i = _headers.length - 1;
         }
         _values[i] = value;
-        if (i > 0) // 0 is time
-            console.logValue(name, value)
     }
 
     /**
      * Starts a new data logger for the given file
+     * @param filename the filename, eg: "datalog.csv"
      */
     //%
-    export function setFile(fn: string) {
-        _filename = fn;
+    export function setFile(filename: string) {
+        flush();
+        _filename = filename;
         clear();
     }
 
@@ -84,7 +92,31 @@ namespace datalog {
      */
     //%
     export function setStorage(storage: storage.Storage) {
+        flush();
         _storage = storage;
         clear();
     }
+
+    /**
+     * Commits any buffered row to disk
+     */
+    //%
+    export function flush() {
+        if (_buffer) {
+            const b = _buffer;
+            _buffer = "";
+            _storage.append(_filename, b);
+        }
+    }
+
+    /**
+     * Turns on or off datalogging
+     * @param enabled 
+     */
+    //% blockId=datalogEnabled block="datalog %enabled"
+    //% enabled.fieldEditor=fieldonoff
+    export function setEnabled(enabled: boolean) {
+        flush();
+        _enabled = enabled;
+    }
 }