Driver Commands

Some of the drivers are commented out in the buildfile. To use these drivers on the target hardware, you may need to uncomment them in the buildfile, rebuild the image, and then load the image onto the board.

The order that the drivers are started in the provided buildfile is one way to start them. The order that you start the drivers is completely customizable and is often specific to your system requirements. For example, if you need an audible sound to play immediately, you must start the audio driver earlier than other drivers. It's important to recognize that the order you choose impacts the boot time.

Note:

Some drivers depend on other drivers, so it's sometimes necessary to start them in a specific order.

For more information on best practices for building an embedded system and optimizing boot times for your system, see the Building Embedded Systems and the Boot Optimization guides in the QNX Software Development Platform 8.0 documentation.
For more information about the drivers and commands listed here, see the QNX OS Utilities Reference. This chapter provides information about BSP-specific options for any of the commands and drivers that aren't described in the Utilities Reference. In some cases, the driver or command is specific to this BSP, in which case, you'll find the information in the BSP-specific Drivers and Utilities chapter.

Here's the list of drivers available for this board and the order in which they appear in the buildfile:

Startup
Watchdog
Inter-integrated Circuit (I2C) (three interfaces)
Real-time clock (RTC)
PCI Server
CAN
Serial
SPI
SD/MMC
Octal xSPI NOR Flash Memory
USB OTG host controller
Network
Graphics

CAN


Device	FlexCAN
Command	devcan-flexcan -h -b250K can0 devcan-flexcan -h -b250K can1
Required binaries	devcan-flexcan, canctl
Required libraries	libsecpol.so, libc.so.6, libgcc_s.so.1
Source location	$BSP_ROOT_DIR/src/hardware/can/flexcan

For more information about this driver, see devcan-flexcan in the BSP-specific Drivers and Utilities chapter of this guide.

Graphics


Device	Graphics
Command	screen
Required binaries	screen and several other binaries. For more information, see the Using the Screen Graphics Subsystem chapter in this guide.
Required libraries	For more information, see the Using the Screen Graphics Subsystem chapter in this guide.
Source location	N/A

Inter-integrated Circuit (I2C) (three interfaces)


Device	I2C
Command (I2C1)	i2c-imx -p 0x30A20000 -i67 -c66000000 --u 1
Command (I2C2)	i2c-imx -p 0x30A30000 -i68 -c66000000 --u 2
Command (I2C3)	i2c-imx -p 0x30A40000 -i69 -c66000000 --u 3
Required binaries	i2c-imx
Required libraries	libc.so.6, libgcc_s.so.1
Source location	$BSP_ROOT_DIR/src/hardware/i2c/imx

For more information about this driver, see the i2c-imx section in the BSP-specific Drivers and Utilities chapter of this guide.

Network


Device	ETHERNET
Command	io-sock -m phy -m fdt -m phy_fdt -d ffec -d dwceqos -m pci -d em -d ix -d re -m usb -d axe -d axge -d cdce -d smsc dhcpcd -bqq
Required binaries	io-sock, dhcpcd, dhcpcd-run-hooks,ifconfig,if_up, pfctl
Required libraries	devs-dwceqos.so, devs-ffec.so, libgcc_s.so.1, libc.so.6, libsocket.so, libedit.so, libexpat.so, libxo.so, libfdt.so, librpc.so devs-libpci.so, devs-libusbdci.so devs-phy.so, devs-libfdt.so
Other files	imx8mp-evk.dtb
Source location	Binary only

For information about the devs-dwceqos.so and the devs-ffec.so drivers, see the devs-dwceqos.so and devs-ffec.so sections, respectively in the BSP-specific Drivers and Utilities chapter of this guide.

For information about io-sock, see QNX SDP 8.0 High-Performance Networking Stack User's Guide

Octal xSPI NOR Flash Memory


Device	xSPI NOR FLash
Command	devf-nxp-fspi
Required binaries	devf-nxp-fspi, flashctl
Required libraries	libsecpol.so, libgcc_s.so.1, libc.so.6
Source location	$BSP_ROOT_DIR/src/hardware/flash/boards/nxp-fspi

For more information about this driver, see the devf-nxp-fspi section in the BSP-specific Drivers and Utilities chapter of this guide.

PCI Server


Device	PCI
Command	pci-server --bus-scan-limit=1 -c
Required binaries	pci-server
Required libraries	pci_hw-nxp-imx8m-cpu.so, pci_server-buscfg-generic.so, pci_debug2.so, pci_slog2.so, pci_strings.so, pci_cap-0x01.so, pci_cap-0x05.so, pci_cap-0x10.so, pci_cap-0x11.so, pci_bkwd_compat.so, libsecpol.so, libgcc_s.so.1, libc.so.6
Configuration files	/etc/system/config/pci/pci_hw-imx8m-evk.cfg
Environment variables	PCI_HW_MODULE, PCI_HW_CONFIG_FILE, PCI_DEBUG_MODULE, PCI_BASE_VERBOSITY, PCI_SLOG_MODULE, PCI_BKWD_COMPAT_MODULE, PCI_MODULE_BLACKLIST, For more information about the environment, see the Environment variables section in the Overview chapter of the PCI Server User's Guide.
Source location	Prebuilt only

For more information about this driver, see the pci-server section in the QNX OS Utilities Reference guide of the QNX SDP 8.0 documentation.

Real-time clock (RTC)


Device	RTC
Command	`rtc hw`
Required binaries	rtc, date
Required libraries	libc.so.6, libgcc_s.so.1
Source location	src/utils/r/rtc

For more information about this driver, see the rtc in the Utilities Reference guide of the QNX SDP 8.0 documentation.

SD/MMC


Device	SD/MMC
Command (SD driver)	devb-sdmmc-mx8x cam pnp,cache,quiet blk ra=64k:2048k,memory=sysram&below4G:sysram,maxio=256,cache=4m disk name=sd sdio idx=1,bs=cd=0x30210000^12^588,verbose=1
Command ( eMMC, which uses USDHC3 controller)	devb-sdmmc-mx8x cam cache,quiet sdmmc partitions=on blk ra=64k:2048k,memory=sysram&below4G:sysram,maxio=256,cache=4m disk name=emmc sdio idx=2,emmc,bw=8,hs=tuning_mode=standard,verbose=1 waitfor /dev/emmc0 3
Required binaries	devb-sdmmc-mx8x
Required libraries	libcam.so, io-blk.so, cam-disk.so, libgcc_s.so.1, libc.so.6,libsecpol.so
Source location	$BSP_ROOT_DIR/src/hardware/devb/sdmmc

Example of running eMMC driver and partitioning, formatting, and mounting a DOS partition on the the eMMC to /fs/emmc:

devb-sdmmc-mx8x cam cache,quiet sdmmc partitions=on blk ra=64k:2048k,
                           memory=sysram&below4G:sysram,maxio=256,cache=4m
                           disk name=emmc sdio idx=2,emmc,bw=8,hs=tuning_mode=standard,
                           verbose=1
waitfor /dev/emmc0 3
fdisk /dev/emmc0 add -t 11
mount -e /dev/emmc0
waitfor /dev/emmc0t11
mkdosfs /dev/emmc0t11
mount -t dos /dev/emmc0t11 /fs/emmc

Example of mounting a DOS partition on the SD to the /fs/sd directory:

devb-sdmmc-mx8x cam pnp,cache,quiet blk ra=64k:2048k,
                memory=sysram&below4G:sysram,maxio=256,cache=4m
                disk name=sd sdio idx=1,bs=cd=0x30210000^12^588,verbose=1
waitfor /dev/sd0 3
mount -t dos /dev/sd0t12 /fs/sd

For more information about this driver, see the devb-sdmmc-* options described in the Utilities Reference guide of the QNX SDP 8.0 documentation.

Serial


Device	Serial
Command for UART1 (USB connected to RS232 bridge for console)	devc-sermx1 -e -F -S -u 1 0x30890000,59
Command for UART2	devc-sermx1 -F -S -u 2 0x30890000,59
Command for UART3	devc-sermx1 -F -S -u 3 0x30880000,60
Command for UART4	devc-sermx1 -F -S -u 4 0x30A60000,61
Required binaries	devc-sermx1
Required libraries	libgcc_s.so.1, libc.so.6
Source location	$BSP_ROOT_DIR/src/hardware/devc/sermx1

For more information about this driver, see the devc-sermx1 section in the BSP-specific Drivers and Utilities chapter of this guide.

SPI


Device	SPI
Command	spi-ecspi
Required binaries	spi-ecspi
Required libraries	libgcc_s.so.1, libc.so.6
Configuration files	/etc/system/config/spi/spi.conf
Source location	$BSP_ROOT_DIR/src/hardware/spi/ecspi

For more information about the spi-ecspi driver for this board, see spi-ecspi in the BSP-specific Drivers and Utilities chapter of this guide.

Startup


Device	Startup
Command	`startup-imx8mp-evk -u reg -W`
Required binaries	startup-imx8mp-evk
Required libraries	N/A
Source location	$BSP_ROOT_DIR/src/hardware/startup/boards/imx (common) $BSP_ROOT_DIR/src/hardware/startup/boards/imx/imx8m/mp/evk (i.MX8MP EVK)

In addition to the startup-* options described in the Utilities Reference, you can also use the following option with this command:

-W: Enable watchdog timer support. Ensure that you start the watchdog driver after when you use this option.

USB OTG host controller (io-usb-otg stack)

USB host controller and OTG controller; host mode uses io-usb-otg stack.


Device	USB host controller
Command	io-usb-otg -d hcd-imx8-xhci ioport=0x38100000,irq=72,ioport=0x38200000,irq=73
Required binaries	io-usb-otg, usb, tcpm-imx8mp
Required libraries	devu-hcd-imx8-xhci.so, libc.so.6, libgcc_s.so.1
Source location	Prebuilt only

The tcpm-imx8mp is a utility provided by NXP. You must run tcpm-imx8mp after you run the devu-hcd-imx8-xhci driver to start USB Type-C. For information about the tcpm-imx8mp utility, see the NXP documentation.

Example of xHCI controller:

io-usb-otg -d hcd-imx8-xhci ioport=0x38100000,irq=72,ioport=0x38200000,irq=73
waitfor /dev/usb/io-usb-otg 4
waitfor /dev/usb/devu-hcd-imx8-xhci.so 4
tcpm-imx8mp &
devb-umass cam pnp

When a mass storage device is plugged in, devb-umass creates a resource manager under /dev/hdXtY where X represents the partition number and Y represents the partition type. For example, if you use a mass storage with one FAT32 partition (MBR), it creates two resource manager paths, which are /dev/hd0 and /dev/hd0t11. You would mount the second resource manager, where in this example, 11 specifies a FAT32 filesystem (i.e., mount -t dos /dev/hd0t11 /fs/usb0).

For more information about the devu-hcd-imx8-xhci.so driver, see the devu-hcd-imx8-xhci.so section in the BSP-specific Drivers and Utilities chapter.

Watchdog utility

To enable the watchdog:

Launch startup with the -W option:
startup-imx8mp-evk -W
Launch the watchdog timer utility early on in the boot script:
wdtkick -t 5000


Device	Watchdog timer
Command	wdtkick wdtkick -t 5000
Required binaries	wdtkick
Required libraries	libc.so.6, libgcc_s.so.1
Source location	src/hardware/support/wdtkick

For more information about this driver, see wdtkick in the Utilities Reference guide of the QNX SDP 8.0 documentation.