Starterkit Quicksteps
The Starterkit STKa8MxML consisting of the TQMa8MxML module and MBa8Mx mainboard is intended as evaluation platform for the TQMa8MxML. To bring up the board a comprehensive set of accessories is supplied with the kit. The STKa8MxML is delivered preconfigured to boot the latest released Linux BSP revision at the time of delivery, so only the Host Computer has to be set up properly to bring the STKa8MxML up. This page guides through the first steps with the STKa8MxML Starterkit.
Setup Host Computer
Serial Driver
The TQMa8MxML debug UART is connected via a Silicon Labs USB-to-Serial converter to X16 (micro-USB) on the MBa8Mx. A micro-USB/USB-A cable is part of the STKa8MxML accessory set. Depending on the host operating system, driver may need to be installed.
Linux
The driver is maintained in the Linux Mainline Kernel, please check that the following options are activated in the Linux Kernel configuration.
- CONFIG_USB_SERIAL
- CONFIG_USB_SERIAL_CP210X
Windows
The driver can be downloaded from the Vendor website:
https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers
Terminal Emulator
Linux
Minicom
Minicom is a command line based serial terminal for serial communication with hardware like our starterkits.
Install Minicom using APT(Debian/Ubuntu)
$ sudo apt install minicom
In order for the terminal to work properly with full rights you need to add your user to the dialout group:
$ sudo usermod -a -G dialout $USER
Connect Starterkit to Host
To determine the serial device name under linux you can use dmesg. Just run the command below and then plug in the starter kit to see the new detected interface names:
$ dmesg -w
once the interface name is clear you can abort dmesg with ctrl + c.
Now you can start minicom via the command line interface:
$ minicom -D /dev/ttySx
Configure minicom
The serial configuration should be correct by default. However, hardware flow control must be disabled for some starter kits, otherwise the communication works only in one direction.
- Press CTRL + A, then press O to open the configuration menu
- Go to Serial port setup
- Press F to change Hardware Flow Control to No
- Hit Return key
- Select Save setup as dfl to save this configuration as default
- Press ESC to exit the menu
Windows
TeraTerm
TeraTerm is an open source terminal emulator for windows. it can be downloaded here.
Configure TeraTerm
- Download and install TeraTerm
- Start TeraTerm and open the Serial Port Settings
- select your serial port and configure it with the values defined in the chapter Serial Configuration
- after passing the values click on the button new Setting
Host PC Serial Port Configuration
The serial port which connects the STKa8MxML to the Host PC must be configured as follows:
Bautrate: | 115200 |
---|---|
Data bits: | 8 |
Parity: | none |
Stop bits: | 1 |
Handshake : | XON/XOFF |
Connecting the Starterkit to the Development Host
Please follow the quick start guide delivered with the kit, or open it from the following link: Quick start guide
Linux
BSP Login Credentials
As soon as logging in on the Linux shell for the first time, the question about the login credential comes up.
By default the user root is used to log into the Linux shell, no password is set for user root.
tqmaxx-mbaxx login: root
Testing Interfaces on STKa8MxML
To get familiar with the interfaces of the STKa8MxML we recommend to work through the interface tutorials first.
Building the BSP
The Board Support Packages provided by TQ may not contain all software packages to evaluate the STKa8MxML, therefore TQ provides some guides how to build the BSP and customize it for your needs,
In addition to the BSP documentation, the Yocto SDK build and Eclipse IDE setup for the STKa8MxML is also documented.
Setup Starterkit for different boot sources
The STKa8MxML can be setup to boot from different sources please see the DIP switch settings below to change the boot source.
MBa8Mx DIP switch settings
Boot Modes
The following boot modes of the i.MX8M can be selected by the DIP switches S5, S6, S7, S8, S9 and S10 on the MBa8Mx.
MBa8Mx Rev.030x/Rev.020x
TQMa8Mx
S7
S8
S9
S10
DIP switch S5 and S6 are used to select the boot medium for internal boot:
SD-Card boot
S5
S6
eMMC boot
S5
S6
S7
S8
S9
S10
DIP switch S5 and S6 are used to select the boot medium for internal boot:
SD-Card boot
S5
S6
eMMC boot
S5
S6
TQMa8MxML
S7
S8
S9
S10
DIP switch S5 and S6 are used to select the boot medium for internal boot:
SD-Card boot
S5
S6
eMMC boot
S5
S6
Flex SPI Boot
S5
S6
S7
S8
S9
S10
DIP switch S5 and S6 are used to select the boot medium for internal boot:
SD-Card boot
S5
S6
eMMC boot
S5
S6
Flex SPI Boot
S5
S6
TQMa8MxNL
S7
S8
S10
The switches BOOT MODE 2 (BM2) and BOOT MODE 3 (BM3) are located on the module adapter!
DIP switch S9, BOOT MODE 2 and BOOT MODE 3 are used to select the boot medium:
SD-Card boot
S9
BM 2
BM 3
eMMC boot
S9
BM 2
BM 3
FlexSPI / 3B Read
S9
BM 2
BM 3
S7
S8
S10
The switches BOOT MODE 2 (BM2) and BOOT MODE 3 (BM3) are located on the module adapter!
DIP switch S9, BOOT MODE 2 and BOOT MODE 3 are used to select the boot medium:
SD-Card boot
S9
BM 2
BM 3
eMMC boot
S9
BM 2
BM 3
Module Rev100: eMMC Boot currently not supported!
Detailed DIP Switch Settings
S5
# | Feature | ON | OFF |
---|---|---|---|
1 | BOOT_CFG0 | 0 | 1 |
2 | BOOT_CFG1 | 0 | 1 |
3 | BOOT_CFG2 | 0 | 1 |
4 | BOOT_CFG3 | 0 | 1 |
5 | BOOT_CFG4 | 0 | 1 |
6 | BOOT_CFG5 | 0 | 1 |
7 | BOOT_CFG6 | 0 | 1 |
8 | BOOT_CFG7 | 0 | 1 |
S6
# | Feature | ON | OFF |
---|---|---|---|
1 | BOOT_CFG8 | 0 | 1 |
2 | BOOT_CFG9 | 0 | 1 |
3 | BOOT_CFG10 | 0 | 1 |
4 | BOOT_CFG11 | 0 | 1 |
5 | BOOT_CFG12 | 0 | 1 |
6 | BOOT_CFG13 | 0 | 1 |
7 | BOOT_CFG14 | 0 | 1 |
8 | BOOT_CFG15 | 0 | 1 |
S7
# | Feature | ON | OFF |
---|---|---|---|
1 | unused | unused | unused |
2 | unused | unused | unused |
3 | UART 2 | USB Debug Output | Pin Header (X17) |
4 | UART 1 | USB Debug Output | Pin Header (X17) |
S8
# | Feature | ON | OFF |
---|---|---|---|
1 | TQMa8M_ONOFF | ||
2 | TQMa8M_SYS_RST# | ||
3 | I2C module select | TQMa8Mx | TQMa8MxNL / TQMa8MxML |
4 | SPI_MUX_CTRL | Pin Header X34 | MicroBUS |
S9
# | Feature | ON | OFF |
---|---|---|---|
1 | EN_VCC_FAN | On | off |
2 | BOOT_MODE0 | 0 | 1 |
3 | BOOT_MODE1 | 0 | 1 |
4 | DSI_MUX_CTRL | eDP | LVDS |
S10
TQMa8Mx | TQMa8MxML | TQMa8MxNL | |
---|---|---|---|
1 | OFF | ON | ON |
2 | OFF | ON | ON |
3 | OFF | OFF | ON |
4 | OFF | OFF | ON |