Skip to content

README.md

Latest commit

 

History

History
128 lines (93 loc) · 6.3 KB

README.md

File metadata and controls

128 lines (93 loc) · 6.3 KB

Tria MaaXBoard OSM93 QuickStart

Purchase Tria MaaXBoard OSM93

  1. Introduction
  2. Requirements
  3. Hardware Setup
  4. Device Setup
  5. Onboard Device
  6. Using the Demo
  7. Resources

1. Introduction

This guide is designed to walk through the steps to connect the Tria MaaXBoard OSM93 to the Avnet /IOTCONNECT platform and demonstrate the standard IoT function of telemetry collection.

The MaaXBoard OSM93 features an energy-efficient, combination CPU/MPU/NPU, high-performance OSM compute system based on the NXP i.MX93 processor. The i.MX 93 device is architected with 3 separate processing domains: An application domain that includes two Arm® Cortex®-A55 (2.7 GHz) cores, a real time domain includes an Arm® Cortex®-M33 (250 MHz) core, and an on-board AI accelerator, Arm® Ethos-U65 MicroNPU for machine learning and computer vision applications.

2. Requirements

Hardware

  • Tria MaaXBoard OSM93 Purchase | User Manual | All Resources
  • USB Type-C Cable
  • USB to TTL Serial 3.3V Adapter Cable (must be purchased separately, click here to see the cable used by Avnet's engineer)

Note

The USB to TTL Serial 3.3V Adapter Cable may require you to install a specific driver onto your host machine. The example cable linked above requires a PL2303 driver.

  • Ethernet Cable (and a local router/switch with Internet connectivity)

Software

3. Hardware Setup

See the reference image below for cable connections.

Reference Image with Connections
  1. Connect an Ethernet cable from your LAN (router/switch) to the "ETH_A" port on the board.
  2. Connect a USB-C cable from a 5V power source (such as your host machine) to the "POWER/USB_A" port on your board.
  3. Connect your USB to TTL Serial 3.3V Adapter Cable to the appropriate pins on the A55 debug header.

Note

The A55 debug header is the lower row of 3 pins, the upper row should be left open.

Important

When connecting the wires of your USB to TTL Serial 3.3V Adapter Cable, the "TXD" pin of the board should connect to the "RXD" wire of your cable. Similarly, the "RXD" pin of the board should connect to the "TXD" wire of your cable. " GND" connects to "GND".

4. Device Setup

  1. With the board powered on and connected to your host machine, open your Device Manager list and note the COM port being utilized by your adapter cable.

Tip

If you do not see your cable in the COM port list, check for it in the "Other devices" section. You may need to install/select the driver for the cable to get it to be recognized as a COM port connection.

  1. Open a terminal emulator program such as TeraTerm or PuTTY on your host machine.
  2. Ensure that your serial settings in your terminal emulator are set to:
  • Baud Rate: 115200
  • Data Bits: 8
  • Stop Bits: 1
  • Parity: None
  1. Use that COM port from sub-step 1 to connect to your board via the terminal emulator.

Note

A successful connection may result in just a blank terminal box. If you see a blank terminal box, press the ENTER key to get a login prompt. An unsuccessful connection attempt will usually result in an error window popping up.

  1. When prompted for a login, type root followed by the ENTER key.
  2. Run these commands to begin to configure your board for /IOTCONNECT:
sudo apt-get update && python3 -m pip install iotconnect-sdk-lite requests && mkdir -p /opt/demo && cd /opt/demo

Tip

To gain access to "copy" and "paste" functions inside of a PuTTY terminal window, you can CTRL+RIGHTCLICK within the window to utilize a dropdown menu with these commands. This is very helpful for copying/pasting between your browser and the terminal.

5. Onboard Device

The next step is to onboard your device into /IOTCONNECT. This will be done via the online /IOTCONNECT user interface.

Follow this guide to walk you through the process.

Tip

If you have obtained a solution key for your /IOTCONNECT account from Softweb Solutions, you can utilize the /IOTCONNECT REST API to automate the device onboarding process via shell scripts. Check out this guide for more info on that.

6. Using the Demo

Run the basic demo with this command:

python3 app.py

Note

Always make sure you are in the /opt/demo directory before running the demo. You can move to this directory with the command: cd /opt/demo

View the random-integer telemetry data under the "Live Data" tab for your device on /IOTCONNECT.

7. Resources