HARDWARE
User’s Hardware Manual_V1.5
Copyright
Revision History
Overview
1. RK3588 Description
2. FET3588-C SoM Description
2.1 FET3588-C SoM
2.2 FET3588-C SoM Dimension Diagram
2.3 Performance Parameters
2.3.1 System Main Frequency
2.3.2 Power Parameter
2.3.3 Operating Environment
2.3.4 SoM Interface Speed
2.3.5 ESD Features
2.4 SoM Interface Speed
2.5 FET3588-C SoM Pins Definition
2.5.1 FET3588-C SoM Pins Schematic
2.5.2 FET3588-C SoM Pins Description
2.6 SoM Hardware Design Description
2.6.1 SoM Circuit Design Guide
2.6.2 Design Guide for Vibration Resistance of the SoM
3. OK3588-C Development Platform Description
3.1 OK3588-C Development Board Interface Diagram
3.2 OK3588-C SoM Dimension Diagram
3.3 Carrier Board Naming Rules
3.4 Carrier Board Resources
3.5 OK3588-C Carrier Board Description
3.5.1 Carrier Board Power
3.5.2 Reset and Startup/Shutdown Signal
3.5.3 Boot Configuration
3.5.4 System Initialization Configuration Signal
3.5.5 JTAG & UART Debug Circuit
3.5.6 IIC Extending IO
3.5.7 SARADC
3.5.8 FAN Interface
3.5.9 TF Card
3.5.10 RTC Circuit
3.5.11 Ethernet Circuit
3.5.12 RS485 Interface
3.5.13 Audio
3.5.14 4G&5G Interface
3.5.15 USB2.0/USB3.0 Circuit
3.5.16 SATA3.0 Circuit
3.5.17 PCIe2.0 and PCIe3.0 Circuit
3.5.18 Video Input Interface
3.5.19 Video Output Interface
4. Connector Dimension Diagram
5. OK3588-C Development Board Power Consumption Table
6. Minimum System Schematic
SOFTWARE
Yocto5.0_Kernel-6.1_User’s Manual_V1.0
Copyright
Open Box
1. Overview
1.1 Application Scope
1.2 Revision History
1.3 OK3588-C Description
1.4 Main Frequency Setting Description
1.5 Rockchip Documentation
1.6 Overview
2. Packing List
3. Quick Start
3.1 Interface resources
3.2 Debug Methods
Upgrade Firmware
1. Introduction
2. Obtaining the Image
3. Image Flashing
3.1 Flashing via OTG (Windows)
3.2 Flashing Firmware via TF Card
OS Development
1. Yocto Introduction
1.1 Yocto Project Overview
1.2 Core Components
1.3 OK3588 BSP Layer for Yocto Project
2. Download Yocto Source Code
2.1 Configuring GitHub Authentication
2.2 Repo Tool Installation
2.3 Fetching Source Code Using repo
2.4 Pre-downloaded Software Packages
2.5 Utility Tools
3. Step-by-Step Guide to Building Yocto
3.1 Host Setup
3.2 Compilation
3.3 Compiling Application
Application Development
Peripheral Access
1. ADC
2. Frequency
3. GPIO
4. PWM
5. UART
6. I2C
7. RTC
8. Watchdog
9. MMC
10. SD Card
11. USB2.0
12. Type-C
13. PCIe
14. Ethernet
15. WiFi & Bluetooth
16. 4G/5G
17. System Suspend
Multimedia
1. Audio
2. Camera
3. Display
4.Encoding and Decoding
SQLite3
Development Guides
1. Adding User Application
1.1 Packaging the User Program into the Image
2. Auto-starting the User Program
3. Customized Logo
4. RKNPU Development
4.1 NPU Description
4.2 Development Environment Setup
4.3 Model Deployment Examples
4.4 RKNN Toolkit2 Supported Operator List
Resource Download & Technical Support
1. Accessing Resources
2. After-Sales & Technical Support
Buildroot_Kernel-6.1_User’s Manual_V1.0
Copyright
Open Box
1. Overview
1.1 Application Scope
1.2 Revision History
1.3 OK3588-C Description
1.4 Main Frequency Settings Description
1.5 Overview
2. Packing List
3. Quick Start
3.1 Interfaces
3.2 Debug
Upgrade Firmware
1. Introduction
2. Obtaining the Image
3. Firmware Flashing
3.1 Flashing via OTG (Windows)
3.2 Flashing Firmware via TF Card
OS Development
1. Downloading SDK Source Code
1.1 Repo Tool Installation
1.2 Fetching Source Code Using Repo
1.3 Configuring GitHub Authentication
1.4 Pre-downloaded Software Packages
1.5 Utility Tools
2. Configuring SDK
2.1 SDK Structure
2.2 SDK Configuration
2.3 Partitions
3. Building SDK Images
3.1 Preparation
3.2 Compilation
3.3 Compiling Application
Application Development
Peripheral Access
4G/5G
ADC
Ethernet
Frequency
GPIO
I2C
MMC
PCle
PWM
RTC
SD Card
System Suspend
Type-C
UART
USB2.0
Wifi_Bluetooth
Watchdog
Database
SQLite3
Multimedia
Audio
Camera
Display
Encoding and Decoding
Machine Learning
1. Introduction
2. Device Tree
3. Application
Development Guides
1. Adding User Application
1.1 Packaging the User Program into the Image
2. Auto-starting the User Program
3. Customized Logo
4. RKNPU Development
4.1 NPU Description
4.2 Development Environment Setup
4.3 Model Deployment Examples
4.4 RKNN Toolkit2 Supported Operator List
Resource Download & Technical Support
1. Accessing Resources
2. After-Sales & Technical Support
Linux5.10.209_User’s Manual_V1.0
Copyright
Application Scope
Revision History
Overview
1. OK3588 Development Board Description
1.1 OK3588 Development Board Description
1.2 CPU/GPU/NPU Frequency Description
1.3 Introduction to Linux 5.10.209 System Software Resources
1.4 EMMC Memory Partition Table
2. Fast Startup
2.1 Preparation Before Startup
2.2 Debugging Serial Driver Installation
2.3 Serial Login
2.3.1 Serial Port Connection Settings
2.3.2 Serial Login Common Problems
2.4 Network Login Methods
2.4.1 Network Connection Test
2.4.2 SSH Server
2.4.3 SFTP
2.5 Screen Switching
2.5.1 Dynamic Control of Uboot Menu
2.5.2 Kernel Device Tree Specification
2.6 System Shutdown
3. Desktop Function Test
3.1 Introduction to Interface Function
3.2 Hardware Decoding
3.3 OpenGL Test
3.4 Music Play Test
3.5 4G/5G Test
3.6 WiFi Test
3.7 Network Configuration Test
3.8 Ping Test
3.9 Browser Test
3.10 Watchdog Test
3.11 Key Test
3.12 RTC Test
3.13 Same & Different Display
3.14 UART Test
3.15 Database Test
3.16 Backlight Test
3.17 Uboot Menu
3.18 Web Services
3.19 Abnormal Touch
3.20 TFTP Upgrading System
3.21 CPU Frequency Configuration Test
4. Command Line Function Test
4.1 System Information Queries
4.2 Frequency Test
4.3 Temperature Test
4.4 DDR Test
4.5 Watchdog Test
4.6 RTC Function Test
4.7 Key Test
4.8 UART Test
4.9 ADC Test
4.10 TF Card Test
4.11 EMMC Test
4.12 USB Mouse Test
4.13 USB2.0
4.14 TYPE-C Test
4.15 Ethernet Configuration
4.16 WiFi Test
4.17 Bluetooth Test
4.18 4G/5G
4.19 Playing/Recording Test
3.2.19.1 Playing Sound via HDMI
3.2.19.2 Playing Sound via SPKOUT
3.2.19.3 MIC Input
4.20 LCD Backlight Adjustment
4.21 Sleep & Wake-up Test
4.22 PCIE Test
4.23 RKNPU Test
4.24 SQLite3 Test
4.25 GPIO Test
4.26 Adding Boot-up Scripts
5. OK3588 Platform Multimedia Test
5.1 Audio and Video Playback
5.1.1 Playing Audio and Video With Gst-play
5.1.2 Playing Video With Gst-launch
5.1.3 Playing Audio With Gst-launch
5.1.4 Playing Video and Audio With Gst-launch
5.2 Video Hardware Encoding
5.2.1 Video Hardware Encoding H.264
5.2.2 Video Hardware Encoding H.265
5.2.3 JPEG Hardware Encoding
5.3 Video Hardware Decoding
5.3.1 Decoding and Playing H.264 Format Video
5.3.2 Decoding and Playing H264 Format Video With Audio
5.3.3 Decoding and Playing H265 Format Video
5.3.4 Decoding and Playing H265 Format Video With Audio
5.3.5 Decoding and Playing VP9 Format Video
5.3.6 Decoding and Playing VP9 Format Video With Audio
5.3.7 Decoding and Playing VP8 Format Video
5.3.8 Decoding and Playing VP8 Format Video With Audio
5.4 Camera Test
5.4.1 UVC Camera Test
5.4.2 OV13855 Test
5.4.3 OV5645 Test
5.4.4 HDMI IN Test
6. System Flashing
6.1 OTG Flashing System
6.1.1 OTG Driver Installation
6.1.2 OTG Full Flashing Test
6.2 TF Card Flashing
Linux5.10.209_User’s Compilation Manual_V1.0
Copyright Notice
Application Scope
Revision History
Overview
1. VMware Virtual Machine Installation
1.1 VMware Software Downloads and Purchase
1.2 VMware Software Installation
2. Ubuntu Development Environment Loading
3. New Ubuntu Development Environment Setup
3.1 Ubuntu System Setup
3.1.1 Creating an Ubuntu Virtual Machine
3.1.2 System Installation
3.1.3 Ubuntu Basic Configuration
3.1.4 Network Settings for Virtual Machine
3.2 Libraries for Installing Linux Compilation System
3.3 Cross-compilation Chain Installation
3.4 Qt Creator Installation
4. Related Code Compilation
4.1 Preparation Before Compilation
4.1.1 Environment Description
4.1.2 Source Code Copy
4.2 Source Code Compilation
4.2.1 Full Compilation Test
4.2.2 Separate Compilation
4.2.3 Clearing Compilation File
4.3 Image File Use
4.4 Qt Creator Environment Configuration
4.4.1 Cross Compiler Configuration
4.4.2 Qt Versions Configuration
4.4.3 Kits Configuration
4.5 Application Compilation and Operation
4.5.1 Command Line Application Compilation and Operation
4.5.2 QT Application Compilation and Operation
Forlinx Desktop22.04_User’s Manual_V1.1
Copyright Notice
Application Scope
Revision History
Overview
1. OK3588 Development Board Description
1.1 OK3588 Development Board Brief
1.2 CPU/GPU/NPU Frequency Description
1.3 Introduction to Linux 5.10.160 System Software Resources
1.4 EMMC Memory Partition Table
2. Fast Startup
2.1 Preparation Before Startup
2.2 Debugging Serial Driver Installation
2.3 Serial Login
2.3.1 Serial Port Connection Settings
2.3.2 Serial Login Common Problems
2.4 Network Login Methods
2.4.1 Network Connection Test
2.4.2 SSH Server
2.4.3 SFTP
2.5 Screen Switching
2.5.1 Uboot Menu Dynamic Control o
2.5.2 Kernel Device Tree Specification
2.6 System Shutdown
3. OK527 Platform Interface Function Use and Test
3.1 Desktop Function Test
3.1.1 Virtual Keyboard Test
3.1.2 Audio and Video Playback
3.1.3 Network Configuration Test
3.1.4 Multi-screen Mirror and Joint Displays
3.1.5 WiFi Test
3.1.6 Bluetooth Test
3.2 QT Test
3.2.1 4G/5G Test
3.2.2 UART Test
3.2.3 Database Test
3.2.4 OpenGL Test
3.2.5 RTC Test
3.2.6 Key Test
3.2.7 Watchdog Test
3.2.8 Backlight Test
4. OK3576 Command Line Tool Application and Test
4.1 System Information Queries
4.2 Frequency Test
4.3 Temperature Test
4.4 DDR Test
4.5 Watchdog Test
4.6 RTC Function Test
4.7 Key Test
4.8 UART Test
4.9 ADC Test
4.10 TF Test
4.11 EMMC Test
4.12 USB Mouse Test
4.13 USB2.0
4.14 Type-C Test
4.15 Ethernet Configuration
4.16 WiFi Test
4.16.1 STA Mode
4.16.2 AP Mode
4.17 Bluetooth Test
4.18 4G/5G
4.19 Play/Record Test
4.19.1 HDMI Playback Sound
4.19.2 SPKOUT Playback Sound
4.19.3 MIC Input
4.20 LCD Backlight Adjustment
4.21 ON/OFF Test
4.22 PCIE Test
4.23 RKNPU Test
5. OK3588 Platform Multimedia Test
5.1 Audio and Video Playback
5.1.1 Playing Audio and Video With Gst-play
5.1.2 Playing Video With Gst-launch
5.2 Video Hardware Encoding
5.2.1 Video Hardware Encoding H.264
5.2.2 Video Hardware Encoding H.265
5.2.3 JPEG Hardware Encoding
5.3 Video Hardware Decoding
5.3.1 Decoding and Playing H264 Format Video
5.3.2 Decoding and Playing H265 Format Video
5.3.3 Decoding and Playing VP9 Format Video
5.4 Camera Test
5.4.1 UVC Camera Test
5.4.2 OV13855 Test
5.4.3 OV5645 Test
5.5 HDMI RX Test
6. System Flashing
6.1 OTG System Flashing
6.1.1 OTG Driver Installation
6.1.2 OTG Flashing Test
6.2 TF Card Flashing
Forlinx Desktop22.04_User’s Compilation Manual_V1.0
Copyright Notice
Application Scope
Revision History
Overview
1. VMware Virtual Machine Software Installation
1.1 VMware Software Downloads and Purchase
1.2 VMware Software Installation
2. Loading the Existing Ubuntu Development Environment
3. New Ubuntu Development Environment Setup
3.1 Ubuntu System Setting up
3.1.1 Ubuntu Virtual Machine Setup
3.1.2 System Installation
3.1.3 Ubuntu Basic Configuration
3.1.4 Network Settings for Virtual Machines
3.2 Libraries for Installing Linux Compilation System
3.3 Qt Creator Installation
4. Related Code Compilation
4.1 Preparation Before Compilation
4.1.1 Description of the Environment
4.1.2 Source Code Copy
4.2 Source Code Compilation
4.2.1 Full Compilation Test
4.2.2 Separate Compilation
4.2.3 Clearing Compilation File
4.3 Image File Use
4.4 Application Compilation and Operation
4.4.1 Command Line Application Compilation and Operation
Android14.0_User’s Manual_V1.0
Copyright Notice
Application Scope
Revision History
Overview
1. OK3588 Development Board Description
1.1 CPU/GPU/NPU Frequency Description
1.2 Android14.0 System Software Resources Features
1.3 EMMC Memory Partition Table
2. Fast Startup
2.1 Preparation Before Startup
2.2 Debugging Serial Driver Installation
2.3 Serial Port Login
2.3.1 Serial Port Connection Settings
2.3.2 Serial Login
2.4 Screen Switching
2.4.1 Dynamic Control of Uboot Menu
2.4.2 Kernel Device Tree Specification
2.5 System Shutdown
3. Android Function Use and Test
3.1 Main Interface Display
3.2 Application
3.3 Language Settings
3.4 Picture and Audio View
3.5 Multimedia Test
3.6 Recording (Supports Mic Input)
3.7 Volume Adjustment
3.8 Display Settings
3.9 Time Settings（RTC）
3.10 Ethernet Test
3.11 WiFi Internet
3.12 WiFi Hotspot Test
3.13 4G/5G Module Test
3.14 Bluetooth Test
3.15 Key Test (Sleep Wake-up)
3.16 TF Card and USB Storage Test
3.17 USB Mouse Test
3.18 USB OTG Interface Test
3.19 Serial Port Test
3.20 Watchdog Test
3.21 Camera Test
3.21.1 UVC Camera Test
3.21.2 OV13855 Camera Test
3.22 HDMI Resolution Settings Test
3.23 Factory Reset
3.24 APK Installation With TF Card
3.25 WiFi ADB Test
3.26 Navigation and Status Bar Settings
3.27 Artificial Intelligence Test
3.28 Screen Lock Test
3.29 NPU Test
3.30 HDMI Test
3.30.1 Serial Port Demo
3.30.2 SPI Demo
3.30.3 I2C Demo
3.30.4 GPIO Demo
3.30.5 Watchdog Demo
3.30.6 ADC Demo
4. System Flashing
4.1 OTG System Flashing
4.1.1 OTG Driver Installation
4.1.2 OTG Flashing Test
4.2 TF Card Flashing
5. System OTA upgrade Test
5.1 OTA Upgrade Package Compilation
5.2 OTA Local Upgrade
5.3 OTA Network Upgrade
6. Multi-display with Independent Touch Control
6.1 Primary and Secondary Screens Settings
6.2 Binding between Display and VOP Settings
6.3 Binding between Display and Touch (Input) Devices
6.4 DPI Custom Settings
6.5 APP Display on Different Screens
7. Root Permission Management
7.1 Shell Permission Control
7.2 ADB Permission Control
7.3 APP Permission Control
Android14.0_User’s Compilation Manual_V1.0
Copyright Notice
Application Scope
Revision History
Overview
1. VMware Virtual Machine Software Installation
1.1 VMware Software Downloads and Purchase
1.2 VMware Software Installation
2. Loading the Existing Ubuntu Development Environment
3. New Ubuntu Development Environment Setup
3.1 Ubuntu System Setup
3.1.1 Ubuntu Virtual Machine Setup
3.1.2 System Installation
3.1.3 Ubuntu Basic Configuration
3.1.4 Virtual Machine Network Settings
3.2 Installation of the Necessary Libraries for Android Compilation
4. Android System Compilation
4.1 Software Configuration File Path
4.2 Android System Compilation
4.2.1 Preparation Before Compilation
4.2.2 Source Code Copy and Release
4.2.3 Android System Compilation
5. Android Application Development
5.1 Setting up the Android Application Development Environment
5.1.1 JDK（Java SE Development Kit）Download and Installation
5.1.2 Android Studio Installation
5.1.3 Helloworld Project Creation
5.2 Apk Platform Signature
5.3 Pre - installation Method of APK in System
Android 12.0_User’s Manual_V 1.3
Copyright Notice
Application Scope
Revision History
Overview
1. OK3588 Development Board Description
1.2 CPU/GPU/NPU Frequency Description
1.3 Android12 System Software Resources Features
1.4 EMMC Memory Partition Table
2. Fast Startup
2.1 Preparation Before Startup
2.2 Debugging Serial Driver Installation
2.3 Serial Port Login
2.3.1 Serial Port Connection Settings
2.3.2 Serial Login
2.4 Screen Switching
2.4.1 Uboot Menu Dynamic Control
2.4.2 Kernel Device Tree Specification
2.5 System Shutdown
3. Android Function Use and Test
3.1 Main Interface Display
3.2 Application
3.3 Language Settings
3.4 Picture and Audio View
3.5 Multimedia Test
3.6 Recording (Supports Mic Input)
3.7 Volume Adjustment
3.8 Display Settings
3.9 Time Setting（RTC）
3.10 Ethernet Test
3.11 WiFi Internet
3.12 WiFi Hotspot Test
3.13 4G/5G Module Test
3.14 Bluetooth Test
3.15 Key Test (Sleep Wake-up)
3.16 TF Card and USB Storage Test
3.17 USB Mouse Test
3.18 USB OTG Interface Test
3.19 Serial Port Test
3.20 Watchdog Test
3.21 Camera Test
3.21.1 UVC Camera Test
3.21.2 OV13850 Camera Test
3.22 HDMI Resolution Setting Test
3.23 Factory Reset
3.24 APK Installation with TF Card
3.25 WiFi ADB Test
3.26 ROOT Permission Test
3.27 Navigation Bar and Dropdown Bar Settings
3.28 DisplayHwConfig Test
3.29 Artificial Intelligence Test
3.30 Locking Screen Test
3.31 NPU Test
3.32 Hdmi rx Test
3.33 Forlinx-SDK Test
3.33.1 SERIAL PORT DEMO
3.33.2 SPI DEMO
3.33.3 I2C DEMO
3.33.4 GPIO DEMO
3.33.5 WATCHDOG DEMO
3.33.6 ADC DEMO
3.33.7 CAN DEMO
4. System Flashing
4.1 OTG System Flashing
4.1.1 OTG Driver Installation
4.1.2 OTG Flashing Test
4.2 TF Card Flashing
5. System OTA Upgrade Test
5.1 OTA Upgrade Package Compilation
5.2 OTA Local Upgrade
5.3 OTA Network Upgrade
Android 12.0_User’s Compilation Manual_V 1.0
Copyright Notice
Application Scope
Revision History
Overview
1. VMware Virtual Machine Software Installation
1.1 VMware Software Downloads and Purchase
1.2 VMware Software Installation
2. Loading the Existing Ubuntu Development Environment
3. New Ubuntu Development Environment Setup
3.1 Ubuntu System Setup
3.1.1 Ubuntu Virtual Machine Setup
3.1.2 System Installation
3.1.3 Ubuntu Basic Configuration
3.1.4 Network Settings for Virtual Machines
3.2 Installation of the Library Needed to Compile Android
4. Android System Compilation
4.1 Software Configuration File Path
4.2 System Compilation
4.2.1 Preparation Before Compilation
4.2.2 Source Code Copy and Release
4.2.3 Android System Compilation
5. Android Application Development
5.1 Android Application Development Environment Setup
5.1.1 JDK（Java SE Development Kit）Download and Installation
5.1.2 Android Studio Installation
5.1.3 Helloworld Project Creation
5.2 Apk Platform Signature
5.3 Pre - installation Method of APK in System
5.4 Method for App to Obtain Root Permission
APPLICATION NOTE
RK Development Manual
Forlinx Embedded RK3588 Documentation
Index
Index