Operating SystemLinux
BSP Release Status

RELEASED

Release Date

    

RepositoryPHYTEC Public Repos
BinariesBSP-Yocto-FSL-iMX7-PD18.1.0
Source Archive
Release Notes

Click Here


Introduction


This BSP provides a basis for development, deployment and execution of Linux based applications on the iMX7 System on Module (SOM). For detailed information on the various software components included in the release and how to use them, please refer to the Quickstart.

Versioning


Software

Linux Kernel4.9.11 (Based on NXP Release L4.9.11_1.0.0_ga)
U-Boot2017.03 (Based on NXP Release L4.9.11_1.0.0_ga )
Yocto2.2 Morty (Based on NXP Release L4.9.11_1.0.0_ga )
QtNot Supported (Click here for more info)
Host OSTested on 64-bit Ubuntu 16.04 LTS


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 File
imx7d-phyboard-zeta-001

PB-01910-001

(i.MX7Dual Kit)

PCM-061-2110111C

PEB-EVAL-02

PEB-AV-02

mx7d_pcm061_21x_config

imx7d-phyboard-zeta-001.dtb
imx7s-phyboard-zeta-002

PB-01910-002

(i.MX7Solo Kit)

PCM-061-0502100E

PEB-EVAL-02


mx7s_pcm061_05x_config

imx7s-phyboard-zeta-002.dtb
imx7d-pcm-061-2111101eNon-Standard Kit

PCM-061-2111101E

PEB-EVAL-02

PEB-AV-02

mx7d_pcm061_21x_configimx7d-pcm-061-2111101e.dtb
imx7d-pcm-061-2111111eNon-Standard Kit

PCM-061-2111111E

PEB-EVAL-02

PEB-AV-02

mx7d_pcm061_21x_config

imx7d-pcm-061-2111111e.dtb

imx7d-pcm-061-2211101eNon-Standard Kit

PCM-061-2211101E

PEB-EVAL-02

PEB-AV-02

mx7d_pcm061_21x_configimx7d-pcm-061-2211101e.dtb








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-001).

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-001)Default dts build targetimx7d-phyboard-zeta-001.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
Evaluation Boardimx7-peb-eval-02.dtsi
WiFi/Bluetooth Moduleimx7-peb-wlbt-03.dtsi


Alternate dts imx7d-phyboard-zeta-001-m4.dtbconfigure u-boot to use this DTS if running Linux on the Cortex-A7 while running FreeRTOS on the Cortex-M4

Compatible Hardware

Supported Hardware Versions

Hardware DescriptionPart Number

Configuration Details

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

PCB Version
phyCORE-i.MX7 SOM

PCM-061-2110111C.A1

Dual / 1GB / 4GB eMMC / Yes

1458.2



PCM-061-2110111C.A0

PCM-061-0502100E.A0Solo / 256MB / 256MB NAND / No
PCM-061-2111101E.A0Dual / 1GB / 4GB eMMC / No
PCM-061-2211101E.A0Dual / 1GB / 8GB eMMC / No
PCM-061-2111111E.A0Dual / 1GB / 4GB eMMC / Yes
phyBOARD-Zeta Carrier Board

PBA-C-09.A4


1459.2

PBA-C-09.A5
1459.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
LCD Display Adapter with 7'' capacitive display

PEB-AV-02-070W.A0

(Includes AV module, display, and cable)

1415.1ETM0700G0DH6 LCD Display/ Capacitive touch interface
Evaluation BoardPEB-EVAL-021460.0

Connects to expansion header and provides:

UART1, UART2, JTAG, I2C EEPROM, three user buttons, three user LEDs

WiFi/Bluetooth ModulePEB-WLBT-03-CA.A11478.1

LAIRD Sterling-LWB module, connects to phyBOARD expansion header

BSP Download


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

BSP-Yocto-FSL-iMX7-PD18.1.0

Quickstart


Quickstarts for BSP-Yocto-FSL-iMX7-PD18.1.0:

BSP Yocto FSL i.MX7 PD18.1.0 Quickstart

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-001).

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

InterfaceDetailImplementedTestedStatus in Device TreeNotes
UARTuart1YesYesOkayDB9 connector on PEB-EVAL-02
uart2YesYesDisabled

DB9 connector on PEB-EVAL-02

Disabled for use as serial console on Cortex-M4 FreeRTOS

uart3YesNoDisabled1expansion header
uart4YesNoDisabled1
uart5YesYesOkayRS232 default serial console at Connector X2
uart6YesNoDisabled1 expansion header
uart7YesYesOkayexpansion header - Configured for BT on PEB-WLBT-03
I2Ci2c1YesYesOkayexpansion header
i2c2YesYesOkayAV Connector X4
i2c3YesNoDisabled1 
i2c4YesYesOkayexpansion header
EthernetRGMII1YesYesOkayKSZ9031RNX PHY on SOM, Connector X8
RGMII2YesYesOkayKSZ9031RNX PHY on CarrierBoard, Connector X7
SAIsai1YesNoDisabled1Audio/Video Connector X4
sai2YesNoDisabled1expansion header
sai3YesNoDisabled1 
MMC/SDIOSD1YesYesYesmicroSD slot connector X11
SD2YesNoDisabled1expansion header
SD3YesYesOkaysignals routed to eMMC.
CommunicationMultiCore Communication with Cortex-M4 (RPMsg)YesYesOkaySee FreeRTOS release for more info.
Laird Sterling LWB BluetoothYesNoDisabledon PEB-WLBT-03. See Not Tested section for details
Laird Sterling LWB WiFiYesNoDisabledon PEB-WLBT-03. See Not Tested section for details
USBusb1YesYesOkayUSB-A Host Connector X9
usb2YesYesOkayUSB-AB OTG Connector X10
usbh (HSIC)YesYesDisabledexpansion header
CANcan1YesYesOkayHeader X1
can2YesNoDisabled1
SPIspi1YesNoDisabled1expansion header
spi2YesNoDisabled1expansion header
spi3YesNoDisabled1expansion header
spi4YesNoDisabled1
ADCadc1YesYesOkayexpansion header
Display and TouchLCD DisplayYesYesOkayvia expansion board PEB-AV-02
Analog LCD TouchYesYesOkay

Capacitive ETM-FT5x06

via expansion board PEB-AV-02

BacklightYesYesOkay

PWM via pwm4

via expansion board PEB-AV-02

GPIO

User Buttons and LEDs

YesYesOkay

User LED GPIO2_10 on CarrierBoard

Three user LEDs and three buttons on PEB-EVAL-02 

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-EVAL-02 
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-EVAL-02
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


  • Yocto
    • Version: Ported to Yocto version 2.2 Morty
    • Yocto Image: supported image name changed from "fsl-image-gui" to "fsl-image-validation-imx". 
      • The image type is the same, just the naming has been changed by NXP. Note that the image name "fsl-image-gui" is still functional but simply uses the recipe for fsl-image-validation-imx.
  • Linux
    • Version: Migrated from Linux Kernel v4.1.15 to v4.9.11
    • Devicetree
      • imx7s.dtsi: Updated DTS structure to use separate processor dtsi for i.MX7 Solo, imx7s.dtsi. The i.MX7 Dual dtsi file, imx7d.dtsi, now includes the imx7s.dtsi and enables additional features.
      • Created separate carrier board dtsi files for i.MX7 Dual and Solo since the Solo does not support certain interfaces that are brought out on the carrier board. The new carrier board dtsi files are named "imx7s-pba-c-09.dtsi" and "imx7d-pba-c-09.dtsi".
  • U-Boot
    • Version: Migrated from v2016.03 to v2017.03
    • Devicetree: switched from board file to device tree.

Fixed In This Release



  • Linux:
    • imx7s-phyboard-zeta-002: reduce the size of CMA allocated on boot. Due to performance issues with the 4.9 kernel upgrade, less memory has been allocated to CMA so that more is available for the rest of the system.

Not Tested


  • PEB-WLBT-03:
    • Driver support for Laird Sterling LWB has not been tested with Linux v4.9.11
  • 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

  • Ethernet:
    • iperf3 is included with the Morty Yocto BSP. With UDP, this command reports much lower bandwidth than expected when compared with iperf command.
  • eMMC:

    • Flashing with U-Boot: 
      • fsl-image-validation-imx-imx7d-phyboard-zeta-001.sdcard image is too large to be loaded into memory (1GB) from u-boot.
      • Workaround: Partition and flash eMMC from Linux instead. See Quickstart for instructions.
    • 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 impaired UART console functionality when the system is idle (Low frequency setpoint).
    • 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  L4.9.11_1.0.0 BSP Documentation


Technical Support


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