Example of using Xbus library to communicate with an MTi-1 series device using a full-duplex UART connection.
Dependencies: mbed-rtos mbed Xbus
Fork of MTi-1_example by
Important Information
This example is deprecated and no longer maintained. There are new embedded examples available in the MT SDK folder of the MT Software Suite. For more information please visit: https://xsenstechnologies.force.com/knowledgebase/s/article/Introduction-to-the-MT-SDK-programming-examples-for-MTi-devices
Overview
The example program demonstrates connecting to an MTi-1 series device, restoring communications settings to default if necessary, and configuring the MTi to send data. For an MTi-1 the device is configured to send inertial sensor data, while MTi-2 and MTi-3 devices are configured to output orientation data using the onboard XKF3i filter.
Communication with the MTi-1 series device is implemented using a either a full-duplex UART, I2C or SPI bus. A reset line is used to reset the MTi during initialization. Data is output to a host PC terminal using a second UART.
For more information on the MTi-1 series communication protocol please refer to the datasheet: https://www.xsens.com/download/pdf/documentation/mti-1/mti-1-series_datasheet.pdf
Supported Platforms
The program has been tested on the following mbed platforms:
Using the Example
- To use the example program connect one of the supported mbed boards to the host PC and download the application from the mbed online compiler to the target device.
- With the mbed board unpowered (USB disconnected) wire the mbed board to the MTi-1 development board. The following connections are required:
- In all cases:
- 5V (or 3V3) main supply to VDD (P300-1)
- MCU IO voltage (IORef) to VDDIO (P300-2)
- GND to GND (P300-3)
- MT_NRESET to nRST (P300-5)
- For I2C communication:
- MT_SCL to I2C_SCL (P300-9)
- MT_SDA to I2C_SDA (P300-11)
- MT_DRDY to DRDY (P300-15)
- MT_ADD0 to ADD0 (P300-17)
- MT_ADD1 to ADD1 (P300-19)
- MT_ADD2 to ADD2 (P300-21)
- For SPI communication:
- MT_DRDY to DRDY (P300-15)
- MT_SCLK to SPI_SCK (P300-17)
- MT_MISO to SPI_MISO (P300-19)
- MT_MOSI to SPI_MOSI (P300-21)
- MT_nCS to SPI_nCS (P300-23)
- For UART communication:
- MT_RX to UART_TX (P300-9)
- MT_TX to UART_RX (P300-11)
- In all cases:
For more information on the MTi-1 development board please refer to the MTi-1 series user manual: https://www.xsens.com/download/pdf/documentation/mti-1/mti-1-series_dk_user_manual.pdf
Information
Check the defines at the top of main.cpp to determine which IO pins are used for the MT_xxx connections on each mbed platform.
Information
The active peripheral (I2C, SPI or UART) is selected on the MTi-1 development board through the PSEL0 and PSEL1 switches. Look on the bottom of the development board for the correct settings.
- Connect to the target using a serial terminal. The application is configured for:
- Baudrate = 921600
- Stop bits = 1
- No parity bits
- No flow control
- Reset the mbed board.
- You should be presented with a simple user interface as shown below:
MTi-1 series embedded example firmware.
Device ready for operation.
Found device with ID: 03880011.
Device is an MTi-3: Attitude Heading Reference System.
Output configuration set to:
Packet counter: 65535 Hz
Sample time fine: 65535 Hz
Quaternion: 100 Hz
Status word: 65535 Hz
Press 'm' to start measuring and 'c' to return to config mode.
xbus/xbusparser.h@61:b9d3e7e5ba0c, 2015-06-12 (annotated)
- Committer:
- Alex Young
- Date:
- Fri Jun 12 13:23:26 2015 +0200
- Revision:
- 61:b9d3e7e5ba0c
- Parent:
- 51:cce9990f102a
Change to Apache license
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| Alex Young |
3:abc451d82b88 | 1 | /*! |
| Alex Young |
3:abc451d82b88 | 2 | * \file |
| Alex Young |
61:b9d3e7e5ba0c | 3 | * \copyright Copyright (C) Xsens Technologies B.V., 2015. |
| Alex Young |
61:b9d3e7e5ba0c | 4 | * |
| Alex Young |
61:b9d3e7e5ba0c | 5 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not |
| Alex Young |
61:b9d3e7e5ba0c | 6 | * use this file except in compliance with the License. You may obtain a copy |
| Alex Young |
61:b9d3e7e5ba0c | 7 | * of the License at |
| Alex Young |
3:abc451d82b88 | 8 | * |
| Alex Young |
61:b9d3e7e5ba0c | 9 | * http://www.apache.org/licenses/LICENSE-2.0 |
| Alex Young |
3:abc451d82b88 | 10 | * |
| Alex Young |
61:b9d3e7e5ba0c | 11 | * Unless required by applicable law or agreed to in writing, software |
| Alex Young |
61:b9d3e7e5ba0c | 12 | * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| Alex Young |
61:b9d3e7e5ba0c | 13 | * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| Alex Young |
61:b9d3e7e5ba0c | 14 | * License for the specific language governing permissions and limitations |
| Alex Young |
61:b9d3e7e5ba0c | 15 | * under the License. |
| Alex Young |
3:abc451d82b88 | 16 | */ |
| Alex Young |
3:abc451d82b88 | 17 | |
| Alex Young |
3:abc451d82b88 | 18 | #ifndef __XBUSPARSER_H |
| Alex Young |
3:abc451d82b88 | 19 | #define __XBUSPARSER_H |
| Alex Young |
3:abc451d82b88 | 20 | |
| Alex Young |
3:abc451d82b88 | 21 | #include <stddef.h> |
| Alex Young |
3:abc451d82b88 | 22 | #include <stdint.h> |
| Alex Young |
14:155f9a55ec51 | 23 | #include "xbusmessage.h" |
| Alex Young |
3:abc451d82b88 | 24 | |
| Alex Young |
3:abc451d82b88 | 25 | #ifdef __cplusplus |
| Alex Young |
3:abc451d82b88 | 26 | extern "C" { |
| Alex Young |
3:abc451d82b88 | 27 | #endif |
| Alex Young |
3:abc451d82b88 | 28 | |
| Alex Young |
3:abc451d82b88 | 29 | struct XbusParser; |
| Alex Young |
3:abc451d82b88 | 30 | |
| Alex Young |
46:f652d199d27e | 31 | /*! |
| Alex Young |
46:f652d199d27e | 32 | * \brief Callback function structure for use with the XbusParser. |
| Alex Young |
46:f652d199d27e | 33 | */ |
| Alex Young |
3:abc451d82b88 | 34 | struct XbusParserCallback |
| Alex Young |
3:abc451d82b88 | 35 | { |
| Alex Young |
3:abc451d82b88 | 36 | /*! |
| Alex Young |
3:abc451d82b88 | 37 | * \brief Allocate a buffer for message reception. |
| Alex Young |
3:abc451d82b88 | 38 | * \param bufSize The size of the buffer to allocate. |
| Alex Young |
3:abc451d82b88 | 39 | * \returns Pointer to buffer to use for message reception, or NULL if |
| Alex Young |
3:abc451d82b88 | 40 | * a buffer cannot be allocated. |
| Alex Young |
3:abc451d82b88 | 41 | * |
| Alex Young |
51:cce9990f102a | 42 | * \note It is the resposibility of the user to deallocate the message |
| Alex Young |
51:cce9990f102a | 43 | * data buffers pointed to by XbusMessage structures passed to the |
| Alex Young |
51:cce9990f102a | 44 | * handleMessage() callback function. |
| Alex Young |
3:abc451d82b88 | 45 | */ |
| Alex Young |
3:abc451d82b88 | 46 | void* (*allocateBuffer)(size_t bufSize); |
| Alex Young |
3:abc451d82b88 | 47 | |
| Alex Young |
3:abc451d82b88 | 48 | /*! |
| Alex Young |
25:01356fb59467 | 49 | * \brief Deallocate a buffer that was previously allocated by a call to |
| Alex Young |
25:01356fb59467 | 50 | * allocateBuffer. |
| Alex Young |
25:01356fb59467 | 51 | */ |
| Alex Young |
25:01356fb59467 | 52 | void (*deallocateBuffer)(void const* buffer); |
| Alex Young |
25:01356fb59467 | 53 | |
| Alex Young |
25:01356fb59467 | 54 | /*! |
| Alex Young |
3:abc451d82b88 | 55 | * \brief Handle a received message. |
| Alex Young |
51:cce9990f102a | 56 | * |
| Alex Young |
51:cce9990f102a | 57 | * \note If the passed XbusMessage structure has a non-null data pointer |
| Alex Young |
51:cce9990f102a | 58 | * then it is the responsibility of the user to free this once handling |
| Alex Young |
51:cce9990f102a | 59 | * of the message is complete. |
| Alex Young |
3:abc451d82b88 | 60 | */ |
| Alex Young |
14:155f9a55ec51 | 61 | void (*handleMessage)(struct XbusMessage const* message); |
| Alex Young |
3:abc451d82b88 | 62 | }; |
| Alex Young |
3:abc451d82b88 | 63 | |
| Alex Young |
3:abc451d82b88 | 64 | size_t XbusParser_mem(void); |
| Alex Young |
3:abc451d82b88 | 65 | struct XbusParser* XbusParser_create(struct XbusParserCallback const* callback); |
| Alex Young |
3:abc451d82b88 | 66 | void XbusParser_destroy(struct XbusParser* parser); |
| Alex Young |
3:abc451d82b88 | 67 | struct XbusParser* XbusParser_init(void* parserMem, struct XbusParserCallback const* callback); |
| Alex Young |
3:abc451d82b88 | 68 | |
| Alex Young |
3:abc451d82b88 | 69 | void XbusParser_parseByte(struct XbusParser* parser, uint8_t byte); |
| Alex Young |
3:abc451d82b88 | 70 | void XbusParser_parseBuffer(struct XbusParser* parser, uint8_t const* buf, size_t bufSize); |
| Alex Young |
3:abc451d82b88 | 71 | |
| Alex Young |
3:abc451d82b88 | 72 | #ifdef __cplusplus |
| Alex Young |
3:abc451d82b88 | 73 | } |
| Alex Young |
3:abc451d82b88 | 74 | #endif // extern "C" |
| Alex Young |
3:abc451d82b88 | 75 | |
| Alex Young |
3:abc451d82b88 | 76 | #endif // __XBUSPARSER_H |

Xsens MTi 1-series