Table of Contents

BSP Overview


Product URL list

TQ product page TQMa7x

Board Support Packages

Third-Party Add-Ons

Starterkit

Hardware

Onboard I2C devices

TQMa7x / MBa7x REV.02xx

I2C bus TQMa7x
I2C1 0x08
PMIC 		0x1e
SE97BTP (tempsensor) 		0x50
EEPROM 		0x68
RTC 		0x56
SE97BTP (eeprom) 		0x36
SE97BTP
I2C bus MBa7x
I2C1 0x49
LM75A
I2C2 0x18
Audiocodec 		0x2D
HSIC HUB 		0x20
I2C GPIO expander 		0x6A Clock generator

TQMa7x / MBa7x REV.01xx

I2C bus TQMa7x
I2C1 0x08
PMIC 		0x48
LM75A 		0x50
EEPROM 		0x68
RTC 		0x49
LM75A
I2C bus MBa7x
I2C1 0x49
LM75A
I2C2 0x18
Audiocodec 		0x2D
HSIC HUB 		0x20
I2C GPIO expander 		0x6A Clock generator

Hardware Issues

Linux BSP

U-Boot

U-Boot

Supported feature
Feature BSP Revision Remarks
TQ Product Chip Interface Function 0101 0105 0108
TQMa7x i.MX7 Ethernet 2x RGMII (10/100/1000 Mbit/s) • • •
TQMa7x i.MX7 Fuses • • •
TQMa7x i.MX7 GPIO • • • custom config on request
TQMa7x i.MX7 I²C EEPROM, Temperature Sensors, RTC • • •
TQMa7x i.MX7 QSPI QSPI SPI NOR Flash • • •
TQMa7x i.MX7 UART6 RS232 • • • default console
TQMa7x i.MX7 USB USB Storage Device • •
TQMa7x i.MX7 uSDHC eMMC / SD-Card • • • SD card / eMMC

Supported boot devices

Supported boot devices

Boot device BSP Revision Remarks
0101 0105 0108
eMMC • • •
SD • • •
QSPI NOR-Flash • •

Kernel

Operating System

Operating System

Supported Features
Feature BSP Revision Remarks
TQ Product Chip Interface Function Pre-Release 0101
only tested with MBa7x REV.0200 		0105
only tested with MBa7x REV.0200 		0108
TQMa7x i.MX7 ADC1 Touch Interface not tested
i.MX7 ADC2 • • • tested with IIO device
i.MX7 CSI Parallel CSI on request
i.MX7 eCSPI1 • • • exported as spidev
i.MX7 eCSPI2 • • • exported as spidev
i.MX7 EIM Bus access no device on MBa7x
on request
i.MX7 ENET1 RGMII
(10/100/1000 Mbit/s) 		• • • • incompatible with MBa7x Rev.010x
i.MX7 ENET2 RGMII
(10/100/1000 Mbit/s) 		• • • • incompatible with MBa7x Rev.010x
i.MX7 EPDC conflicts with QSPI NOR
no device on MBa7x
i.MX7 FLEXCAN1 CAN 2.0B • • • •
i.MX7 FLEXCAN2 CAN 2.0B • • • •
i.MX7 FLEXTIMER not tested
i.MX7 GPMI no device on TQMa7x / MBa7x
check pin multiplexing if needed on custom baseboard
i.MX7 I2C1 I2C devices • • • • see supported onboard I2C devices
i.MX7 I2C2 I2C devices • • • • see supported onboard I2C devices
i.MX7 JTAG not tested
i.MX7 KPP not tested
i.MX7 LCD1 Parallel LCD • • • • LVDS and LCD1 are mutually exclusive
special devicetree needed
i.MX7 MIPI CSI no device on MBa7x
i.MX7 MIPI DSI no device on MBa7x
i.MX7 MQS no device on MBa7X
i.MX7 PCIe Host controller • • • Tested with Realtek NIC
only available on i.MX7 Dual only NXP kernel supported
i.MX7 PWM1 PWM controller • • • • special devicetree needed for backlight
i.MX7 QSPI Bus access
Memory access 		• • • •
i.MX7 SAI1 Audiocodec • • •
i.MX7 SIM Tested with NXP Test application
i.MX7 TAMPER not tested
i.MX7 TEMPMON • • • • Temperature read
i.MX7 UART3 TTL • • available on X25
i.MX7 UART4 TTL • • available on X24
i.MX7 UART5 TTL • • available on X25
i.MX7 UART6 RS232 • • • • Default Console
i.MX7 UART7 RS485 • • • •
i.MX7 USB_Host USB4604 • • • requires BSP REV ≥ 0105 for TQMa7S
i.MX7 USB_OTG1 Host • • • • requires BSP REV ≥ 0105 for TQMa7S
i.MX7 USB_OTG1 OTG • • • Tested with serial downloader mode
requires BSP REV ≥ 0105 for TQMa7S
i.MX7 USB_OTG2 Host • • • only available on i.MX7 Dual
i.MX7 USB_OTG2 OTG • • only available on i.MX7 Dual
i.MX7 uSDHC uSDHC1 SD Card
uSDHC3 eMMC 		• • • • HS200 / HS400 Mode for uSDHC3

HS MODE for SD Card on uSDHC1 needs switchable supply voltage, not available on MBA7x
i.MX7 WDOG1 • • • • Necessary changes for MBa7x Rev.0100
MBa7x PCA9555 I2C port expander • • • •
PCA9555 I2C Port Expander Buzzer • • • •
PCA9555 I2C Port Expander 4x GPIO • • • •
PCA9555 I2C Port Expander 3x GPIO Key • • • • not usable as wakeup source
PCA9555 I2C Port Expander 2x LED • • • •
Smart Card SIM • • • Tested with NXP test application
SNVS Reset Reset, PMIC-
Reset, Power-
down, Wake-Up 		• • •
SN75LVDS83B LVDS • • • • LVDS and LCD1 are mutually exclusive
special devicetree needed
TLV320AIC3204 Headphone Out/
Line Out 		• • • selectable by using solder straps on MBa7x
Line In • • noisy audio record with default settings
Microphone In TBD
USB4604 USB1 Host • • • requires BSP REV ≥ 0105 for TQMa7S
USB4604 USB2 Host • • • requires BSP REV ≥ 0105 for TQMa7S
USB4604 USB3 Host • • • requires BSP REV ≥ 0105 for TQMa7S
USB4604 USB4 Host • • • requires BSP REV ≥ 0105 for TQMa7S


FAQ

PTXdist

Version Matrix

BSP revision 0101 0105 0108
PTXdist 2016.04 2016.04 2019.01
OSELAS Toolchain 2014.12.2 2014.12.2 2018.12.0
Platform MBa7x MBa7x MBa7x
U-Boot 2016.03 (NXP imx-rel_imx_4.1.15_2.0.0_ga) 2016.03 (NXP imx-rel_imx_4.1.15_2.0.0_ga) 2016.03 (NXP imx-rel_imx_4.1.15_2.0.0_ga)
Linux Kernel 4.1.5 (NXP imx-rel_imx_4.1.15_2.0.0_ga) 4.1.5 (NXP imx-rel_imx_4.1.15_2.0.0_ga) linux 4.14.78
linux 4.14.78-rt47
4.14.78 rel_imx_4.14.78_1.0.0_ga
Qt Version 5.6.1 5.6.2 5.6.3


Changelog PTXdist

DevHost

Build BSP

Compilation

Select one of the supported hardware platforms, select a software configuration and start building the image.

The available hardware platforms for TQMa7x are:

  • configs/platform-tq-mba7x-fsl/mba7x/platformconfig (TQMa7x on MBa7x)

Currently the following software configurations are available:

  • configs/platform-mba7x-fsl/ptxconfig.fsl (rootfs with Systemd init and Qt )
  • configs/platform-mba7x-fsl/ptxconfig.tiny (rootfs with busybox init without Qt)

BSP Rev.0101 (and later)

$ tools/config-mba7x-fsl

this will effectivly:

  • check for configured ptxdist version
  • create symlink to configured ptxdist version (./p → /usr/local/bin/ptxdist-<version>)
  • call ./p platform configs/platform-tq-tqma7x/mba7x/platformconfig
  • call ./p select configs/platform-tq-tqma7x/ptxconfig.fsl

Finally you can build the BSP by executing 

$ ./p images --git

Adapt BSP

Partition scheme
SD / eMMC images

* sector size 512 Byte * unpartitioned area: 4MiB (0x2000 sectors)

Sector numbers are in hexadecimal (as expected by U-Boot's mmc command), size is given in hex (=number of sectors) and dezimal (= size in byte).

Sector first Sector last Size Usage
0x000000 0x000000 0x0001 sector / 512 Byte MBR / Partition Table
0x000001 0x000001 0x0001 sector / 512 Byte free
0x000002 0x0007FF 0x07FE sectors / 1023 KiB u-boot
0x000800 0x000FFF 0x0800 sectors / 1 MiB u-boot environment
0x001000 0x001FFF 0x1000 sectors / 2 MiB free
0x002000 0x00BFFF 0xA000 sectors / 20 MiB boot / firmware (Kernel, devicetrees)
0x00C000 0x08BFFF 0x80000 sectors / 256 MiB root
0x08C000 0x10BFFF 0x80000 sectors / 256 MiB spare, unformatted

Deployment

PTXdist images

Complete system image:

  • u-boot-tqma7-hd.img: bootable image for TQMa7x on MBa7x (usage on SD Card and eMMC)

The complete system image is intended for:

  • development system initialisation
  • deployment

Bootloader image:
Not to be confused with the u-boot*.bin images, these are just intermediate images and will not be booted by the i.MX7.

  • u-boot-fsl-mba7-mmc.imx: u-boot bootloader for TQMa7x on MBa7x (usage on SD Card and eMMC)

Linux images:

  • linuximage: Kernel (zImage)
  • imx7d-mba7.dtb: device tree blob for TQMa7x on MBa7x
  • imx7d-mba7-pd.dtb: device tree blob for TQMa7x on MBa7x
    parallel display interface activated with display timing for GLYN display
  • imx7d-mba7-pd-dmb.dtb: device tree blob for TQMa7x on MBa7x
    parallel display interface activated with display timing for DMB display
  • imx7d-mba7-lvds.dtb: device tree blob for TQMa7x on MBa7x
    LVDS interface activated
  • imx7d-mba7-otg.dtb: device tree blob for TQMa7x on MBa7x
    USB OTG activated

Rootfs images:

  • root.tgz: Root file system archive (for NFS etc.)
  • root.ext2: Root file system partition image (for system update)
device assignment
MMC device assignment
mmcdev 0 = eMMC
mmcdev 1 = SD Card
update commands uboot
  • U-Boot update: ⇒ run update_uboot
  • Device Tree update: ⇒ run update_fdt
  • Kernel update: ⇒ run update_kernel
serial downloader
Usage of serial downloader tool

Downloads

TQ Board Support Packages

Build System / Toolchains

Documentation

TQ Board Support Packages

The Board Support Packages (BSPs) usually provide source code as well as precompiled images for one or more platforms.
Please see the version matrix for details on each revision of the BSP.

TQMa7x BSP Rev.0105☚ current revision
MD5SUM: 6DC026845B1EB9327A2D3D12697FEACA

TQMa7x BSP Rev.0101
MD5SUM: F13ABC313B828F75412EE9011FCA44BB

Build System / Toolchains

PTXdist version XXXX.YY.0 is required to compile an OSELAS Toolchain XXXX.YY.Z.
The version of PTXdist and toolchain required to build a given BSP revision is shown in the version matrix.

Build System PTXdist 2016.04

OSELAS Toolchain 2014.12.2

PTXdist projects for compiling OSELAS toolchains

Documentation

PTXdist manual "How to become a PTXdist Guru" ☚ worthwhile reading

Application Note: Building OSELAS.Toolchains()

Known Issues PTXdist

Linux BSP Rev.0101

U-Boot and Linux

'USB does not work with TQMa7S with MBa7x
Affects USB highspeed Host
Issue USB highspeed Host does not work with TQMa7S
Effect USB highspeed Host does not work with TQMa7S
Solution / Workaround Will be fixed in the next BSP revision

Audio

Record / Play

Record Audio: 

  $ arecord –f cd  <OUTPUT_FILE>

Play Audio File: 

  $ aplay <FILE>

Configure Line-Out

R2005 / R2007 must be placed on the MBa7x 

$ amixer sset 'LOL Output Mixer L_DAC' on
$ amixer sset 'LOR Output Mixer R_DAC' on
$ amixer sset 'LO DAC' on

Configure Line-In

$ amixer sset 'ADCFGA Left Mute' off
$ amixer sset 'ADCFGA Right Mute' off

Configure Headphones-Out

R2008 / R2009 must be placed on the MBa7x 

$ amixer sset 'HP DAC' on
$ amixer sset 'HPL Output Mixer L_DAC' on
$ amixer sset 'HPR Output Mixer R_DAC' on

Microphone

Not supported on BSP <= Rev.108

MBa7x

RS485

RS485 bus block in half-duplex mode
Affects RS485 via UARTx
Issue During i.MX7 reset the UARTx.CTS# pin is low by default (CPU internal pull down)
Effect Using the MBa7x RS485 circuitry in a half-duplex slave device or half-duplex multi-master environment may block the RS485 bus during i.MX7 reset.
The bus is released as soon as the UARTx.CTS# pin is properly configured by software (e.g. U-Boot, Linux, etc.)
Solution / Workaround Add a 10k pull up to the UARTx.CTS# signal on carrier board

Yocto

DevHost

Build BSP

Adapt BSP

Deployment

Known Issues Yocto

(Deployment)

QNX BSP

U-Boot

Bootloader

Supported features

Feature QNX Revision Remarks
TQ Product Chip Interface Function 6.6.0
TQMa7x i.MX7 Ethernet 2x RGMII (10/100/1000 Mbit/s) •
TQMa7x i.MX7 Fuses •
TQMa7x i.MX7 GPIO • custom config on request
TQMa7x i.MX7 I²C EEPROM, Temperature Sensors, RTC •
TQMa7x i.MX7 qSPI QSPI SPI NOR Flash •
TQMa7x i.MX7 UART6 RS232 • default console
TQMa7x i.MX7 USB USB Storage Device •
TQMa7x i.MX7 uSDHC eMMC / SD-Card • SD card / eMMC


Supported boot devices

Boot device supported
eMMC •
SD Card •
QSPI NOR

Operating System

Supported features

Feature QNX Version Remarks
TQ Product Chip Interface Function 6.6.0
TQMa7x i.MX7 eCSPI1 •
i.MX7 eCSPI2 •
i.MX7 ENET1 RGMII
(10/100/1000 Mbit/s) 		• incompatible with MBa7x Rev.010x
i.MX7 FLEXCAN1 CAN 2.0B •
i.MX7 FLEXCAN2 CAN 2.0B •
i.MX7 I2C1 I2C devices • see supported onboard I2C devices
i.MX7 I2C2 I2C devices • see supported onboard I2C devices
i.MX7 LCD1 Parallel LCD LVDS and LCD1 are mutually exclusive, special devicetree needed
comming soon with QNX7
i.MX7 PCIe Device Discoery on request
i.MX7 QSPI Bus access
Memory access 		on request
i.MX7 UART3 TTL • not available on MBa7x
i.MX7 UART4 TTL • not available on MBa7x
i.MX7 UART5 TTL • not available on MBa7x
i.MX7 UART6 RS232 • Default Console
i.MX7 USB_Host USB4604 •
i.MX7 USB_OTG1 Host •
i.MX7 USB_OTG1 OTG •
i.MX7 uSDHC uSDHC1 SD Card
uSDHC3 eMMC 		• HS200 / HS300 Mode for uSDHC3
HS MODE for SD Card on uSDHC1 needs switchable supply voltage, not available on MBA7x
MBa7x USB4604 USB1 Host •
USB4604 USB2 Host •



Onboard I2C devices

TQMa7 REV.0100
I2C bus TQMa7x MBa7x
I2C1 0x08
PMIC 		0x48
LM75A 		0x50
EEPROM 		0x68
RTC 		0x49
LM75A
I2C2 0x18
Audiocodec 		0x2D
HSIC HUB 		0x20
I2C GPIO expander 		0x6A Clock generator


TQMa7 REV.0200
I2C bus TQMa7x MBa7x
I2C1 0x08
PMIC 		0x1e
SE97BTP (tempsensor) 		0x50
EEPROM 		0x68
RTC 		0x56
SE97BTP (eeprom) 		0x36
SE97BTP 		0x49
LM75A
I2C2 0x18
Audiocodec 		0x2D
HSIC HUB 		0x20
I2C GPIO expander 		0x6A Clock generator
I2C bus TQMa7x
I2C1 0x08
PMIC 		0x48
LM75A 		0x50
EEPROM 		0x68
RTC 		0x49
LM75A 		0x57
EEPROM 		0x68
RTC (optional DS1339)


I2C bus MBa7x
I2C2 0x18
Audiocodec 		0x2D
HSIC HUB 0x19
Tempsensor 		0x20
PCA9554 		0x6A
Clock Generator

Kernel

FAQ

Deployment

VxWorks BSP

U-Boot

Kernel

FAQ

Deployment