Summary of Contents for TeraBee TeraRanger Hub Evo
Page 1
User Manual for TeraRanger Hub Evo Hardware revision 1.0 Firmware revision 1.1.1 Technical support: s upport@teraranger.com S a l e s a n d c o m m e r c i a l s u p p o r t : ...
2 .1 Mechanical Design Figure 1. TeraRanger Hub Evo external dimensions TeraRanger Hub Evo external dimensions are illustrated in Figure 1. The board provides two mounting holes, both designed for M3 screws. The straight distance between mounting holes is 45.5mm. Figure 2 illustrates external dimensions of the UART board.
TeraRanger Evo sensors use a two-part construction where the black colored optical sensor module simply clips to the yellow colored backboard for power management and communication. . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: ...
Page 5
Please note that the H ub backboard i s required for connecting Evo sensors to the Hub Evo board (see Figure 3). External dimensions of the Hub backboard are illustrated in Figure 4: Figure 4. Hub backboard external dimensions . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: support@teraranger.com ...
2.2 Handling during system assembly Please follow these simple steps showing how to connect 8 TeraRanger Evo sensors to the TeraRanger Hub Evo. Step 1. Connecting the cable to the sensor Start by plugging the flat flex cables (FFC) to the sensor’s FFC connector.
Page 7
Step 2. Connecting the sensor to the Hub Evo Follow the instructions above to connect the cables’ other end to the FFC connector on TeraRanger Hub Evo board. Figure 8. Open, Insert, Close (hub) Step 3. Connecting all Evo sensors to the Hub Evo Continue connecting the rest of the Evo sensors to the central Hub board (Figure 9).
Page 8
Once fully assembled, the TeraRanger Hub Evo is ready for testing on your computer. Use the micro USB cable (provided in the package) to connect the TeraRanger Hub Evo with a host computer. Instructions on how to connect the system to a host computer or use a Graphical User Interface are available in section 3.1 and 3.2.
Page 9
UART board and the other cable end to the host of your choice. Figure 12. Connecting the UART cable NB. Wiring instructions for Pixhawk autopilots are available here: https://www.terabee.com/evo-connection-to-pixhawk-autopilots-teraranger-tower-evo/ The following aspects should also be taken into consideration when handling the TeraRanger Hub Evo: . Terabee Website: www.teraranger.com ...
TeraRanger Hub Evo while it is powered ● Do not mount the TeraRanger Hub Evo onto hot surfaces or near other sources of heat ● Take all usual precautions for sensitive electronics such as maintaining a suitable distance from strong electric and magnetic fields, strong radio emitters, etc.
3.1.1 Basic Operation Make sure TeraRanger Hub Evo is connected to a USB port on your computer and to a suitable power supply. Select File > Connect. You should immediately see distance readings of TeraRanger Evo sensors displayed on the main chart.
3 .1.1 Firmware Upgrade The current firmware version on your TeraRanger Hub Evo can be found by selecting H elp > About in the GUI. It is possible to upgrade the firmware running on your device if a new firmware version is made available by Terabee.
3.2 Connecting the TeraRanger Hub Evo to a Host Computer The TeraRanger Hub Evo can be easily connected to a Host Computer via the micro USB cable provided in the package. The TeraRanger Hub Evo can interact as a virtual COM port, and data can be streamed directly to terminal emulation software (Terabee advises to use HTerm for Windows and CoolTerm for MacOS).
Page 14
Figure 14 shows an example of the command which allows data to be shown in TEXT mode. All commands are detailed in section 5. In MacOS, Terabee advises the use of Coolterm for terminal emulation software. . ...
3.3 LEDs In total, four LEDs are mounted on TeraRanger Hub Evo to give visual feedback on the sensor performance. Table below lists the functionality of each LED: LED color Description Hub Visual continuously whenever (orange) connected to a power supply...
Figure 17. Pinout layout for UART 4 .2 UART protocol information The UART communication for the TeraRanger Hub Evo uses a simple Modbus-like protocol. The communication parameters are: Baud Rate : 921600 baud Data Bits : 8 Stop Bit(s) : 1 Parity...
LED signalization is not based on the closest sensor to an obstacle. However, this will only affect the LED signalization and not the distance sensing capability. . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: ...
Page 19
Control data output to drive four WS2812B LEDs Power supply and interface ground Figure 18. W S2812B serial communication, p inout layout . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: support@teraranger.com 01630, Saint-Genis-Pouilly Commercial: teraranger@terabee.com ...
Update rate modes IMU modes Figure 19 illustrates the logic of available parameters on Hub Evo. Please note all commands to be sent via terminal emulation software are in hexadecimal format. Figure 19. TeraRanger Hub Evo modes . Terabee Website: ...
Carriage return character: \r ( 13 decimal / 0x0D hex) New line character: \n (10 decimal / 0x0A hex) **if a sensor is not connected or the TeraRanger Hub Evo is unable to obtain the distance measurement from the TeraRanger Evo sensor, the associated distance value is replaced by the hexadecimal value “-1”.
The Hub Evo is shipped with default pre-programed thresholds, but you can set your own by using the command below: Action Type Hex Command Set visual signalization 00 53 01 UU LL CRC8 threshold . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: support@teraranger.com 01630, Saint-Genis-Pouilly Commercial: teraranger@terabee.com ...
Magnetic fields and vibration can disrupt IMU calibration. In order to force a self-calibration of the IMU, move the TeraRanger Hub Evo in ways that use the full range of each axis. Here is a non-exhaustive list of motions that help with calibration: For magnetometer and gyroscope: (1) draw a figure of eight into the air, (2) make a full turn in the two directions of each axis (6 rotations in total).
Quaternions and linear acceleration mode displays the same coefficient as the quaternion mode, however it also gives the linear acceleration of the IMU in milli-g. Please refer to figure 20. . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: ...
Page 27
Note: To convert those values to m.s-2 the conversion factor is 0 .00980665 It is important to know that there might be a constant offset (this can be visualized when the TeraRanger Hub Evo is not moving) on the acceleration values, that can be corrected by calibrating the IMU (see section 5.6).
Orientation data in quaternion format (2 bytes per coordinate), each two bytes represent a signed 16 bit value. You need to divide those four values by 2^14. Checksum (1 byte) of previous 11 bytes: CRC8 . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: ...
Page 29
Linear acceleration (2 bytes per axis), each two bytes represent a signed 16 bit value. Those value are expressed in mg. Checksum (1 byte) of previous 17 bytes: CRC8 . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: support@teraranger.com ...
Page 30
2^14. Linear acceleration. Those value are expressed in mg. Carriage return character: \r ( 13 decimal / 0x0D hex) New line character: \n (10 decimal / 0x0A hex) . Terabee Website: www.teraranger.com 90 Rue Henri Fabre Technical support: ...
Need help?
Do you have a question about the TeraRanger Hub Evo and is the answer not in the manual?
Questions and answers