Related Manuals for Cherry RINGNECK SOM-PX30-uQ7
Summary of Contents for Cherry RINGNECK SOM-PX30-uQ7
- Page 1 RINGNECK SOM-PX30-uQ7 Power efficient System-on-Module with Quad-Core ARM featuring the Rockchip PX30 application processor USER MANUAL Document revision: v1.3.1 Issue date: Feb 04, 2024...
-
Page 3: Table Of Contents
Serial Number ..........RINGNECK SOM-PX30-uQ7 User Manual v1.3.1... - Page 4 MAC Address ..........10 Mule Companion Controller 10.1 Companion Controller 1 (STM32) .
-
Page 5: Introduction
Crypographic Extension (e.g.for wire-rate AES encryption) and AdvSIMD vector processing. The ability to receive camera sensor input through a MIPI-CSI interface and to process the resulting imagestream in real-time with the powerful ARM processor cores enables vision and image-analytics applications. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH... -
Page 6: First Steps
2.1 Insert the Module Insert the RINGNECK SOM-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 RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 3...
-
Page 8: Using The Evk
3.1 Evaluation Board Overview An overview of the available connectors and devices on the EVK is shown below. Note: The RINGNECK SOM-PX30-uQ7 does not support HDMI and PCIe x4 (they are shown with a * in the next figure). v1.3.1... - Page 9 Buzzer CTRL I/OSMBus Misc I/O GPIO UPDI SPI+I2C+1-wire SD - Card Slot Fig. 3.1: The baseboard with RINGNECK SOM-PX30-uQ7 module (connectors marked with a * are not supported) RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 5...
-
Page 10: Power Supply
Depending on the setting of Power Mode (Normally On / Normally Off) switch, the board will boot as soon as it receives power. 3.3 Control Buttons and Switches The control buttons (see Fig. 3.1 The baseboard with RINGNECK SOM-PX30-uQ7 module) provide the following functionality: • Power toggles the module power supply. -
Page 11: Boot Order
USB loader USB loader If no bootloader is found on any storage device, the RINGNECK SOM-PX30-uQ7 module will go into USB loader mode, showing up as a USB device on the USB-OTG port. The electrical state of the BIOS_DISABLE# signal for both slider positions is shown below:... -
Page 12: Usb Serial Console
For macOS, drivers are available from Silicon Labs: https://www.silabs.com/products/development-tools/ software/usb-to-uart-bridge-vcp-drivers The RINGNECK SOM-PX30-uQ7 module has two external UARTs: • UART0 is, by default, used for the serial console for interactive login. • UART1 is unused by default and can be freely used for machine-to-machine communications or other purposes. -
Page 13: Rs-232 And Rs-485
3.8 TTL UART UART0 and UART1 are also available through the pin headers P12 UART0 and P30 UART1 next to the RS232 / RS485 jack. The signal level is 3.3V. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH... -
Page 14: Ethernet
SSH login on port 22. 3.10 SD-Card The RINGNECK SOM-PX30-uQ7 supports UHS SD cards and maximum writing speed on the SD card is 50MB/s. The practical writing and reading speeds depend on the capabilities of the inserted SD card. -
Page 15: Usb Interfaces
3.11 USB Interfaces The RINGNECK SOM-PX30-uQ7 provides four USB ports: • 1x USB 2.0 OTG • 3x USB 2.0 Host Fig. 3.8: USB 2.0 OTG port (dual-role port: can be used as a host or device interface) Fig. 3.9: USB 2.0 host ports 3.11.1 Connecting an External USB Drive... -
Page 16: Display And Camera
3.12 Display and Camera The RINGNECK SOM-PX30-uQ7 supports display output on the LVDS A interface and the camera on the LVDS B interface. For MIPI-DSI and MIPI-CSI, the Qseven LVDS pins are used. Those pins are routed to the Video connector. -
Page 17: Rtc
SOM-PX30-uQ7 does not support 1-Wire. Additional I2C buses are available on the SMBUS header. Note that SMB_DAT, SMB_CLK, SMB_ALERT# are not sup- ported by the RINGNECK SOM-PX30-uQ7 module (shown in thin font in Fig. 3.12). Fig. 3.11: I2C and SPI header RINGNECK SOM-PX30-uQ7 User Manual v1.3.1... -
Page 18: Gpios
Fig. 3.12: SMBUS header For I2C, the i2c-tools package is available in Debian: apt-get install i2c-tools 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. - Page 19 To enable a GPIO, write the Linux GPIO # to the special export file: $ echo 118 > /sys/class/gpio/export $ cat /sys/class/gpio/gpio118/direction $ cat /sys/class/gpio/gpio118/value To set the direction to output, write out in the GPIO’s direction file: RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 15...
-
Page 20: Audio
Note: The codec on the Haikou baseboard only supports a sample rate 48kHz . This restriction only applies to this specific codec on the Haikou baseboard. The I2S bus on the RINGNECK SOM-PX30-uQ7 module supports a sample rate up to 192kHz. Fig. 3.14: Audio input/output port... -
Page 21: Can Bus
3.17 CAN Bus The board provides a CAN connector on the bottom row. Fig. 3.16: CAN header Note: CAN feature is only available on RINGNECK SOM-PX30-uQ7 module with an STM32, see (Section 12.4.4 Companion Controller 1). 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. -
Page 22: Misc Connector
Fig. 3.18: MISC header 3.20 JTAG Connector The board provides UPDI signals on the JTAG connector. The RINGNECK SOM-PX30-uQ7 does not support JTAG, but the ATtiny (see Section 12.4.5 Companion Controller 2) can be flashed over JTAG connector pins. Fig. 3.19: JTAG header... -
Page 23: Software Overview
The second option is to cross-compile your applications on a host PC. The compiler that was installed in Section 5.1 Prepare the host PC is suitable. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH... -
Page 24: Debian Image Guide
This chapter will go through all neccessary steps, finally building a complete image using the debos Debian image builder. The result will be a fully-functional Debian system. Alternatively, prebuilt images can be downloaded from https://downloads.embedded.cherry.de/ringneck/. At the time of writing this document, the following Debian image variants are available for the Ringneck board: •... -
Page 25: Compile U-Boot
Get the source code and compile the Linux kernel as follows: # Set up cross-compilation export ARCH=arm64 export CROSS_COMPILE=aarch64-linux-gnu- # Download the source code git clone https://git.embedded.cherry.de/ringneck-linux.git ringneck-linux # Compile make ringneck-px30_defconfig make -j$(nproc) (continues on next page) RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 21... -
Page 26: Building The Debos Image
5.3 Compile U-Boot and Section 5.4 Compile the Linux kernel, respectively. Get the source code for the debos recipe and copy necessary components built in previous steps: # Download the source code git clone https://git.embedded.cherry.de/debos-recipes.git debos-recipes # Copy Linux & U-Boot binaries into the ``ringneck`` folder cp $RINGNECK_LINUX_DIR/arch/arm64/boot/Image ringneck/overlay/boot/ cp $RINGNECK_LINUX_DIR/arch/arm64/boot/dts/rockchip/px30-ringneck*.dtb ringneck/overlay/boot... - Page 27 More details about the Phosh graphical shell can be found in the Phosh graphical shell section. # Build the image build_board=ringneck debos_variant=bookworm-phosh ./build.sh # Make the resulting image available to later steps export SDCARD_IMG=$PWD/sdcard-ringneck-debos-bookworm-phosh.img RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 23...
-
Page 28: Building A Yocto Image
6.2 BSP meta layer The Yocto Project BSP meta layer can be found at https://git.embedded.cherry.de/yocto-layers/ meta-theobroma-systems-bsp.git/. It contains the minimal configuration and recipe append files (bbappend) necessary to build a minimal working image. - Page 29 6.2.1 Initial setup Clone the BSP meta layer and its dependencies from a new directory called yocto: mkdir yocto yocto git clone https://git.embedded.cherry.de/yocto-layers/meta-theobroma-systems-bsp.git -b kirkstone git clone https://git.yoctoproject.org/poky -b kirkstone-4.0.10 git clone https://git.yoctoproject.org/meta-arm -b yocto-4.0.2 git clone https://git.yoctoproject.org/meta-rockchip -b kirkstone git clone https://git.openembedded.org/meta-openembedded -b kirkstone...
- Page 30 bitbake-layers add-layer ../meta-arm/meta-arm-toolchain bitbake-layers add-layer ../meta-arm/meta-arm bitbake-layers add-layer ../meta-rockchip bitbake-layers add-layer ../meta-openembedded/meta-oe bitbake-layers add-layer ../meta-openembedded/meta-python bitbake-layers add-layer ../meta-theobroma-systems-bsp 6.2.3 Building a minimal image To build a bootable artifact, BitBake will be called with the specified machine and target image: MACHINE="ringneck-haikou" bitbake core-image-minimal Note: Technically speaking, the MACHINE variable could be set in build/conf/local.conf file once and for all.
-
Page 31: Extended Meta Layer
KAS_IMAGE_VERSION="4.0" KAS_MACHINE="ringneck-haikou" kas-container build meta-theobroma-systems-bsp/ kas-theobroma.yml 6.3 Extended meta layer The Yocto Project extended layer can be found at https://git.embedded.cherry.de/yocto-layers/ meta-theobroma-systems-extended.git/. In addition to the minimal features, this layer includes the network manager, and many more features will be added soon. - Page 32 6.3.2 Initializing build environment Once the layers have been properly cloned in their appropriate branch, the build environment needs to be initialized. This can be done by running the following command: source poky/oe-init-build-env build This will initialize the build environment by making the bitbake build tool available in the current shell and creating a build directory where temporary and final build artifacts will be stored.
- Page 33 The Section 6.3.1 Initial setup and Section 6.3.2 Initializing build environment can then be replaced by the fol- lowing two commands: mkdir yocto yocto git clone https://git.embedded.cherry.de/yocto-layers/meta-theobroma-systems-extended.git -b kirkstone kas checkout meta-theobroma-systems-extended/kas-theobroma.yml The Section 6.3.3 Building an image can now be replaced with: KAS_MACHINE="ringneck-haikou"...
-
Page 34: 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 SDCARD_IMG 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 35 $RKDEVELOPTOOL_DIR sudo ./rkdeveloptool db tools/rk_tools/px30_loader_v*.bin && sleep 1 sudo ./rkdeveloptool wl 0 $SDCARD_IMG sudo ./rkdeveloptool rd This step should take about 1 minute for the Debian image. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 31...
-
Page 36: Wifi
8 Wifi The RINGNECK SOM-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 Antenna The development kit includes an antenna compatible with the Wifi module. Other antennas can be used. The connector on the antenna must be one of: •... - Page 37 Note: On Debian, the esptool package provided by the package feed is too old. Instead, please install esptool software from pip: apt-get -y install python3-pip pip3 install --user esptool Note: By default, esptool is not available in our Yocto core-image-minimal image. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 33...
-
Page 38: Serial Number & Mac Address
9 Serial Number & MAC Address 9.1 Serial Number Each RINGNECK SOM-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 serial#. You can print it using the... -
Page 39: Mule Companion Controller
3. The microcontroller will appear as a new USB device in Linux (vid:pid as 0483:df11) To return to normal operation, BOOT0 must be pulled low again to not enter DFU mode in the next power-cycle. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 ©... -
Page 40: Companion Controller 2 (Attiny)
SoC resets microcontroller into DFU mode and then uploads the firmware binary to internal STM32 flash memory. The tool is available here: https://git.embedded.cherry.de/som-tools.git/tree/mule. To flash STM32 microcontroller using mule.sh, please follow the steps below. 1. Install mule.sh dependencies according to README.md 2. - Page 41 SoC resets microcontroller into flashloader mode and then transfers the binary that will be committed to flash. Tools are available here: https://git.embedded.cherry.de/som-tools.git/tree/mule-attiny. To flash ATtiny microcontroller, please follow the steps below. 1. Setup tool dependencies according to README.md 2.
-
Page 42: Phosh Graphical Shell
11 Phosh graphical shell Phosh is a graphical user interface designed for touch-based devices. It is based on the GTK widget toolkit, and derives from the GNOME Shell as a mobile-specific fork. Phosh is used as a default graphical user interface in the reference images for the Haikou-Video-Demo. -
Page 43: Known Issues
To restore the application to a usable state, open another tab using the terminal: gnome-control-center power 3. No battery icon is visible in the top right corner. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 39... -
Page 44: Hardware Guide
Thermal control FAN control Note: The RINGNECK SOM-PX30-uQ7 module is available in different variants. This document describes the maximum configuration. For details about orderable variants please refer to the order-code document. Note: Not all interfaces are available at the same time as they might conflict with others. E.g. it is not possible to have LVDS channels and MIPI-DSI at the same time. -
Page 45: Q7 Connector Pinout
12.2 Q7 Connector Pinout The following table shows the signals on the edge connector of the RINGNECK SOM-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#... - Page 46 Table 12.1 – continued from previous page Signal Signal 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 UART0_CTS# GPIO0...
-
Page 47: Signal Details
SDIO Write Protect SDIO_PWR# 3.3V SDIO Power Enable. This signal is used to enable the power being supplied to a SD/MMC card device SDIO_DAT0-4 3.3V SDIO Data lines RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 43... - Page 48 12.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, /GP2_I2C_CLK Attiny and Video connector LVDS_DID_DAT 3.3V I2C bus data line connected to PX30, Secure Element, STM32,...
- Page 49 Master serial input/Slave serial output signal SPI_SCK 3.3V SPI clock output SPI_CS0# 3.3V SPI chip select 0 output SPI_CS1# 3.3V SPI chip select 1 output (used when two devices are connected) RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 45...
- Page 50 12.3.10 UART UART0, as specified in the Q7 standard, is implemented including hardware flow control. This UART shows up in Linux as /dev/ttyS0. Q7 Signal Type Signal Description Level UART0_TX 3.3V Serial data transmit UART0_RX 3.3V Serial data receive UART0_CTS# 3.3V Handshake signal: ready to send data UART0_RTS#...
-
Page 51: On-Board Devices
Feature CPU Connection Emulated IC Qseven Pins ISL1208 none Temperature sensor and fan controller AMC6821 FAN_TACHOIN, FAN_PWMOUT UCAN CAN0_TX, CAN0_RX See also Section 10.1 Companion Controller 1 (STM32). RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 47... -
Page 52: Wifi And Bluetooth Module
Fig. 12.1: WiFi and Bluetooth module The WiFi and Bluetooth are part of the ESP32 PICO MINI 02U module on the RINGNECK SOM-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 53 ESP32 signal CPU Pin Linux GPIO # WiFi_RST GPIO2_B0 WiFi_BOOT GPIO0_A1 12.5.1 Test points RINGNECK SOM-PX30-uQ7 v1.2 Test point Connected to VCC_3V3 VDD_LOG VDD_ARM VCC_DDR VCC_3V0_1V8 VCC_1V8 VCC_1V0 VCCIO_SD TP10 VCC_LCD TP11 1V8_LCD TP12 VCCA_1V8 TP13 VCC_eMMC TP14 PMIC_INT TP15...
-
Page 54: Usb
12.6 USB The RINGNECK SOM-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 #... -
Page 55: Using Qseven Signals As Gpio
Bidirectional GPIO4 GPIO3_C0 Bidirectional GPIO5 GPIO3_A2 Bidirectional GPIO6 GPIO3_A1 Bidirectional GPIO7 GPIO2_B6 Bidirectional SPI_MOSI GPIO3_B4 Bidirectional SPI_CS0# GPIO3_B1 Bidirectional SPI_MISO GPIO3_B6 Bidirectional SPI_CS1# GPIO3_B2 Bidirectional SPI_SCK GPIO3_B7 Bidirectional RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 51... -
Page 56: Electrical Specification
12.8 Electrical Specification 12.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 v1.3.1 Page 52... -
Page 57: Mechanical Specification
12.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. RINGNECK SOM-PX30-uQ7 User Manual v1.3.1 © Cherry Embedded Solutions GmbH Page 53... -
Page 58: Revision History
Rename files for consistency between products Replace dd flashing instructions with bmaptool Update pip instructions for Bookworm Add yocto directory creation Update kas container instructions Rephrase layer version requirement Bump yocto layer and kas versions Switch to Cherry Corporate Identity v1.3.1 Page 54...