Release Notes

Operating SystemLinux
BSP Release Status

RELEASED

Release Date

 

RepositoryPHYTEC Public Repos
BinariesBSP-Yocto-FSL-iMX7-PD19.1.0

Introduction


This BSP provides a basis for development, deployment and execution of Linux based applications on the iMX7 System on Module (SOM).

Versioning


Software

Linux Kernel4.14.78 (Based on NXP Release L4.14.78_1.0.0_ga)PHYTEC Source Repo
U-Boot2018.03 (Based on NXP Release L4.14.78_1.0.0_ga )PHYTEC Source Repo
Yocto2.5 Sumo (Based on NXP Release L4.14.78_1.0.0_ga )PHYTEC Source Repo
QtNot Supported (Click here for more info)
Host OSTested on 64-bit Ubuntu 16.04 LTSUbuntu 16.04 Release


Yocto Machine Configuration Table

This BSP release supports various configurations of the phyBOARD-Zeta i.MX7. You will need to know which Yocto machine configuration corresponds to your kit in order to build the appropriate BSP. By default, only the standard kit configurations are shown in the table. If you have a different kit, use the filters below to search by Kit Part Number or SOM. The U-Boot defconfig and kernel device tree file names are important when creating custom U-Boot and kernel images outside of Yocto development.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Yocto Machine ConfigKit Part Number

SOM Part Number

(Click here for description)

ModulesU-Boot defconfigKernel Device Tree FileSupported Yocto Project Image
imx7d-phyboard-zeta-004

KPB-01910-004

(i.MX7Dual Kit)

PCM-061-2110111C

PEB-D-RPI

PEB-AV-02

mx7d_pcm061_21x_configimx7d-phyboard-zeta-004.dtbfsl-image-validation-imx
imx7s-pcm-061-0502100eNon-Standard KitPCM-061-0502100EPEB-D-RPImx7s_pcm061_05x_configimx7s-pcm-061-0502100e.dtb

fsl-image-validation-imx

(core-image-minimal for NAND boot)

imx7d-pcm-061-2111101eNon-Standard Kit

PCM-061-2111101E

PEB-D-RPI

PEB-AV-02

mx7d_pcm061_21x_configimx7d-pcm-061-2111101e.dtbfsl-image-validation-imx
imx7d-pcm-061-2111111eNon-Standard Kit

PCM-061-2111111E

PEB-D-RPI

PEB-AV-02

mx7d_pcm061_21x_config

imx7d-pcm-061-2111111e.dtb

fsl-image-validation-imx
imx7d-pcm-061-2211101eNon-Standard Kit

PCM-061-2211101E

PEB-D-RPI

PEB-AV-02

mx7d_pcm061_22x_configimx7d-pcm-061-2211101e.dtbfsl-image-validation-imx
imx7d-pcm-061-2211111eNon-Standard Kit

PCM-061-2211111E

PEB-D-RPI

PEB-AV-02

mx7d_pcm061_22x_configimx7d-pcm-061-2211111e.dtbfsl-image-validation-imx

Linux Device Tree Summary

The following is an example describing the structure of the device tree for the standard phyBOARD-Zeta Kit (machine configuration imx7d-phyboard-zeta-004).

Please look at the dts file corresponding to your machine configuration for the included dtsi files.

Hardware TargetDevice Tree File DescriptionsFilename
i.MX7D phyBOARD-Zeta (PB-01910-004)Default dts build targetimx7d-phyboard-zeta-004.dts

Processorimx7d.dtsi (includes imx7s.dtsi)
SOM (Superset) - enables all SOM features.

imx7-phycore-som.dtsi

SOM Variant- excludes features that are not supported by the BOM population options for PCM-061-2110111C. imx7d-pcm-061-2110111c.dtsi
Carrier Boardimx7d-pba-c-09.dtsi (includes imx7s-pba-c-09.dtsi)
LCD Display Adapterimx7-peb-av-02.dtsi
Expansion Boardimx7-peb-d-rpi.dtsi


Alternate dts files:

  • imx7d-phyboard-zeta-004-m4.dtb: configure u-boot to use this DTS if running Linux on the Cortex-A7 while running FreeRTOS on the Cortex-M4
  • imx7d-phyboard-zeta-004-mipi.dtb: configure u-boot to use this DTS if using the PEB-AV-06 MIPI module

Compatible Hardware


Supported Hardware Versions

Hardware DescriptionPart NumberPCB Version

Configuration Details

(i.MX7 / DDR3 / eMMC or NAND / Ethernet PHY populated)

phyCORE-i.MX7 SOM


PCM-061-2110111C.A21458.4

Dual / 1GB / 4GB eMMC / Yes


PCM-061-2110111C.A1

1458.2


PCM-061-2110111C.A0

PCM-061-0502100E.A01458.2 Solo / 256MB / 256MB NAND / No
PCM-061-2111101E.A11458.3
Dual / 1GB / 4GB eMMC / No
PCM-061-2111101E.A01458.2
PCM-061-2211101E.A01458.2Dual / 1GB / 8GB eMMC / No
PCM-061-2111111E.A11458.3Dual / 1GB / 4GB eMMC / Yes
PCM-061-2111111E.A01458.2
PCM-061-2211111E.A01458.4Dual / 1GB / 8GB eMMC / Yes
phyBOARD-Zeta Carrier BoardPBA-C-09-01.A01459.3

Device tree changes are required to support earlier SOM and Carrier Board revisions. Visit the PHYTEC Support Portal to open a support ticket for help on how to make the device tree changes.

Compatible Expansion Boards and Accessories

Module NamePart NumberPCB VersionDescription
PEB-D-RPI Expansion BoardPEB-D-RPI.A01503.0

Raspberry Pi HAT support plus:

  • UART1 (over USB)
  • JTAG
  • I2C EEPROM
  • Two user buttons and two user LEDs

Connects to expansion header

LCD Display Adapter with 7'' capacitive display

PEB-AV-02-070W.A0

(Includes AV module, display, and cable)

1415.3

ETM0700G0DH6 LCD Display/ Capacitive touch interface

Connects to Audio/Video header

MIPI Expansion Board

PEB-AV-06.A1

1487.1

DSI display and CSI camera adapter supporting:

  • Camera OmniVision LI-OV5640-MIPI-AF
  • Display NXP TFT3P5581-E

Connects to MIPI DSI connector on phyBOARD

Supported Raspberry Pi HATs (PEB-D-RPI Expansion Board)

PHYTEC supports a variety of Raspberry Pi HATs for use with the PEB-D-RPI Expansion Board. Other HATs may be hardware-compatible but have not yet been integrated and tested by PHYTEC. Demos and tests for supported HATs have been installed to the BSP file system, and are located in the /usr/share/phytec-rpihat-examples directory.

The following table lists supported Raspberry Pi HATs and the name of the subdirectory (relative to the phytec-rpihat-examples directory) that contains the demos for each HAT:

Raspberry Pi HATDemo Subdirectory
Raspberry Pi Sense HATsense-hat
Pimoroni Unicorn HD HATunicorn-hd-hat
Pimoroni Skywriter HATskywriter-hat
Anavi RabbitMax Flex HATflex-hat
Adafruit Capacitive Touch HATcapacitive-touch-hat
Adafruit DC & Stepper Motor HATmotor-hat
Adafruit 16-channel PWM/Servo HATservo-hat

BSP Download


Prebuilt images of BSP-Yocto-FSL-iMX7-PD19.1.0 can be downloaded and extracted from the link below:

BSP-Yocto-FSL-iMX7-PD19.1.0

Documentation



BSP Features


The following table lists the interfaces available from the phyCORE-iMX7 SOM. 

  • Implemented - driver support exists in the kernel. 
  • Tested  - the interface has been configured in the device tree and was tested by PHYTEC 
  • Status in Device Tree - the corresponding device tree nodes are enabled in the device tree. See Linux Device Tree Summary for more information.

    The "Status in Device Tree" column is specifically for the standard phyBOARD-Zeta kit (machine configuration imx7d-phyboard-zeta-004).

    Please look at the dts file corresponding to your machine configuration for differences.

InterfaceDetailImplementedTestedStatus in Device TreeNotes
UARTuart1YesYesOkay

Micro-USB B connector on PEB-D-RPI

Default serial console

uart2YesYesDisabled

Micro-USB B connector on PEB-D-RPI

Disabled for use as serial console on Cortex-M4 FreeRTOS

uart3YesNoDisabled 1 expansion header
uart4YesNoDisabled 1
uart5YesYesOkayRS232 serial console at Connector X2
uart6YesNo Disabled 1  expansion header
uart7YesYesOkayexpansion header
I2Ci2c1YesYesOkayexpansion header
i2c2YesYesOkayAV Connector X4
i2c3YesNo Disabled 1  
i2c4YesYesOkay

expansion header

Used for PEB-D-RPI expansion board HAT detection

EthernetRGMII1YesYesOkayKSZ9031RNX PHY on SOM, Connector X8
RGMII2YesYesOkayKSZ9031RNX PHY on CarrierBoard, Connector X7
SAIsai1YesNoDisabled 1 Audio/Video Connector X4
sai2YesNoDisabled 1 expansion header
sai3YesNo Disabled 1  
MMC/SDIOSD1YesYesYesmicroSD slot connector X11
SD2YesNoDisabled 1 expansion header
SD3YesYesOkaysignals routed to eMMC.
CommunicationMultiCore Communication with Cortex-M4 (RPMsg)YesYesOkaySee FreeRTOS release for more info.
USBusb1YesYesOkayUSB-A Host Connector X9
usb2YesYesOkayUSB-AB OTG Connector X10
usbh (HSIC)YesYesDisabledexpansion header
CANcan1YesYesOkayHeader X1
can2YesNoDisabled 1
SPIspi1YesNoDisabled 1 expansion header
spi2YesNoDisabled 1 expansion header
spi3YesNoDisabled 1 expansion header
spi4YesNoDisabled 1
ADCadc1YesYesOkayexpansion header
Parallel Display and TouchParallel LCD DisplayYesYesOkayvia expansion board PEB-AV-02
Analog LCD TouchYesYesOkay

Capacitive ETM-FT5x06

via expansion board PEB-AV-02

BacklightYesYesOkay

PWM via pwm3

via expansion board PEB-AV-02

MIPI DSI/CSI2-lane MIPI DSI DisplayYesYesDisabled

Display TFT3P5581-E

via expansion board PEB-AV-06

2-lane MIPI CSI CameraYesYesDisabled

LI-OV5640-MIPI-AF-16

via expansion board PEB-AV-06

GPIO

User Buttons and LEDs

YesYesOkay

User LED GPIO2_10 on CarrierBoard

Two user LEDs and two buttons on PEB-D-RPI

Memory

 
8/16-bit NAND Flash (GPMC)YesYesDisabledMT29F4G08 - not populated in default SOM configuration
SPI NOR FlashYesYesOkayN25Q128A on QSPI_A
EEPROM on SOMYesYesOkayM24C32 on i2c1
EEPROM on eval boardYesYesOkayCAT24C32 on i2c4 PEB-D-RPI
eMMCYesYesOkay

On SD3

PCM-061.A0 -.A4 SOMs: MTFC4GMDEA-4M

PCM-061-2110111C.A1: MTFC4GACAJCN-4M IT

RTCInternal i.MX7YesYesOkaySNVS RTC
External RTCYesYesOkayRV-4162-C7 on I2C1
Power ManagementPMICYesYesOkayPF3000 on I2C1
JTAGJTAG


ARM JTAG 20 connector on PEB-D-RPI

PCIemini-pcieYesYesOkayconnector X12

[1] Interface requires additional configuration, such as pinmuxing. It may be possible to change the software configuration to utilize this interface even if it is not being set in the board's default configuration. Please see NXP's i.MX7D Technical Reference Manual for more information on the various modes each pin can be muxed to.

New in this Release


PD19.1.0

  • General
    • Support for AWS IoT Greengrass is now included in the standard kit (imx7d-phyboard-zeta-004)
    • Machine configurations have been reorganized
      • imx7d-phyboard-zeta-001: (standard Dual kit with PEB-EVAL-02 board) has been removed
      • imx7s-phyboard-zeta-002: (standard Solo kit with  PEB-EVAL-02 board) has been removed
        • The SOM from the kit (imx7s-pcm-061-0502100e) is now a nonstandard SOM with PEB-D-RPI support
      • PEB-EVAL-02 support in all nonstandard SOMs has been replaced with PEB-D-RPI support
  • Yocto
    • Version: Ported to Yocto version 2.5 Sumo
    • Yocto Image: 
      • New imx7d-phyboard-zeta-004-mipi.dtb file is included in the boot partition of the -004 image (see "Linux Device Tree Summary")
      • Image now comes in .sdcard.bz2 format instead of .sdcard
    • Machine configuration file changes to reflect the changes listed in "General"
  • Linux
    • Version: Migrated from Linux Kernel v4.9.11 to v4.14.78 
    • Merged imx7d_phyboard_zeta_greengrass_defconfig into imx7d_phyboard_zeta_defconfig, and thereby removed the former
    • DTS file changes made to reflect machine configuration changes listed in "General"
  • U-Boot
    • Version: Migrated from v2017.03 to v2018.03
    • The default UART serial console was changed to be UART1 on the PEB-D-RPI module from UART5 on PBA-C-09 (carrier board)


Fixed in this Release


PD19.1.0

Not Tested


  • Booting via network
  • Qt5 - NXP includes "fsl-image-qt5" Yocto Image in the BSP but it is meant for i.MX SoCs with hardware graphics, and is not supported by NXP or PHYTEC for the i.MX7D.

Known Issues


PHYTEC Known Issues

  • IMX7SW-420: Using Java/Node.js with Greengrass:
    • The Node.js v6.10 package can't be found by Greengrass with its current package name. Link it to a file with the correct name:
      • ln -s /usr/bin/node /usr/bin/nodejs6.1
    • Java is experiencing runtime errors and will be fixed in a future release
  • Ethernet:
    • iperf3 is included with the Sumo Yocto BSP. With UDP, this command reports much lower bandwidth than expected when compared with iperf command.
  • eMMC:

    • IMX7SW-205: HS400 warnings/errors: configure eMMC to run at maximum 100MHz as a work around. See commit b8f6c1b7780 for more information
  • Linux IMX Busfreq driver:
    • Driver disabled by default due to previous issues with impaired UART console functionality, which have since been resolved
    • For dynamic bus frequency scaling and improved power consumption, the busfreq driver can be enabled in the device tree by removing the "fsl,freq_scaling_disabled" property in imx7-phycore-som.dtsi. It can also be controlled in Linux sysfs: 

      echo 1 > /sys/bus/platform/drivers/imx_busfreq/soc\:busfreq/enable 
  • NAND:
    • 256MB NAND is too small to flash fsl-image-validation-imx filesystem. Booting from NAND was tested with core-image-minimal Yocto image, which is included with release binaries.

NXP Known Issues

See i.MX Linux Release Notes from NXP in Linux 4.14.78_1.0.0 BSP Documentation


Technical Support


For further information or to report any problems, visit the PHYTEC Support Portal