Graph
Accel real-time graph : Displays accelerometer packets in real time. Frequency domain display and CVS save function are available.
Sensor Graph : TWELITE Stores data from various sensors in a sqlite3 database and displays graphs.
Acceleration real-time graph
Windows macOS Linux RasPi
Used for the purpose of referencing sample data from TWELITE CUE and TWELITE MOTION SENSE PAL.
Note: The Sensor Graph Function records one packet as one sample, even when continuous measurement is performed such that multiple samples are included in one packet.
CUE mode, MOT mode, and 2525 FIFO mode.
When the number of consecutive samples exceeds a certain number (analysis window), the XYZ axis is displayed with frequency analysis. However, in 2525 FIFO mode, it is always assumed to be continuous.
When a packet is explicitly delimited (when more than 3 seconds have elapsed since the previous packet, every packet in CUE mode, or when the sequence number of packets becomes discontinuous in MOT mode), a dummy of 4 samples is (When more than 3 seconds have elapsed since the last packet.
Data is stored for up to 4 nodes in order of arrival first.
During multi-node operation, communication failures often occur due to mutual packet collisions. In particular, in FIFO mode, the transmission cycle is almost constant, and packets are attempted to be sent at almost the same time to each other, resulting in transmission failures due to interference, which may continue for a long time. In principle, one node per CHANNEL should be used.
measure continuously at about 25 Hz. (Transmit Interval: 0, Sensor Parameter: 03000000)
measure continuously at about 50 Hz. (Transmit Interval: 0, Sensor Parameter: 03000100)
measure continuously at about 100 Hz. (Transmit Interval: 0, Sensor Parameter: 03000200)
measure 128 samples at about 100Hz about every 10 seconds. (Transmit Interval: 10, Sensor Parameter: 03000208)
measure 256 samples at about 100Hz about every 10 seconds. (Transmit Interval: 10, Sensor Parameter: 03000210)
measure 64 samples at about 50Hz every 10 seconds. (Transmit Interval: 10, Sensor Parameter: 03000104)
measure 128 samples at about 200Hz about every 10 seconds. (Transmit Interval: 10, Sensor Parameter: 03000308)
The sampling rate is calculated from the packet reception time. Since the reception time of multiple past samples is averaged to obtain one sample, the error will be larger if there are packet skips, etc.
After the sample rate is estimated, the graph display scrolls smoothly.
The timestamp of the related log record (T_SMPL) is also estimated in the same way, and the timestamp is after the time of packet acquisition.
Specify 31 in [STAGE Common Settings→Designate Startup Application].
By clicking the [Data Save] button, data for up to 512 samples will be output starting from the display position on the screen (rightmost sample). Note that the most recent sample comes last, so there may be no data at the beginning.
The log file name is log folder/accel_{serial number}_{time stamp}.csv.
The most recent sample on the right end is the 512th data (at the end of the file).
When frequency analysis is performed, the number of frequency analysis samples is the number of frequency analysis samples from the last sample.
The frequency analysis results are added to the line where the sample subject to frequency analysis is recorded (in the case of 64 samples, the 32nd line from the 449th sample is the result, from DC component to high frequency component).
When this screen is opened and data is entered, a log file is automatically output.
The log file name is log folder/accel_{serial number}_{time stamp}.csv.
While the screen is open, the file is being written out. It may not be opened for reading, or even if it is opened, all data may not be read.
Sensor Graph
Windows macOS Linux RasPi
Various sensor data are recorded in a database file. There is also a function to simply refer to the measured values on the TWELITE Stage screen.
It is not possible to start multiple TWELITE STAGE with the same executable name and use the sensor graph at the same time.
The database file is stored in the {MWSTAGE installation}/log folder and the file name is determined by the TWELITE_Stage executable name.This is because the same executable file name refers to the same database file. The TWELITE STAGE app implementation does not expect multiple application instances to be adding data to the database at the same time. In some situations, this may result in a database file access error, which may cause the TWELITE STAGE app to crash.
For example, if you want to connect two MONOSTICKs and run multiple "sensor graphs" at the same time, run the TWELITE STAGE application with different executable names (stage_a.exe, stage_b.exe) for each. The database file names are log/stage_a_WSns.sqlite and log/stage_b_WSns.sqlite.
Data is stored in a file named {MW_STAGE Install}/log/{MW_STAGE file name}_WSns.sqlite using sqlite3.
The screen transition is [List (with graph preview)]>[24-hour data]>[Live View].
From [24-hour data], you can move to [Year], [Month], [Day (with graph preview)] selection screen.
About the [Live] display screen
Select a specific node from the list.
Display real-time data every second, up to 450 seconds in the past.
About [24-hour data] display screen
Display data for a specific day.
Data is acquired every second, and if there are multiple data, they will be thinned out.
Except for the maximum magnification (1 second per pixel), the data is displayed by averaging the acquired values in each pixel range.
If the value extends beyond the screen, the measurement points are displayed at the top and bottom edges.
If the current time is included, the display is updated when new data arrives.
Wheel, cursor up/down: zoom in/out of time axis
Mouse move: Simplified display of the acquired data in the time axis corresponding to the mouse pointer.
Cursor→, ←: Move to the next acquisition data.
Click and drag: Scroll (only when zoomed in)
When zoomed in, operation by scroll bar is also available.
The [CSV Output] function displays all acquired values contained in the database.
Use the tools at https://sqlitebrowser.org/ to extract data.
v1.3.9or later
On the "24-hour data screen," left-clicking on the memo portion of the sensor node in the upper right corner of the screen will prompt you to edit the memo.
IME input operations (e.g. Japanese) may depend on the system you are using.
Unexpected character strings may be input depending on the operation at the time of IME input. When an unnecessary string is displayed in the input area, delete the unnecessary part by pressing the BS key.
There are three basic types of screens: list, 24-hour, and live.
Specify 32 in [STAGE Common Settings -> Startup Application Designation].
Used to store additional information (text) in sensor nodes.
Used for the purpose of maintaining the last received timestamp.
| Operation | Desc. |
|---|---|
| Label | Item | Desc. |
|---|---|---|
| Label | Item | Desc. |
|---|---|---|
| Label | Item | Desc. |
|---|---|---|
| Label | Item | Desc. |
|---|---|---|
| Operation | Desc |
|---|---|
| Key | Description |
|---|---|
| Column Name | Type | Description |
|---|---|---|
| Column Name | Type | Description |
|---|---|---|
| Column Name | Type | Description |
|---|---|---|
Right part of the [(I)ID#] button
Switch IDs with each click. (Note: For continuous sample data in FIFO mode, operation with multiple IDs is not practical.
Right part [(f)SMP#] button
Change the frequency analysis size to 64, 128, or 256 with each click.
right part [[>PAUSE( )] button
aborts display update (sample acquisition is performed until the internal temporary sample buffer is full)
right part [(c)SAVE DISPLAYED DATA] button
output data in CSV format (log folder). Outputs data from the sample displayed on the rightmost side of the screen to the oldest sample in the buffer. The number of output is always 5120, and the sample displayed on the rightmost side of the screen is the last data.
Mouse drag (graph section)
Move the position of the displayed sample
Mouse drag (bottom scroll bar)
Move the position of the displayed sample (in larger steps)
Cursor→, ←
Move sample display
Cursor↑, ↓
Zoom in/out on the sample horizontal axis (Equal, 2x, 3x, 4x; for 256 analysis samples, 2x). (Equal, 2x, 3x, 4x, up to 2x if the number of samples is 256)
#
Sample number
T_PKT[ms]
Packet reception time
Since one packet contains multiple samples, samples with the same timestamp are lined up.
SEQ
Packet Sequence Number
Packets are assigned and if they are consecutive, there is no missing packet.
T_SMPL[ms]
Sample time (virtual or estimated)
Timestamp of each sample generated from the packet reception time. It does not match the actual time the sample was taken. (The error is large because the sample rate is estimated from the received packet interval, and the timestamp is one packet period later than the actual sample time because the sample period is calculated by adding the sample period to the received sample.
X[G]
Sample value on the X-axis
Based on the value from the sensor, the unit is [G].
Y[G]
sample value of Y axis
based on the value from the sensor, unit is [G].
Z[G]
sample value of Z-axis
based on the value from the sensor, unit is [G].
FD#
Number of the frequency analysis calculated value
If the number of frequency analysis samples is 64, they are ordered in the order of DC,1,2,...,31. ,31` if the number of frequency analysis samples is 64.
Hz
Frequency axis value of the frequency analysis calculation result
Approximate frequency. The frequency is calculated by (FD# / FD_Len) * FD_Freq.
X
Frequency analysis calculated value of X-axis
Y
Frequency analysis calculated value of Y-axis
X
X-axis frequency analysis calculated value
Label
additional information name
see table below
Info
additional information
see table below
Label
Additional Information
Refer to the table below
ModuleSID
Serial number of the sending side
Tick[ms]
System on TWELITE STAGE app side at log file open [ms]
Date
Date when log file was opened
Time
Time
Time_Msec_part
Time when log file was opened
Time_Msec_part
Less-than-seconds portion of log file open [ms]
Samples
Valid sample data
FD_Len
Number of frequency analysis samples
FD_Start#
Frequency analysis start sample number
FD_Freq
Frequency estimate of frequency analysis range [Hz]
Estimated value from sample reception interval
FD_Freq
#
Sample number
T_PKT[ms]
Packet reception time
Since one packet contains multiple samples, samples with the same timestamp are lined up.
SEQ
Packet Sequence Number
Packets are assigned and if they are consecutive, there is no missing packet.
T_SMPL[ms]
Sample time (virtual or estimated)
Timestamp of each sample generated from the packet reception time. It does not match the actual time the sample was taken. (The error is large because the sample rate is estimated from the received packet interval, and the timestamp is one packet period later than the actual sample time because the sample period is calculated by adding the sample period to the received sample.
X[G]
Sample value on the X-axis
Based on the value from the sensor, the unit is [G].
Y[G]
sample value of Y axis
based on the value from the sensor, unit is [G].
Z[G]
sample value of Z-axis
based on the value from the sensor, unit is [G].
Label
Additional information name
Refer to the following table
Info
Additional Information
Refer to the table below
ModuleSID
Serial number of the sending side
Tick[ms]
System on TWELITE STAGE app side at log file open [ms]
Date
Date when log file was opened
Time
Time_Msec_part
Time when log file was opened
Time_Msec_part
Less-than-second part of log file open [ms]
Mouse drag (graph area)
Move the display position when zooming in
Mouse drag (bottom scroll bar)
Move the display position when zooming in
Cursor →, ←
Move the sample display
Cursor up, down, wheel
Zoom in/out on sample horizontal axis
[LIVE>>]
Go to the one-second increment view that displays the latest arrival data
[24Hr Data]
Go to daily graph
[<Nodes]
Go to the nodes selection screen
[Yr] [Mo] [Dy]
Select a specific date by year, month, and day.
[ltst]
Go to today's data
[CSV exprot]
Output one day's data to CSV file
[DISP] at Nodes screen
Change the display method of the list
[SORT] at Nodes screen
Change the order of the list
[↑] at Nodes screen
Reverses the order of the listings
ASCII charavcters
If you enter a normal alphanumeric string directly, it will be switched accordingly on the screen.
BS
Delete the trailing characters displayed.
ENTER
The entered string is reflected in the database.
_uqid
INTEGER
continuation number used in the database
sid
INTEGER
int32_t
serial number stored in int32_t type." In the case of the serial number "8123abcd", the integer value of -2,128,368,691 is stored.
ts
INTEGER
The time the system received the packet, a timestamp value stored of type int64_t UNIX epoch (seconds elapsed since 1970).
ts_msec
INTEGER
The milliseconds portion of the timestamp.
year
INTEGER
The year portion of the local time from the timestamp.
month
INTEGER
The month portion of the local time from the timestamp.
day
INTEGER
The day portion of the local time relative to the timestamp.
hour
INTEGER
The hour portion of local time from the time stamp.
lid
INTEGER
The identification value, e.g., LID, assigned by the user.
lqi
INTEGER
Approximate value of the reception strength (Link Quality Indicator).
pkt_seq
INTEGER
The sequential number of the packet. The possible values depend on the firmware.
pkt_type
INTEGER
The type of wireless packet.
2 PAL AMB, 6 ARIA
1 PAL MAG
*3 PAL MOT,5 CUE
0x101 App_Twelite, *0x103 App_IO
*Not supported at this time
value
REAL
measured value (definition depends on packet type)
pkt_type->
2,6: temperature
1: presence of magnet 00->no magnet, 01->N-pole, 02->S-pole
3,5: X axis acceleration (average if packet includes multiple 0x101,103: bitmap of input IO (same value as the last 8 bits of val_dio)
value1
REAL
measured value (definition depends on packet type)
pkt_type->
2,6: Humidity[%]
1: not used
3,5: Y axis acceleration (average value if packet contains multiple samples)[G]
0x101: ADC1[V] ,103: Not used
value2
REAL
measured value (definition depends on packet type)
pkt_type->
2: illuminance[lx], 6: not used
1: not used
3,5: Z axis acceleration (average value if packet contains multiple samples)[G ]
0x101: ADC2[V], 103: unused
value3
REAL
measurement value (definition depends on packet type)
pkt_type->
2: not used, 6: not used
1: not used
3,5: not used
0x101: ADC3[V], 103: not used
val_vcc_mv
INTEGER
voltage[mV]
val_dio
INTEGER
int32_t
b0..b7: DI1..DI8 values (1 is LO, 0 is HIGH level) b24..b25: magnet value (if b28 is 1), 00->no magnet, 01->N pole, 10->S pole b28: if 1 Magnet data is stored in b24..b25 b31: Regular transmission bit (magnet only)
val_adc1_mv
INTEGER
pkt_type->1,2,3,0x101: Measured value of ADC1
val_adc2_mv
INTEGER
pkt_type->0x101: Measured value of ADC4
val_adc2_mv
INTEGER
Other data storage purpose
ev_src
INTEGER
Source of the event
ev_id
INTEGER
Event ID
pal_type->5: 1.... .6 -> dice 16 -> MOVE ... etc. (see documentation for TWELITE CUE)
ev_param
INTEGER
Event Parameter
sid
INTEGER
SID above
sid_text
TEXT
SID converted to hexadecimal string (for readability)
desc
TEXT
Auxiliary information corresponding to the SID, to be displayed together in a list, etc.
sid
INTEGER
SID above.
ts
INTEGER
Timestamp of last receipt
lid
Here are some excerpts from the last data received
lqi
pkt_type
value
value1
value2
value3
val_vcc_mw
val_dio
ev_id
