1.2 Technical Support and Repairs Standard Limited Product Warranty: Yost Labs warrants the media and hardware on which products are furnished to be free from defects in materials and workmanship under normal use for sixty (60) days from the date of delivery except for OEM warranty items(see below).
User's Manual Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. • Consult the dealer or an experienced radio/TV technician for help. • To satisfy FCC RF Exposure requirements for mobile and base station transmission devices, a separation distance of 20 cm or more should be maintained between the antenna of this device and persons during operation.
Page 8
User's Manual Don’t dry a wet or damp sensor unit with an appliance or heat source, such as a hair dryer or microwave oven. • Don't drop the sensor unit. Dropping, especially on a hard surface, can potentially cause damage to the sensor •...
Bluetooth communicates with a host PC via any standard internal or external Bluetooth adapter. Each sensor is assigned a unique Bluetooth MAC Address thus allowing any number of sensor to be used with a single Bluetooth host simultaneously. Additionally, each YEI 3-Space Bluetooth sensor unit can communicate with multiple associated hosts.
User's Manual 2.3 Hardware Overview 1. USB Connector – The 3-Space Sensor uses a 5-pin mini USB connector to connect to a computer via USB and to charge the internal battery. The USB connector provides for both power and communication signals. 2.
User's Manual 2.4 Features The YEI 3-Space Sensor Bluetooth has many features that allow it to be a flexible all-in-one solution for your orientation sensing needs. Below are some of the key features: Small self-contained high-performance wireless AHRS at 35mm x 60mm x 15mm and 28 grams •...
User's Manual 2.5 Block Diagram of Sensor Operation USB 2.0 Host System TSS Bluetooth LiPo Battery & Bluetooth Module Charge Management & Antenna Processor 2.4Ghz Bluetooth USB 2.0 SPP Interface Interface USB Mouse & Final Joystick Orientation Emulation Non-volatile Calibration & Performance Kalman Settings...
User's Manual 2.6 Specifications General Part number TSS-BT (Handheld Sensor Unit) TSS-BT-S (Screw-down Sensor Unit) Dimensions 35mm x 60mm x 15mm (1.38 x 2.36 x 0.59 in.) Weight 28 grams ( 0.98 oz ) Supply voltage +5v USB Battery technology rechargeable Lithium-Polymer Battery lifetime 5+ hours continuous use at full performance...
User's Manual 2.7 Physical Dimensions 2.8 Axis Assignment All YEI 3-Space Sensor product family members have re-mappable axis assignments and axis directions. This flexibility allows axis assignment and axis direction to match the desired end-use requirements. The natural axes of the 3-Space Sensor are as follows: The positive X-axis points out of the right hand side of the sensor, which is the side that is facing right when •...
User's Manual 3. Description of the 3-Space Sensor 3.1 Orientation Estimation The primary purpose of the 3-Space Sensor is to estimate orientation. In order to understand how to handle this estimation and use it in a meaningful way, there are a few concepts about the sensor that should be understood. The following sections describe these concepts.
User's Manual 3.1.3 Component Sensor Data Types Component sensor data is presented by the 3-Space Sensor in three different stages and is readily accessible via certain protocol commands. Raw Sensor Data: This refers to data that is read directly from each of the component sensors before any •...
User's Manual 3.1.5 Reference Vectors In order to get an absolute estimation of orientation from the accelerometer and compass, the sensor needs a reference vector for each to compare to the data read from it. The most obvious choice for these are the standard direction of gravity(down) and the standard direction of magnetic force(north), respectively.
User's Manual 3.1.8 Offset Orientation There are many applications for which it will be necessary or convenient to mount the sensor at odd angles, but it may also be desired in these situations that orientations can be treated as though the sensor were mounted normally. For example, if the sensor were mounted on a sloped surface of a vehicle like a car hood, it would be helpful if the orientations could read as though the sensor was mounted in a way that more closely matched the overall orientation of the vehicle, which does not include that slope.
User's Manual 3.2 Communication Obtaining data about orientation from the sensor or giving values for any of its settings is done through the sensor's communication protocol. The protocol can be used through either the USB port or the RS232 port. A complete description of how to use this protocol is given in section 4 of this document.
Page 20
User's Manual 2) Set up the streaming interval, duration, and start delay. These parameters control the timing of the streaming session. They can be set using command 82(0x52). All times are to be given in microseconds. They control the streaming as follows: Interval determines how often the streaming session will output data from the requested commands.
User's Manual 3.3 Input Device Emulation 3.3.1 Axes and Buttons The 3-Space Sensor has the ability to act as a joystick and/or mouse when plugged in through USB. Both of these are defined in the same way, as a collection of axes and buttons. Axes are input elements that can take on a range of values, whereas buttons can only either be on or off.
User's Manual 3.4 Sensor Settings 3.4.1 Committing Settings Changes made to the 3-Space Sensor will not be saved unless they are committed. This allows you to make changes to the sensor and easily revert it to its previous state by resetting the chip. For instructions on how to commit your changes, see the Quick Start guide or 3-Space Suite manual.
Page 23
User's Manual LED Color Determines the RGB color of the LED 0,0,1(Blue) Joystick Enabled Determines whether the joystick is enabled or not TRUE Mouse Enabled Determines whether the mouse is enabled or not FALSE Button Gyro Disable Length Determines how many cycles the gyro is ignored after a button is pressed Multi Reference Weight Power Determines what power each multi reference vector weight is raised to 10...
User's Manual 4. 3-Space Sensor Usage/Protocol 4.1. Usage Overview 4.1.1 Protocol Overview The 3-Space Sensor receives messages from the controlling system in the form of sequences of serial communication bytes called packets. For ease of use and flexibility of operation, two methods of encoding commands are provided: binary and text.
User's Manual 4.2. Protocol Packet Format 4.2.1 Binary Packet Format The binary packet size can be three or more bytes long, depending upon the nature of the command being sent to the controller. Each packet consists of an initial “start of packet” byte, followed by a “command value” specifier byte, followed by zero or more “command data”...
Page 26
User's Manual integer or byte sized parameter, the floating point number given for that parameter will be interpreted as being the appropriate data type. For simplicity, the ASCII encoded commands follow the same format as the binary encoded commands, but ASCII text encodings of values are used rather than raw binary encodings. Each ASCII packet is formatted as shown in figure 2.
User's Manual 4.3 Response Header Format 4.3.1 Wired Response Header The 3-Space Sensor is capable of returning additional data that can be prepended to all command responses. This capability is managed via the Response Header Bitfield, which can be configured using command 221 (0xDD). Each bit in the field, if enabled, corresponds to a different piece of information that will be output prior to the expected response data.
User's Manual For the ascii version, we would send the following: “;66\n” We would receive the following response: “389617043,37,-1072.00000,-3392.00000,16176.00000\r\n” 4.3.2 Wired Streaming with Response Header Streaming data can also have Response Header data prepended to each streamed packet. This can be accomplished by calling the Start Streaming command (0x55) with the Response Header Packet Byte.
User's Manual 4.4 Command Overview There are over 90 different command messages that are grouped numerically by function. Unused command message bytes are reserved for future expansion. When looking at the following command message tables, note the following: The “Data Len” field indicates the number of additional data-bytes the command expects to follow the •...
User's Manual 4.4.2 Normalized Data Commands Return Data Command Description Long Description Data Len Return Data Details Data Details Returns the normalized gyro rate vector, accelerometer vector, and compass vector. Note that Gyro Rate in units of the gyro vector is in units of radians/sec, while the radians/sec (Vector x3), accelerometer and compass are unit-length vectors indicating the direction of gravity and north,...
User's Manual Return Data Command Description Long Description Data Len Return Data Details Data Details Gyro Rate in counts per Returns the raw gyro rate vector, accelerometer degrees/sec (Vector x3), vector and compass vector as read directly from the Acceleration Vector in component sensors without any additional post- counts per g (Vector x3), Get all raw component...
User's Manual 4.4.7 Configuration Write Commands Sets the current euler angle decomposition order, which determines how the angles returned from command 0x1 are decomposed from the full quaternion orientation. Possible values are 0x0 for Euler angle decomposition Set euler angle XYZ, 0x1 for YZX, 0x2 for ZXY, 0x3 for ZYX, 0x4 for order 16(0x10)
Page 33
User's Manual Determines how trusted the compass contribution is to the overall orientation estimation. Instead of using a single value, uses a minimum and maximum value. Trust values will be selected from this range depending on the confidence factor. This can have Minimum compass trust value Set confidence compass the effect of smoothing out the compass when the...
Page 34
User's Manual Directly set the multi-reference compass vector at the specified index. First parameter is index, second Set compass mulfi- parameter is compass vector. Intended for advanced Index (Byte), Compass 112(0x70) reference vector users. Reference Vector (float x3) Set the compass reading to be used as a check vector to determine which cell index to draw the reference vector from.
Page 35
User's Manual Set compass reference Sets the static compass reference vector for Single Compass Reference Vector 118(0x76) vector Reference Mode. (float x3) Set accelerometer Sets the static accelerometer reference vector for Accelerometer Reference 119(0x77) reference vector Single Reference Mode. Vector (float x3) 120(0x78) Reset filter Resets the state of the currently selected filter...
User's Manual 4.4.8 Configuration Read Commands Return Data Command Description Long Description Data Len Return Data Details Data Details Get tare orientation as 128(0x80) Returns the current tare orientation as a quaternion. Quaternion (float x4) quaternion Get tare orientation as Returns the current tare orientation as a rotation 129(0x81) rotation matrix...
Page 37
User's Manual Reads number of cell divisions and number of nearby vectors per cell for the multi-reference vector lookup table. For more information on these values, please Number of cell divisions Get multi-reference refer to the Set Multi-Reference Resolution (byte), number of nearby 150(0x96) resolution command (111).
User's Manual 4.4.9 Calibration Commands Return Data Command Description Long Description Data Len Return Data Details Data Details Sets the current compass calibration parameters to the specified values. These consist of a bias which is added to the raw data vector and a matrix by which the value is multiplied.
User's Manual 4.4.10 Battery Commands Return Data Command Description Long Description Data Len Return Data Details Data Details Read the current battery level in volts. Note that this value will read as slightly higher than it actually is if Battery level in voltage 201(0xc9) Get battery voltage it is read via a USB connection.
User's Manual 4.4.11 General Commands Allows finer-grained control over the sensor LED. Accepts a single parameter that can be 0 for standard, which displays all standard LED status indicators or 1 for static, which displays only the 196(0xc4) Set LED Mode LED color as specified by command 238.
User's Manual Sets the communication mode for USB. Accepts one value that can be 0 for CDC (default) or 1 for USB communication mode 233(0xe9) Set USB Mode FTDI. (byte) USB communication mode 234(0xea) Get USB Mode Returns the current USB communication mode. (byte) Returns the serial number, which will match the 237(0xed)
User's Manual 4.4.13 General HID Commands Return Data Command Description Long Description Data Len Return Data Details Data Details Sets the operation mode for one of the controls. The first parameter is the control class,which can be 0 for Joystick Axis, 1 for Joystick Button, 2 for Mouse Axis or 3 for Mouse Button.
User's Manual Appendix USB Connector The 3-Space Sensor has a 5-pin USB Type-B jack and can be connected via a standard 5-pin mini USB cable. Hex / Decimal Conversion Chart Second Hexadecimal digit...
Page 44
Notes: Serial Number: _____________________________________...
Need help?
Do you have a question about the 3-Space Bluetooth and is the answer not in the manual?
Questions and answers