Advertisement

Quick Links

ShimmerCapture
User Manual
Rev 0.5a

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ShimmerCapture and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Shimmer ShimmerCapture

  • Page 1 ShimmerCapture User Manual Rev 0.5a...
  • Page 2 Neither the name of Shimmer Research, or Realtime Technologies Ltd. nor the names of its contributors may be used to endorse or promote products derived from this document without specific prior written permission.
  • Page 3: Table Of Contents

    Configuring the Shimmer ......................8 2.3.1. Configuration Window ....................8 2.3.2. Configuring with/without the Shimmer Dock ............... 12 2.4. Configuring a Shimmer GSR+ Expansion Board ..............13 2.5. Configuring a Shimmer ExG Module ..................14 2.6. Streaming Data ........................18 2.7.
  • Page 4: Introduction

    Rev 0.5a Introduction ShimmerCapture is a host side (PC) application that allows users to display and save data received from a single Shimmer device streaming over Bluetooth. The application allows the configuration of a range of parameters on the Shimmer3, and is primarily designed to demonstrate Shimmer’s functionality.
  • Page 5 Copyright © Shimmer 2014 Realtime Technologies Ltd ShimmerCapture User Manual All rights reserved Rev 0.5a Linux: Mono Framework runtime is required. There are precompiled binaries for most popular Linux versions, or, if necessary, it can be installed from source. For more information...
  • Page 6: Shimmercapture On Windows

    The Bluetooth serial port for the desired Shimmer3, as assigned during the pairing procedure, must be selected (for details on pairing a Shimmer device please refer to the Shimmer User Manual). This can be selected using the drop down menu, or by typing the value in manually. In Windows this will be in the form of “COM<nn>”.
  • Page 7 Shimmer firmware version Figure 2-3 ShimmerCapture display once connected. An important feature to note in ShimmerCapture can be seen in Figure 2-3. Similar to previous Shimmer Bluetooth streaming solutions, the "Stream" button enables streaming of data over the Bluetooth connection. However, a new feature of ShimmerCapture is the ability to simultaneously stream data over Bluetooth at the same time as logging to the on-board microSD card - which can be enabled by pressing the "Log+Stream"...
  • Page 8: Configuring The Shimmer

    2.3.1. Configuration Window Once ShimmerCapture is connected to the Shimmer3, it reads the current configuration saved on the Shimmer3. To view or change this configuration select Tools -> Configuration. This will bring up the general configuration window, as shown in Figure 2-4.
  • Page 9 Members area at www.shimmersensing.com. Enable Gyro-On-The-Fly Calibration: This will enable the calibration of the gyroscope while the Shimmer device is streaming. When enabled, the offset vector of the Gyroscope is recalculated when the Shimmer device is found to be stationary. Implementation details can be found in the ShimmerCapture source code.
  • Page 10 This field selects the range of the GSR sensor using a drop down menu. When set to Auto- Range, the most suitable range for the current reading is selected by the shimmer itself. This field is greyed out and not configurable if the GSR sensor is not selected.
  • Page 11 ShimmerCapture User Manual All rights reserved Rev 0.5a sensor, respectively, is enabled. Please refer to the Shimmer ExG User Guide for ECG or the Shimmer ExG User Guide for EMG for more details. Baud Rate: This field selects the baud rate of the Bluetooth module on the Shimmer3. Setting the baud rate to a higher value should allow streaming of more channels at a higher data rates while reducing packet loss.
  • Page 12: Configuring With/Without The Shimmer Dock

    Note: For more detailed information on the operation of the Trigger Mode options, consult the LogAndStream for Shimmer3 Firmware User Manual. 2.3.2. Configuring with/without the Shimmer Dock A Shimmer3 (programmed with LogAndStream firmware) can be configured through ShimmerCapture either with the Shimmer3 placed on the Shimmer Dock or with it in an undocked...
  • Page 13: Configuring A Shimmer Gsr+ Expansion Board

    Note: A Shimmer3 programmed with LogAndStream firmware should not be configured while it is placed on a Shimmer Multi Charger. In this state, the Shimmer3 thinks that it is connected to a Shimmer Dock and will surrender control of the microSD card. The settings will not be written to the configuration file and on next power-cycle or device reset, the settings in Infomem will be overwritten with old configuration parameters.
  • Page 14: Configuring A Shimmer Exg Module

    The numerical combo box allows users to select the window size of the buffer to average over when calculating Heart Rate. 2.5. Configuring a Shimmer ExG Module The "Advanced ExG" tab in the "Tools -> Configuration" menu allows users to configure a ExG Expansion Board.
  • Page 15 Setting determines whether the reference voltage used in the ExG amplifiers is a fixed reference voltage generated by the chip or taken from a feedback channel on the body. Please refer to the Shimmer ExG User Guide for ECG or the Shimmer ExG User Guide for EMG for more details.
  • Page 16 Table 2-1 ExG Configuration Bytes Contents ShimmerCapture provides a brief illustration of how the ExG lead off functionality can be used to detect whether all ECG leads are connected to the ExG board. See the following steps for illustration.
  • Page 17 Copyright © Shimmer 2014 Realtime Technologies Ltd ShimmerCapture User Manual All rights reserved Rev 0.5a All leads connected High quality ECG signal Figure 2-8 Streaming ECG signal with all leads connected 3. Remove one of the ECG leads and observe the “ExG Lead-Off Detection” checkboxes.
  • Page 18: Streaming Data

    ExG channels (ECG, EMG, ExG Test Signal). While Shimmer will make every effort to resolve this bug in a future release, users are reminded that ShimmerCapture is not intended to be the answer to all host side application requirements but instead as a quick start application which for many users can act as a stepping stone for more advance Shimmer applications.
  • Page 19: Status Bar

    Rev 0.5a Figure 2-10 Streaming Data. 2.7. Status bar The ShimmerCapture status bar provides a useful source of feedback for the state of the Shimmer3 device and the LogAndStream firmware. Connecting: While ShimmerCapture is connecting the Shimmer3, the status bar is continually updated with the current step in the Bluetooth connection sequence.
  • Page 20: Disconnecting From A Shimmer

    2.9. Saving data to a local file The data being received by ShimmerCapture can be saved to a local file on the PC in a comma separated value format (CSV). This facility can be enabled by selecting Tools → Save To CSV. A tick mark will appear next to this item in the Tools menu when the data is being saved to file.
  • Page 21: Show/Hide Graphs

    All rights reserved Rev 0.5a folder. The ability to read or write to this file will be locked by the ShimmerCapture application until the “Save to CSV” option is deselected or the ShimmerCapture application is closed. This feature can be enabled in both "Stream only" mode and "Log+Stream" modes.
  • Page 22: Orientation Visualisation

    ShimmerCapture includes a feature to visualise the 3D orientation of the Shimmer device, using a cube whose faces each have a different colour to represent each face of the Shimmer. To open the visualisation, follow Tools > Show 3D Orientation. This will open a new window, like that shown in Figure 2-17.
  • Page 23 1. Start streaming data from the Shimmer (via the Start button on the main ShimmerCapture window). 2. Ensure that the Shimmer is not moving (e.g. leave it resting on a table) for the initial settling period while the orientation estimate converges to the streamed data - the graphic will become static when the estimate has converged (this should take no more than a few seconds).
  • Page 24 ShimmerCapture User Manual All rights reserved Rev 0.5a Figure 2-19 Representation of the 'front' face of the Shimmer Device. Figure 2-20 Representation of the 'back' face of the Shimmer Device. To stop the 3D orientation visualisation, simply close the 3D Orientation window.
  • Page 25: Shimmercapture On Linux

    A working Bluetooth radio and the BlueZ Bluetooth libraries and tools need to be installed. See http://www.bluez.org for details. The operation of pairing a Shimmer device in Linux to be used with ShimmerCapture might vary from distribution to distribution. The following procedure was tested in Ubuntu 10.04 (including ShimmerLive 10.04) , Slackware 13, and OpenSuse 11.3.
  • Page 26: Using The Shimmercapture Executable

    To connect to the Shimmer in ShimmerCapture enter “/dev/rfcomm<n>” in the “Select COM port” field. For example, Figure 3-1 shows how to connect to Shimmer RN42-2418 which is bound to rfcomm0, as described above. Figure 3-1 Connecting to a Shimmer in Linux For all other functionality, follow the instructions for Windows, as detailed in Section 2 of this manual.
  • Page 27: Appendix

    Appendix 4.1. ShimDv2 File Format The ShimmerCapture application can log data locally to the PC in a format we have defined as SHIMDv2 (Shimmer Data version 2). SHIMDv2 format is a tab delimited text file which uses the extension .dat. The file contains both sensor data and header information.
  • Page 28 Copyright © Shimmer 2014 Realtime Technologies Ltd ShimmerCapture User Manual All rights reserved Rev 0.5a...

Table of Contents