1 Introduction Congratulations for acquiring our new product, combining best-in-class performance with a rich set of peripherals. Note: The latest version of this manual and related resources can always be found on our website at the following address: https://www.theobroma-systems.com/som-product/px30-uq7/ 1.1 Device Overview PX30 is a high-performance Quad-core application processor designed for personal mobile internet device and other digital multimedia applications.
2 First Steps This chapter provides instructions for getting the PX30-uQ7 EVK running after opening the box. 2.1 Insert the Module Insert the PX30-uQ7 module at a 30-degree angle into the connector in the base board. Once fully inserted, push it down until it rests on the standoffs and check alignment of the mounting holes.
3 Using the EVK This chapter provides instructions for using the EVK (also called Haikou), such as booting and how to configure and use I/O peripherals (e.g. serial console, Ethernet). 3.1 Evaluation Board Overview An overview of the available connectors and devices on the EVK is shown below. Note: The PX30-uQ7 does not support HDMI and PCIe x4 (they are shown with a * in the next figure).
Fig. 3.2: 12V Power connector Power can be controlled manually from the board using the control buttons and switches, located on the lower right side of the board (see Section 3.1 Evaluation Board Overview). Depending on the setting of ) switch, the board will boot as soon as it receives power.
Fig. 3.3: Fan connector Note: The fan is only necessary in high ambient temperatures. Under normal conditions, the PX30-uQ7 operates passively cooled. 3.5 Boot Order The used boot order of the PX30-uQ7 module depends on the value of the signal. On the Haikou baseboard, this signal can be set using a slider switch ( ), with the two positions labeled Normal Boot, and BIOS Disable.
Fig. 3.4: USB UART The serial converter does not require additional drivers on Windows and Linux. For Mac OS, drivers are available from Silicon Labs: https://www.silabs.com/products/development-tools/software/ usb-to-uart-bridge-vcp-drivers The uQ7 module has two external UARTs: • UART0 is, by default, used for the serial console for interactive login. •...
UART1 UART0 RS232 FULL/HALF RS485 DUPLEX Fig. 3.5: RS-232 connector The switch labeled selects between RS-232 and RS-485 mode on the jack. In RS-485 mode, the switch labeled selects full- or half-duplex mode, respectively. It has no effect in RS-232 mode, which is always full-duplex. 3.8 TTL UART UART0 and UART1 are also available through the pin headers next to the...
3.10 SD-Card The PX30-uQ7 supports UHS SD cards and maximum writing speed on the SD card is 50MB/s. The practical writing and reading speed depends on the capabilities of the inserted SD card. Fig. 3.7: SD card reader 3.11 USB Interfaces The PX30-uQ7 provides four USB ports: •...
Fig. 3.9: USB 2.0 host ports 3.11.1 Connecting an External USB Drive To connect a USB drive, plug it into one of the USB ports. The system should recognize the drive immediately. Check the kernel log to find the device name: You will be able to mount its partitions (assuming mapping to 3.12 Display and Camera The PX30-uQ7 supports display output on the LVDS A interface and the camera on the LVDS B interface.
You can also update the RTC immediately, again with 3.14 SPI and I2C SPI and I2C interfaces are both available on the pin header labeled . The PX30-uQ7 does not support Additional I2C buses are available on the header. Note that are not supported by the PX30-uQ7 module (shown in thin font in Fig.
3.14.1 Linux I2C Bus Numbering Linux identifies each I2C bus by a bus number. The table below shows the mapping between Q7 names, Linux bus number and EVK header. Q7 signals Linux bus # Haikou Header(s) Label on Haikou Header GP2_I2C_DAT/LVDS_DID_DAT &...
Q7 signal CPU pin Linux GPIO # GPIO0 GPIO3_C6 GPIO1 GPIO3_D0 GPIO2 GPIO3_C7 GPIO3 GPIO3_D1 GPIO4 GPIO3_C0 GPIO5 GPIO3_A2 GPIO6 GPIO3_A1 GPIO7 GPIO2_B6 To calculate the Linux GPIO # for CPU pins that are not listed in this table, use the following formula: Where: •...
Fig. 3.14: Audio input/output port Additionally, an expansion connector for I2S audio is available on the bottom row of the board: 3V3_LDO I2S_RST# I2S_CLK I2S_WS I2S_SDO I2S_SDI I2S_DAT I2S_CLK Fig. 3.15: Connecting to the audio expansion connector 3.17 CAN Bus The board provides a CAN connector on the bottom row.
Fig. 3.18: MISC header 3.20 JTAG Connector The board provides UPDI signals on the JTAG connector. The PX30-uQ7 does not support JTAG, but the ATtiny (see Section 10.4.5 Companion Controller 2) can be flashed over JTAG connector pins. Fig. 3.19: JTAG header JTAG header Function UPDI-TX...
4 Software Overview This chapter provides instructions for compiling and deploying the BSP (Board Support Package) software to the Q7 module. 4.1 Supported Distributions Two of the most popular embedded systems distributions are supported. The following chapters describe how to build a disk image for each of them: •...
5 Debian image guide As opposed to Yocto, Debian does not provide a completely integrated build experience by itself. Linux kernel and U-Boot have to be compiled manually and copied to the appropriate directory to be picked up by Debian. This chapter will go through all neccessary steps, finally building a complete image using the debos Debian image builder.
5.3 Compile U-Boot Note: The variable must be already set as described in Section 5.2 Compile the ATF . Get the source code and compile the U-Boot bootloader as follows: This step should take about 1 minute total. 5.4 Compile the Linux kernel Get the source code and compile the Linux kernel as follows: The time required for this step heavily depends on your internet connection and CPU power.
Page 26
(continued from previous page) Depending on your host PC and internet connection, this step should complete in about 5 minutes. The resulting image is a file called and, for convenience, the symlink that always points to the latest version. v1.0.1-8-g2dd91c8 Page 22...
6 Building a Yocto image The Yocto Project is an open-source project that helps building Linux-based distributions, mainly for embededded products. Theobroma Systems provides a minimal BSP layer to allow building Yocto images for the company’s modules. Upon request, access can be given to a more featureful “demonstration” layer which provides hardware and software validation scripts as well as demo applications.
Note: It is essential that the Yocto layers are checked out on the same branch otherwise there may be some unexpected issues. With the aforementioned instructions, the layers have been checked out to a branch supporting the Yocto Project Kirkstone (4.0) release.
user and also allows to easily build for multiple machines without modifying a file in-between. The build process can take several hours depending on the capabilities of the build machine and the user’s Internet connection. Note: If the Bitbake process needs to be stopped for any reason, a + ) signal can be sent once.
7 Deploy a disk image This chapter describe how to write a disk image as generated in one of the previous chapters using Yocto or Debian to the module. Note: The variable must be already set as described in respective chapter. Warning: Avoid having the disk image on both the SD Card and the internal eMMC of the module.
Page 31
Then, insert a micro-USB cable into the USB-OTG port (see Fig. 3.8 USB 2.0 OTG port (dual-role port: can be used as a host or device interface)) on the baseboard and into a USB port of your host PC. Then, power cycle the device by unplugging and replugging the power supply or by pressing the button.
8 Wifi The PX30-uQ7 module features an on-board Wifi module. This chapter shows how to connect to an existing Wifi network and how to flash the wifi firmware, should the need arise. 8.1 Connecting to a Wifi network You can show the available wifi networks using: Connect to a network using the following command (replace the network name and password as appropriate): You should get a message like: You should have connectivity over Wifi now.
9 Serial Number & MAC Address 9.1 Serial Number Each PX30-uQ7 module has a unique serial number that can be read by software. In U-Boot, the serial number is contained in the environment variable . You can print it using the command: Under Linux, it is represented by a simple text file in The serial number is fixed in hardware (derived from the SoC CPU ID) and cannot be modified.
10 Hardware Guide This Hardware Guide provides information about the features, connectors and signals available on the PX30-uQ7 module. 10.1 Q7 Implementation Q7 has mandatory and optional features. Following table shows the feature set of the PX30-uQ7 module compared to the minimum ARM/RISC based and maximum configuration according to the Q7 standard.
10.2 Q7 Connector Pinout The following table shows the signals on the edge connector of the PX30-uQ7 module. Empty cells are not connected (NC) pins. Signal Signal GBE_LINK# GBE_LINK1000# GBE_MDI1- GBE_MDIO0- GBE_MDI1+ GBE_MDIO0+ GBE_LINK# GBE_ACT# GBE_CTRFF SUS_S5# WAKE# SUS_S3# PWRBTN# SLP_BTN# LID_BTN# PWGIN...
Table 10.1 – continued from previous page Signal Signal 10.3 Signal Details 10.3.1 Ethernet Q7 Signal Type Signal Description Level GBE_MDI[0:1]+ Analog Fast Ethernet Controller: Media Dependent Interface Differential Pairs GBE_MDI[0:1]- 0,1. The MDI can operate in 100 and 10 Mbit/sec modes GBE_ACT# 3.3V Ethernet Controller activity indicator, active low...
Page 39
10.3.4 I2C Q7 Signal Type Signal Description Level Q7_I2C_CLK 3.3V I2C bus clock line connected to PX30 Q7_I2C_DAT 3.3V I2C bus data line connected to PX30 LVDS_DID_CLK 3.3V I2C bus clock line connected to PX30, Secure Element, STM32, Attiny /GP2_I2C_CLK and Video connector LVDS_DID_DAT 3.3V...
Page 40
Q7 Signal Function LVDS_B0_P CSI_D0+ LVDS_B0_N CSI_D0- LVDS_B1_P CSI_D1+ LVDS_B1_N CSI_D1- LVDS_B2_P CSI_D2+ LVDS_B2_N CSI_D2- LVDS_B3_P CSI_D3+ LVDS_B3_N CSI_D3- LVDS_B_CLK_P CSI_CLK+ LVDS_B_CLK_N CSI_CLK- 10.3.7 GPIO Q7 Signal Type Signal Description Level GPIO[0-7] 3.3V General purpose inputs/outputs 0 to 7 10.3.8 CAN Q7 Signal Type Signal...
10.3.11 Misc Signal Type Signal Description Level WDTRIG# 3.3V Watchdog trigger signal WDOUT 3.3V Watchdog event indicator SPKR 3.3V PC speaker (buzzer) output. Alternate function general purpose PWM GP_PWM_OUT2 output BIOS_DISABLE# 3.3V Disables the onboard bootloader and uses the one the SD card instead. /BOOT_ALT# If no bootloader is available on the SD card it falls back to USB recovery mode...
Page 42
Signal CPU Pin Linux GPIO # RESET GPIO1_B3 10.4.4 Companion Controller 1 The first on-board microcontroller provides additional features to the CPU, exposed via I2C and USB. It emulates standard ICs and does not need custom drivers in Linux. Feature CPU Connection Emulated IC Qseven Pins...
10.5 Wifi and Bluetooth module Fig. 10.1: WiFi and Bluetooth module The WiFi and Bluetooth are part of the ESP32 PICO MINI 02U module on the PX30-uQ7 board. The antenna connector on the module is w.FL type. The firmware running on the ESP32 is flashed in its internal memory and unlike most wireless modules, does not require files to be present in the root filesystem.
Page 44
Table 10.2 – continued from previous page Test point Connected to TP20 PMIC_Xin TP21 PMIC_Xout TP22 PX30_Xin TP23 PX30_Xout TP24 MCU_UART_TX TP25 MCU_UART_RX TP26 Q7_LVDS_DID_CLK TP27 Q7_LVDS_DID_DAT TP28 Q7_LVDS_BLC_DAT TP29 Q7_LVDS_BLC_CLK TP30 I34 WiFi TP31 I35 WiFi TP32 ESP32_TXD0 TP33 ESP32_RXD0 TP34 BT_UART_TX...
10.6 USB The PX30-uQ7 CPU has 2 USB 2.0 controllers. A USB 2.0 hub provides two additional USB 2.0 ports for a total of four. The routing of Qseven signals to CPU and/or hub port is shown below. Qseven Port # Speed Connected to Notes...
10.7 Using Qseven Signals as GPIO Most Qseven signals can be reused as a general purpose I/O pin. The following table shows the mapping and the possible direction as seen from the baseboard. Qseven Signal CPU Pin Linux Direction GPIO SUS_S5# GPIO3_A0 Bidirectional...
10.9 Mechanical Specification 10.9.1 Module Dimensions The mechanical dimensions of the module are shown below. Fig. 10.2: Module dimensions (all values in mm) 10.9.2 Baseboard Dimensions The mechanical dimensions of the baseboard are conform with the form factor for Mini-ITX and the baseboard can be mounted in a standard Mini-ITX PC Case.