Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
ezfit:ark_datalogging_api [2009/06/26 13:00]
ajdavis
ezfit:ark_datalogging_api [2008/06/29 16:22] (current)
ajdavis
Line 4: Line 4:
 === Decoding CSV Datalog File === === Decoding CSV Datalog File ===
 The .csv file is a comma delimited file with the following row and column (field) definitions: 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      # Timestamp
      # Battery Level      # Battery Level
Line 11: Line 11:
      # VC Level      # VC Level
      # Ambient Level      # Ambient Level
-  For the list row (TotalRows-1), the lifetime statistics (time spent in each memory in 15 minute increments) is stored. This row has 4 fields only. It has the following format:+     # (2.0 only) iSceneDetect (Environment Classification) Value 
 +  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 spent in Memory 1      # Total spent in Memory 1
      # Total spent in Memory 2      # Total spent in Memory 2
      # Total spent in Memory 3      # Total spent in Memory 3
      # Total spent in Memory 4      # Total spent in Memory 4
-  * Example:<code csv> +  * (2.0 only) Interval time, calculated with the following formula: (X + 1)*4.096 
---Version 1.0-- +  * Examples:<code csv> 
 +--Version 1.0--
 0,2,0,0,55 0,2,0,0,55
 0,3,0,0,76 0,3,0,0,76
Line 33: Line 35:
 0,3,0,0,61 0,3,0,0,61
 1283,5,1,0 1283,5,1,0
 +</code><code csv>
 +--Version 2.0--
 +0,9,1,-6,55,14
 +85,9,0,-6,58,0
 +233,9,3,-6,58,14
 +248,9,0,-6,67,0
 +249,9,0,-6,67,2
 +250,9,0,-6,61,0
 +2
 </code> </code>
 +
 +5,9,0,-6,58,0
 +. . .
 +20,9,0,-6,58,0
 +21,9,0,-6,55,2
 +365,246,19,454
 +6
 +</code>
 +
 === Field Details === === Field Details ===
 For any rows with the exception of the first and last rows, these are the fields: For any rows with the exception of the first and last rows, these are the fields:
 1. **Timestamp** 1. **Timestamp**
  
- * The timestamp is a value from 0 to 255.  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.  * 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).  * 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 44: Line 64:
 2. **Battery Level** 2. **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.    * The battery level is a value from 0 to 3.  
  * 3 = 1.3V or higher  * 3 = 1.3V or higher
Line 49: Line 72:
  * 1 = 1.1V to 1.19V  * 1 = 1.1V to 1.19V
  * 0 = Less than 1.1V  * 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
 +
  
 3. **Memory** 3. **Memory**
Line 64: Line 107:
  
  * 55 to 100 dBSPL  * 55 to 100 dBSPL
 +
 +6. **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 === === Generating a CSV Datalog File ===