Cherry theobroma SYSTEMS PX30-mQ7 User Manual

System-on-module quad-core arm cortex-a35 featuring the rockchip px30 application processor
Hide thumbs Also See for theobroma SYSTEMS PX30-mQ7:

Advertisement

Quick Links

USER MANUAL
PX30- Q7
System-on-Module
Quad-Core ARM Cortex-A35
featuring the Rockchip PX30 application processor
Document revision:
v1.0.1-8-g2dd91c8
Issue date:
Feb 03, 2023

Advertisement

Table of Contents
loading

Summary of Contents for Cherry theobroma SYSTEMS PX30-mQ7

  • Page 1 USER MANUAL PX30- Q7 System-on-Module Quad-Core ARM Cortex-A35 featuring the Rockchip PX30 application processor Document revision: v1.0.1-8-g2dd91c8 Issue date: Feb 03, 2023...
  • Page 3: Table Of Contents

    Contents 1 Introduction Device Overview ..........2 First Steps Insert the Module .
  • Page 4 Flashing the wifi firmware ..........9 Serial Number &...
  • Page 5: Introduction

    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.
  • Page 6: First Steps

    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.
  • Page 7 RS232 Power USB UART Fig. 2.2: Serial console and boot configuration PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 © Theobroma Systems Design und Consulting GmbH Page 3...
  • Page 8: Using The Evk

    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).
  • Page 9: Power Supply

    Battery Buzzer CTRL I/OSMBus GPIO Misc I/O UPDI SPI+I2C+1-wire SD - Card Slot Fig. 3.1: The base board for to PX30-uQ7 module (connectors marked with a * are not supported) 3.2 Power Supply The baseboard can operate with a single 12V DC power supply. PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 ©...
  • Page 10: Control Buttons And Switches

    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.
  • Page 11: Boot Order

    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.
  • Page 12: Rs-232 And Rs-485

    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. •...
  • Page 13: Ttl Uart

    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...
  • Page 14: Sd-Card

    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: •...
  • Page 15: Display And Camera

    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.
  • Page 16: Rtc

    LVDS_B_CLK_N LVDS_A3_N LVDS_A_CLK_P LVDS_A3_P LVDS_B3_N LVDS_B3_P LVDS_A2_N LVDS_A2_P LVDS_B2_N LVDS_B2_P LVDS_A1_N LVDS_A1_P LVDS_B1_N LVDS_B1_P LVDS_A0_N DP_HPD# LVDS_A0_P LVDS_B0_N LVDS_A_CLK_N LVDS_B0_P LVDS_A_CLK_P LVDS_PEN LVDS_BLC_DAT LVDS_BLC_CLK LVDS_BLT_CTRL LVDS_BLEN LVDS_DID_DAT LVDS_DID_CLK GPO0 Fig. 3.10: Video connector pinout The kernel devicetree defines the used display configuration. Example device trees for various output configurations are pro- vided with the EVK software package.
  • Page 17: Spi And I2C

    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.
  • Page 18: Gpios

    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 &...
  • Page 19: Audio

    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: •...
  • Page 20: Can Bus

    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.
  • Page 21: Ctrl I/O Connector

    Fig. 3.16: CAN header 3.18 CTRL I/O Connector The board provides signals for watchdog trigger in- and output, SoM PMIC power-on input, reset and external display power enable. Fig. 3.17: CTRL I/O header 3.19 MISC Connector The board provides signals for thermal overheat of external hardware and the processor, utility signals for SD and GPIO0. PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 ©...
  • Page 22: Jtag Connector

    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...
  • Page 23: Software Overview

    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: •...
  • Page 24: Debian Image Guide

    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.
  • Page 25: Compile U-Boot

    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...
  • Page 27: Building A Yocto Image

    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.
  • Page 28: Initializing Build Environment

    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.
  • Page 29: Flashing An Sd Card With

    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.
  • Page 30: Deploy A Disk Image

    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.
  • Page 32: Wifi

    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.
  • Page 33 (continued from previous page) Note: On Debian, the package provided by the package feed is too old. Instead, please install software from pip: Note: By default, esptool is not available in our Yocto core-image-minimal image. PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 © Theobroma Systems Design und Consulting GmbH Page 29...
  • Page 34: Serial Number & Mac Address

    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.
  • Page 35: Hardware Guide

    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.
  • Page 36: Q7 Connector Pinout

    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...
  • Page 37 Table 10.1 – continued from previous page Signal Signal LVDS_A1+/DSI_D1+ CSI_D1+ LVDS_A1-/DSI_D1- CSI_D1- LVDS_A2+/DSI_D2+ CSI_D2+ LVDS_A2-/DSI_D2- CSI_D2- LVDS_PPEN LVDS_BLEN LVDS_A3+/DSI_D3+ CSI_D3+ LVDS_A3-/DSI_D3- CSI_D3- LVDS_A_CLK+/DSI_CLK+ CSI_CLK+ LVDS_A_CLK-/DSI_CLK- CSI_CLK- LVDS_BLT_CTRL / GP_PWM_OUT0 GP2_I2C_DAT / LVDS_DID_DAT LVDS_BLC_DAT GP2_I2C_CLK / LVDS_DID_CLK LVDS_BLC_CLK CAN0_TX CAN0_RX UART0_TX UART0_RTS# UART0_RX...
  • Page 38: Signal Details

    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...
  • Page 41: On-Board Devices

    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...
  • Page 43: Wifi And Bluetooth Module

    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...
  • Page 45: Usb

    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...
  • Page 46: Using Qseven Signals As Gpio

    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...
  • Page 47: Electrical Specification

    10.8 Electrical Specification 10.8.1 Power Supply The power supply requirements are listed in the table below and are identical to the Qseven specification. Rail Description Nominal voltage Tolerance Main power supply 4.75 . . . 5.25V VCC_RTC Backup battery 2.4 . . . 3.3V PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 ©...
  • Page 48: Mechanical Specification

    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.
  • Page 49: Revision History

    11 Revision History Date Revision Changes Nov 1, 2022 v0.0.1 First internal release Dec 21, 2022 v1.0.0 Internal review ; public release Dec 21, 2022 v1.0.1 Fix one missing image in html output PX30-uQ7 User Manual v1.0.1-8-g2dd91c8 © Theobroma Systems Design und Consulting GmbH Page 45...

This manual is also suitable for:

Theobroma systems ringneck som-px30-mq7

Table of Contents