Differences

This shows you the differences between two versions of the page.

--- ezfit:ark_datalogging_api [2009/01/28 08:56]
127.0.0.1 external edit
+++ ezfit:ark_datalogging_api [2008/06/29 16:22] (current)
ajdavis
@@ Line 2: / Line 2: @@
 An instrument using a Sound Design circuit, which supports datalogging, will generate a CSV file with the log details.  These values can be read independently of whether the instrument has been read or not.
 === Decoding CSV Datalog File ===
 The .csv file is a comma delimited file with the following row and column (field) definitions:
-  * The datalogging version is stored in the first line of the file (row 1). This row has 1 field only. Eg.: ''--Version 1.0--''
+  * The datalogging version is stored in the first line of the file (row 1). This row has 1 field. Eg.: ''--Version 1.0--''
-  * For (rows > 1) and (rows < TotalRows-1), the fields are as follows (there are 5 fields):
+  * Short-Term Data consists of 5 fields:
      # Timestamp
      # Battery Level
@@ Line 12: / Line 11: @@
      # VC Level
      # Ambient Level
-  * For the list row (TotalRows-1), the lifetime statistics (time spent in each memory) is stored. This row has 4 fields only. It has the following format:
+     # (2.0 only) iSceneDetect (Environment Classification) Value
-     # Total spend in Memory 1
+  * Long-Term Data is a single line written after the short-term data and consists of the number of cycles spent in each memory. This row has 4 fields in the following format:
-     # Total spend in Memory 2
+     # Total spent in Memory 1
-     # Total spend in Memory 3
+     # Total spent in Memory 2
-     # Total spend in Memory 4
+     # Total spent in Memory 3
-  * Example:<code csv>
+     # Total spent in Memory 4
---Version 1.0--
+  * (2.0 only) Interval time, calculated with the following formula: (X + 1)*4.096
+  * Examples:<code csv>
+--Version 1.0--
 ,2,0,0,55
 ,3,0,0,76
@@ Line 34: / Line 35: @@
 ,3,0,0,61
 ,5,1,0
+</code><code csv>
+--Version 2.0--
+,9,1,-6,55,14
+,9,0,-6,58,0
+,9,3,-6,58,14
+,9,0,-6,67,0
+,9,0,-6,67,2
+,9,0,-6,61,0
 </code>
+,9,0,-6,58,0
+. . .
+,9,0,-6,58,0
+,9,0,-6,55,2
+,246,19,454
+
+</code>
 === Field Details ===
@@ Line 43: / Line 58: @@
 . **Timestamp**
- * The timestamp is a value from 0 to 63.  Each increment of the timestamp represents 15 minutes of elapsed time.
+ * The timestamp is a value from 0 to 63(v1.0) or 0 to 255(v2.0).  Each increment of the timestamp represents 15 minutes of elapsed time.
  * At power on, the logging routine will always log a new value with a timestamp of 0 to represent a new session.
  * If the device remains powered on for more than 16 hours, the device will log a timestamp of 63 (even if nothing changed in the part), and the timestamps will start again at 1 (i.e. a timestamp of 0 will be skipped because this value indicates a new session).
@@ Line 49: / Line 64: @@
 . **Battery Level**
+iLog version 2.0 provides more granularity in the battery level
+v1.0 settings
  * The battery level is a value from 0 to 3.
  * 3 = 1.3V or higher
@@ Line 54: / Line 72: @@
  * 1 = 1.1V to 1.19V
  * 0 = Less than 1.1V
+v2.0 settings
+ * The battery level is a value from 0 to 15.
+ * 15 = 1.468 to 1.502
+ * 14 = 1.444 to 1.467
+ * 13 = 1.421 to 1.443
+ * 12 = 1.397 to 1.420
+ * 11 =1.373 to 1.396
+ * 10 = 1.350 to 1.372
+ * 9 = 1.326 to 1.349
+ * 8 = 1.303 to 1.325
+ * 7 = 1.279 to 1.302
+ * 6 =1.256 to 1.278
+ * 5 = 1.232 to 1.255
+ * 4 = 1.208 to 1.231
+ * 3 = 1.185 to 1.207
+ * 2 = 1.156 to 1.184
+ * 1 = 1.135 to 1.155
+ * 0 = Less than 1.135V
 . **Memory**
@@ Line 69: / Line 107: @@
  * 55 to 100 dBSPL
+. **iSceneDetect (Environmental Classification) Value**
+ *0 = Quiet Mode
+ * 2 = Speech In Quiet Mode
+ * 4 = Music Mode
+ * 8 = Noise Mode
+ * 10 = Speech In Noise Mode
+ * 14 = Off
+ * Odd value = Wind Mode (i.e. 1, 3, 5, 7, 9, 11, 13)
 === Generating a CSV Datalog File ===