-
Notifications
You must be signed in to change notification settings - Fork 13
Home
We apologize for the inconvenience, this wiki is currently under construction
The ShimmerBasicExample is the easiest example to start with.
In the Android API, you may notice methods with different names, but which appear to perform the same function.
For example, Shimmer.setSamplingRateShimmer(rate) vs Shimmer.writeShimmerAndSensorsSamplingRate(rate)
The differences between these methods are as follows:
Set - Modifies the setting on the Shimmer object in code only. These settings still have to be written to the physical device using a command e.g. shimmer.writeConfigBytes()
Write - Modifies the setting on the Shimmer object in code AND writes the setting to the physical Shimmer device
Each ObjectCluster (message) received from the Shimmer devices contains a record of the time when the message or the sample was recorded. These records are known as timestamps.
Each message can contain multiple types of timestamps, and the differences between each are listed below. Note that these names are found in Configuration.Shimmer3.ObjectClusterSensorName
TIMESTAMP - This is the Shimmer internal device clock timestamp, and is taken a sample is recorded on the device. This is the most accurate timestamp for identifying the exact time when a sample was recorded.
SYSTEM_TIMESTAMP - This is the timestamp which is taken when a packet has been received on an Android device. This is less accurate than the Shimmer's internal clock, as there will be variable latency introduced between the sample being recorded on the Shimmer, and the packet being received on the Android device. This is due to the nature of the Bluetooth connection.
This latency cannot be avoided, but it can be mitigated in part by methods such as a linear fit, which can be found in Section 7.2 of the Multi Shimmer Sync for Android user manual.
SYSTEM_TIMESTAMP_PLOT - This is the current TIMESTAMP added to an offset.
This offset is calculated once, when the first packet is received, using the equation: OFFSET = SYSTEM_TIMESTAMP - TIMESTAMP. This ensures that the latency between a Shimmer recording a packet and transmitting it to the Android device is constant and equal to the latency of the first packet received.
TIMESTAMP_OFFSET - It is not recommended to use this, as this is used for SD parsing.