Data logger

ID Name Type #Val Min Max Attr Description

701

Data logger data item 1

Uint16

4

 

 

 

Up to 16 data items can be logged simultaneously, and one trigger condition can be set. DataIDs 701-716 define the data items to be logged. Items must be defined in order starting at "Data logger data item 1" (DataID 701), not leaving any unused items. The logger will ignore items after the first unused one.

A db file data entry is defined as a comma delimited data entry.  For example:

     3001, 1, 0, 2

where:

    3001 = DataID to log
    1 = Select robot 1 (Primary index)
    0 = Secondary index (not used)
    2 = Index into 3001 array, selects motor 2

702

Data logger data item 2

Uint16

4

 

 

 

703

Data logger data item 3

Uint16

4

 

 

 

704

Data logger data item 4

Uint16

4

 

 

 

705

Data logger data item 5

Uint16

4

 

 

 

706

Data logger data item 6

Uint16

4

 

 

 

707

Data logger data item 7

Uint16

4

 

 

 

708

Data logger data item 8

Uint16

4

 

 

 

709

Data logger data item 9

Uint16

4

 

 

 

710

Data logger data item 10

Uint16

4

 

 

 

711

Data logger data item 11

Uint16

4

 

 

 

712

Data logger data item 12

Uint16

4

 

 

 

713

Data logger data item 13

Uint16

4

 

 

 

714

Data logger data item 14

Uint16

4

 

 

 

715

Data logger data item 15

Uint16

4

 

 

 

716

Data logger data item 16

Uint16

4

 

 

 

741

Data logger trigger 1

FLt32

11

 

 

 

An array of numeric values that defines the trigger conditions for data logging to start or stop. The trigger can compare two logged data items or one logged data item with a constant value.

The array elements are as follows:

    1 - Trigger opcode
        0: No trigger, run until stopped.
        1: Trigger if item 1 > item 2
        2: Trigger if item 1 < item 2
        3: Trigger if item 1 = item 2
        4: Trigger if item 1 <> item 2
    2 - Trigger mode
       -1: No trigger, run until full.
        0: Start on trigger true, run until full.
        1: Start on trigger true, run until trigger false. 
        2: Stop on trigger true.
    3 - Time offset from trigger, in seconds. If < 0, this many seconds of data before the trigger time is included in the datalog. If > 0, this many seconds of data after the trigger occurs is included.
    4 - DataID for item 1. Must be logged.
    5 - Primary index for item 1.
    6 - Secondary index for item 1.
    7 - Array index for item 1.
    8 - DataID for item 2 or zero. If zero, the constant value in DataID 742 is used as item 2. If non-zero, must be logged.
    9 - Primary index for item 2.
   10 - Secondary index for item 2
   11 - Array index for item 2.

742 Data logger trigger immediate data 1 Flt64         Constant floating point value compared to the 1st trigger item.
750 Data logger buffer size in bytes Uint32         Obsolete, no longer used.
751 Data logger interval in sec Flt64         Interval values are rounded internally to be a multiple of the servo period. This value is how often the datalogger samples the defined logged items.
752 Data logger load command Bool         None of the logging parameters have any effect until they are loaded into the data logger by the 'load' command. When the load parameter is set to 1, the system stops any logging in progress and loads all the previously defined parameters. This value automatically clears itself.
753 Data logger enable Bool         Once the data logger is loaded, this parameter is used to enable logging.

    1 = enable logging
    0 = disable logging

754

Data logger info

Flt64

11

 

 

RO

An array of values that contains information about the most recently logged data. The array elements are as follows:

    1. State of the data logger: 0=idle, 1=active.
    2. Number of records in the buffer.
    3. Logging interval, in seconds.
    4. Number of data items per record.
    5. Size of a single record, in bytes.
    6. Timestamp of the oldest item in the buffer, in seconds.
    7. Timestamp when start triggered, in seconds.
    8. Timestamp when stop triggered, in seconds.
    9. Percent of the log buffer that is filled, from 0 to 100.
  10. Trigger state: 0=Not triggered, 1=Trigger on, 2=Trigger off.
  11. Percent of the log buffer written after trigger occurred, from 0 to 100.

755 Data logger comment text String   0 60   Comment line that is included in the header of the data logger output file. This can be set by the user to document the contents of the data set.
756 Data logger max time in sec Flt32         The maximum time, in seconds, for which data is saved. Specifying a time of zero causes all buffered data to be released. This value, in combination with "Data logger interval in sec" (DataID 751) and the number of data items being logged, determines how much system memory is used for logging.
760 Data logger time for read Flt64         To read a record of logged data, This parameter along with DataID 761 select the record. This data item normally is set to one of the timestamp values returned by DataID 754.
761 Data logger index for read Uint32         This is the sample index, from 0 to n.
762 Data logger data array Flt64 16     RO Used to read the record. This is 16 comma delimited ASCII numbers. Each element of the array corresponds to one of the 16 possible logged data items specified by DataIDs 701 through 716. If an invalid timestamp sample is specified, a data value of 0 is returned.

780

CPU Monitor control

Unit8

 

0

2

 

Controls the CPU Monitor. Allows thread timing information to be obtained. Set to 2 to start the CPU Monitor and gather data. The CPU Monitor shuts off automatically after the time interval specified by "CPU Monitor interval (DataID 781), and this value is changed from 2 to 1. Set to 1 to immediately stop the CPU Monitor. Set to 0 to disable/delete the CPU Monitor and delete any data log. If the monitor runs for more than 171 seconds, the % CPU usage values are not valid, but the logged data is valid.

781

CPU Monitor interval in sec

Uint8

 

0

120

 

The number of seconds the CPU Monitor should run after it is started. It automatically stops after this amount of time passes. If set to 0, the CPU Monitor runs continually until "CPU Monitor control" (DataID 780) is changed from 2. This value is sampled when 2 is written to "CPU Monitor control" (DataID 780).

782

CPU Monitor log max entries

Unit32

 

 

 

 

The maximum number of entries that can be saved in the CPU Monitor data log. Each log entry requires 4 bytes of memory. For a typical system, one second of log data requires at least 18000 entries. If DataID 781 is set to 0, the log buffer wraps around so that only the most recent values are saved. This value is sampled when 2 is written to "CPU Monitor control" (DataID 780).

783

CPU Monitor file comment

String

 

 

60

 

Optional comment string that is included in the CPU Monitor data file that is transmitted via the web interface. This can be used to annotate the data collection run.