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.

• 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.

Inter-integrated Circuit (I2C)

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

Network

For more information about the devs-cgem.so driver, see the devs-cgem.so section in the QNX OS Utilities Reference guide of the QNX Software Development Platform 8.0 documentation.

PCI Server

SD/MMC

 devb-sdmmc-bcm2712 sdio addr=0x1000fff000,irq=305 disk name=sd waitfor /dev/sd0
 mount -t dos /dev/sd0t12 /fs/sd

Serial

For more information about the serial drivers, see the devc-serpl011-rpi5 section in the BSP-specific Drivers and Utilities chapter of this guide.

SPI

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

Startup

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.

 io-usb-otg -v -d dwc3-xhci ioport=0x1f00200000,irq=0xbf,iosize=0x100000, bmstr=0x1000000000, ioport=0x1f00300000, irq=0xc4, iosize=0x100000,bmstr=0x1000000000
 waitfor /dev/usb/io-usb-otg 10
 devb-umass cam pnp dos disk name=umass

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

Watchdog

To enable the watchdog:

1. Launch startup with the -W option, with an optional parameter for timeout:

   startup-bcm2712-rpi5 -v -u reg -a -W 5000

2. Launch the watchdog timer utility early on in the boot script:

   wdtkick -W0x24:0x5A028E4C -W0x1c:0x5A000020

3. To adjust the watchdog timeout value of the PM_WDOG register, use the formula:

   register_val = ((timeout_in_ms * 67) | 0x5a000000)

   For example, use 0x5A028E4C for 2500 ms timeout value:

   ((2500 * 67) | 0x5a000000) = 0x28E4C | 0x5a000000 = 0x5A028E4C

Wireless (WiFi)

There are a couple of ways to add WiFi support in this BSP:

1. Rebuild BSP by modifying .build file in $BSP_ROOT_DIR/images directory to startup additional io-sock instance with wifi driver, for example:

   io-sock -o prefix=/wifi -o config=/etc/io-sock.conf -d qwdi_dhd_sdio-2_11-rpi5

2. Rebuild BSP by modifying .build file in $BSP_ROOT_DIR/images directory to startup io-sock instance with wifi driver, for example:

   io-sock -m phy -m fdt -d cgem -o config=/etc/io-sock.conf -d qwdi_dhd_sdio-2_11-rpi5

io-sock -o prefix=/wifi -o config=/etc/io-sock.conf -d qwdi_dhd_sdio-2_11-rpi5
SOCK=/wifi dhcpcd -bqq
SOCK=/wifi /proc/boot/.ssh-server.sh
SOCK=/wifi wpa_supplicant -D qwdi -i bcm0 -c /tmp/wpa_supplicant.conf &
SOCK=/wifi ifconfig

io-sock -m phy -m fdt -d cgem -o config=/etc/io-sock.conf -d qwdi_dhd_sdio-2_11-rpi5
dhcpcd -bqq
/proc/boot/.ssh-server.sh
wpa_supplicant -D qwdi -i bcm0 -c /tmp/wpa_supplicant.conf &
ifconfig

ctrl_interface=/var/run/wpa_supplicant
network={
    # the SSID of a public Wi-Fi networks
    ssid="open_ssid_example"
    key_mgmt=NONE
}