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 Alex Young

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

  1. 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.
  2. 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)

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.

  1. Connect to the target using a serial terminal. The application is configured for:
    • Baudrate = 921600
    • Stop bits = 1
    • No parity bits
    • No flow control
  2. Reset the mbed board.
  3. 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.
Committer:
Alex Young
Date:
Thu May 21 16:30:21 2015 +0200
Revision:
46:f652d199d27e
Parent:
25:01356fb59467
Child:
51:cce9990f102a
Add documentation for xbusparser

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Alex Young 3:abc451d82b88 1 /*!
Alex Young 3:abc451d82b88 2 * \file
Alex Young 3:abc451d82b88 3 * \copyright
Alex Young 3:abc451d82b88 4 * Copyright (C) Xsens Technologies B.V., 2015. All rights reserved.
Alex Young 3:abc451d82b88 5 *
Alex Young 3:abc451d82b88 6 * This source code is intended for use only by Xsens Technologies BV and
Alex Young 3:abc451d82b88 7 * those that have explicit written permission to use it from
Alex Young 3:abc451d82b88 8 * Xsens Technologies BV.
Alex Young 3:abc451d82b88 9 *
Alex Young 3:abc451d82b88 10 * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
Alex Young 3:abc451d82b88 11 * KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
Alex Young 3:abc451d82b88 12 * IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
Alex Young 3:abc451d82b88 13 * PARTICULAR PURPOSE.
Alex Young 3:abc451d82b88 14 */
Alex Young 3:abc451d82b88 15
Alex Young 3:abc451d82b88 16 #ifndef __XBUSPARSER_H
Alex Young 3:abc451d82b88 17 #define __XBUSPARSER_H
Alex Young 3:abc451d82b88 18
Alex Young 3:abc451d82b88 19 #include <stddef.h>
Alex Young 3:abc451d82b88 20 #include <stdint.h>
Alex Young 14:155f9a55ec51 21 #include "xbusmessage.h"
Alex Young 3:abc451d82b88 22
Alex Young 3:abc451d82b88 23 #ifdef __cplusplus
Alex Young 3:abc451d82b88 24 extern "C" {
Alex Young 3:abc451d82b88 25 #endif
Alex Young 3:abc451d82b88 26
Alex Young 3:abc451d82b88 27 struct XbusParser;
Alex Young 3:abc451d82b88 28
Alex Young 46:f652d199d27e 29 /*!
Alex Young 46:f652d199d27e 30 * \brief Callback function structure for use with the XbusParser.
Alex Young 46:f652d199d27e 31 */
Alex Young 3:abc451d82b88 32 struct XbusParserCallback
Alex Young 3:abc451d82b88 33 {
Alex Young 3:abc451d82b88 34 /*!
Alex Young 3:abc451d82b88 35 * \brief Allocate a buffer for message reception.
Alex Young 3:abc451d82b88 36 * \param bufSize The size of the buffer to allocate.
Alex Young 3:abc451d82b88 37 * \returns Pointer to buffer to use for message reception, or NULL if
Alex Young 3:abc451d82b88 38 * a buffer cannot be allocated.
Alex Young 3:abc451d82b88 39 *
Alex Young 3:abc451d82b88 40 * \note It is the resposibility of the callback to deallocate the buffer
Alex Young 3:abc451d82b88 41 * once it is done with processing the message.
Alex Young 3:abc451d82b88 42 */
Alex Young 3:abc451d82b88 43 void* (*allocateBuffer)(size_t bufSize);
Alex Young 3:abc451d82b88 44
Alex Young 3:abc451d82b88 45 /*!
Alex Young 25:01356fb59467 46 * \brief Deallocate a buffer that was previously allocated by a call to
Alex Young 25:01356fb59467 47 * allocateBuffer.
Alex Young 25:01356fb59467 48 */
Alex Young 25:01356fb59467 49 void (*deallocateBuffer)(void const* buffer);
Alex Young 25:01356fb59467 50
Alex Young 25:01356fb59467 51 /*!
Alex Young 3:abc451d82b88 52 * \brief Handle a received message.
Alex Young 3:abc451d82b88 53 */
Alex Young 14:155f9a55ec51 54 void (*handleMessage)(struct XbusMessage const* message);
Alex Young 3:abc451d82b88 55 };
Alex Young 3:abc451d82b88 56
Alex Young 3:abc451d82b88 57 size_t XbusParser_mem(void);
Alex Young 3:abc451d82b88 58 struct XbusParser* XbusParser_create(struct XbusParserCallback const* callback);
Alex Young 3:abc451d82b88 59 void XbusParser_destroy(struct XbusParser* parser);
Alex Young 3:abc451d82b88 60 struct XbusParser* XbusParser_init(void* parserMem, struct XbusParserCallback const* callback);
Alex Young 3:abc451d82b88 61
Alex Young 3:abc451d82b88 62 void XbusParser_parseByte(struct XbusParser* parser, uint8_t byte);
Alex Young 3:abc451d82b88 63 void XbusParser_parseBuffer(struct XbusParser* parser, uint8_t const* buf, size_t bufSize);
Alex Young 3:abc451d82b88 64
Alex Young 3:abc451d82b88 65 #ifdef __cplusplus
Alex Young 3:abc451d82b88 66 }
Alex Young 3:abc451d82b88 67 #endif // extern "C"
Alex Young 3:abc451d82b88 68
Alex Young 3:abc451d82b88 69 #endif // __XBUSPARSER_H