Användarhandbok för Raspberry Pi Compute Module 4
Kolofon
© 2022-2025 Raspberry Pi Ltd
This documentation is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND)
| Släppa | 1 |
| Bygga datum | 22/07/2025 |
| Bygga version | 0afd6ea17b8b |
Juridisk friskrivningsklausul
TECHNICAL AND RELIABILITY DATA FOR RASPBERRY PI PRODUCTS (INCLUDING DATASHEETS) AS MODIFIED FROM TIME TO TIME (“RESOURCES”) ARE PROVIDED BY RASPBERRY PI LTD (“RPL”) “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN NO EVENT SHALL RPL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA, OR PROFITS, OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE RESOURCES, EVEN IF ADVISED OF THE POSSI BILITY OF SUCH DAMAGE.
RPL reserves the right to make any enhancements, improvements, corections or any other modifications to the RESOURCES or any products described in them at any time and without further notice
De RESURSER are intended for skilled users with suitable levels of design knowledge. Users are solely responsible for their selection and use of the RESOURCES and any application of the products described in them. User agrees to indemnify and hold RPL harmless against all liabilities, costs, damages or other losses arising out of their use of the RESOURCES
RPL ger användarna tillåtelse att använda RESURSER enbart i samband med Raspberry Pi-produkterna. All annan användning av RESURSERNA är förbjuden. Ingen licens ges till någon annan RPL eller annan immateriell rättighet från tredje part.
HÖG RISKAKTIVITETER. Raspberry Pi products are not designed, manufactured or intended for use in hazardous environments requiring fail safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, weapons systems or safety-critical applications (including life support systems and other medical devices), in which the failure of the products could lead directly to death, personal injury or severe physical or environmental damage (“High Risk Activities). RPL specifically disclaims any express or implied warranty of fitness for High Risk Activities and accepts no liability for use or inclusions of Raspberry Pi products in High Risk Activities
Raspberry Pi products are provided subject to RPLs Standard Terms. RPLs provision of the RESOURCES does not expand or otherwise modify RPL’s Standard Terms including but not limited to the disclaimers and warranties expressed in them.
Dokumentversionshistorik
| Släppa | Datum | Beskrivning |
| 1 | Mar 2025 | Initial release. This document is heavily based on the ‘Raspberry Pi Compute Module 5 forward guidance’ whitepaper. |
Dokumentets omfattning
Detta dokument gäller för följande Raspberry Pi-produkter:
| Pi 0 | Pi 1 | Pi 2 | Pi 3 | Pi 4 | Pi 400 | Pi 5 | Pi 500 | CM1 | CM3 | CM4 | CM5 | Pico | Pico2 | ||||
| 0 | W | H | A | B | A | B | B | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla |
Introduktion
Raspberry Pi Compute Module 5 fortsätter Raspberry Pi-traditionen att ta den senaste flaggskeppsdatorn Raspberry Pi och producera en liten, hårdvaruekvivalent produkt lämplig för inbyggda applikationer. Raspberry Pi Compute Module 5 har samma kompakta formfaktor som Raspberry Pi Compute Module 4 men ger högre prestanda och en förbättrad uppsättning funktioner. Det finns naturligtvis vissa skillnader mellan Raspberry Pi Compute Module 4 och Raspberry Pi Compute Module 5, och dessa beskrivs i det här dokumentet.
NOTERA
For the few customers who are unable to use Raspberry Pi Compute Module 5, Raspberry Pi Compute Module 4 will stay in production until at least 2034.
The Raspberry Pi Compute Module 5 datasheet should be read in conjunction with this whitepaper.
https://datasheets.raspberrypi.com/cm5/cm5-datasheet.pdf
Huvuddrag
Raspberry Pi Compute Module 5 has the following features:
- Quad-core 64-bit Arm Cortex-A76 (Armv8) SoC clocked @ 2.4GHz
- 2GB, 4GB, 8GB, or 16GB LPDDR4 SDRAM
- On-board eMMC flash memory, OGB (Lite model), 16GB, 32GB, or 64GB options
- 2x USB 3.0-portar
- 1 Gb Ethernet interface
- 2x 4-lane MIPI ports supporting both DSI and CSI-2
- 2x HDMI ports able to support 4Kp60 simultaneously
- 28x GPIO pins
- On-board test points to simplify production programming
- Internal EEPROM on the bottom to improve security
- On-board RTC (external battery via 100-pin connectors)
- On-board fan controller
- On-board Wi-Fi®/Bluetooth (depending on SKU)
- 1-lane PCIe 2.0′
- Type-C PD PSU support
NOTERA
Not all SDRAM/eMMC configurations are available. Please check with our sales team.
In some applications PCIe Gen 3.0 is possible, but this is not officially supported.
Kompatibilitet med Raspberry Pi Compute Module 4
For most customers, Raspberry Pi Compute Module 5 will be pin-compatible with Raspberry Pi Compute Module 4.
The following features have been removed/altered between the Raspberry Pi Compute Module 5 and Raspberry Pi Compute Module 4 models:
- Kompositvideo
- The composite output available on Raspberry Pi 5 is NOT routed out on Raspberry Pi Compute Module 5
- 2-lane DSI port
- There are two 4-lane DSI ports available on Raspberry Pi Compute Module 5, muxed with the CSI ports for a total of two
- 2-lane CSI port
- There are two 4-lane CSI ports available on Raspberry Pi Compute Module 5, muxed with the DSI ports for a total of two
- 2x ADC inputs
Minne
Raspberry Pi Compute Module 4’s maximum memory capacity is 8GB, whereas Raspberry Pi Compute Module 5 is available in a 16GB RAM variant.
Unlike Raspberry Pi Compute Module 4, Raspberry Pi Compute Module 5 is NOT available in a 1GB RAM variant.
Analogt ljud
Analogue audio can be muxed onto GPIO pins 12 and 13 on Raspberry Pi Compute Module 5, in the same way as on Raspberry Pi Compute Module 4.
Use the following device tree overlay to assign analogue audio to these pins:
Due to an errata on the RP1 chip, GPIO pins 18 and 19, which could be used for analogue audio on Raspberry Pi Compute Module
4, are not connected to the analogue audio hardware on Raspberry Pi Compute Module 5 and cannot be used.
NOTERA
The output is a bitstream rather than a genuine analogue signal. Smoothing capacitors and an ampEn förstärkare kommer att behövas på IO-kortet för att driva en linjenivåutgång.
Ändringar av USB-start
USB booting from a flash drive is only supported via the USB 3.0 ports on pins 134/136 and 163/165
Raspberry Pi Compute Module 5 does NOT support USB host boot on the USB-C port
Unlike the BCM2711 processor, the BCM2712 does not have an XHCI controller on the USB-C interface, just a DWC2 controller on pins 103/105. Booting using 1800t is done via these pins.
Växla till modulersättning och avstängningsläge
1/0 pin 92 is now set to w Button rather than sus PG this means you need to use a PMIC EN to reset the module.
The PRIC ENABLE Signal resets the PMIC, and therefore the SoC. You can view PRIC EN when it’s driven low and released, which is functionally similar to driving tus Po low on Raspberry Pi Compute Module 4 and releasing it.
Raspberry Pi Compute Module 4 has the added benefit of being able to reset peripherals via the nEXTRST signal. Raspberry Pi Compute Module 5 will emulate this functionality on CAM GPIOT.
GLOBAL EN/PHIC EN are wired directly to the PMIC and bypass the OS completely. On Raspberry Pi Compute Module 5, use
GLOBAL EN/PHIC Es to execute a hard (but unsafe) shutdown
If there is a need, when using an existing 10 board, to retain the functionality of toggling I/O pin 92 to start a hard reset, you should intercept the Button at the software level; rather than having it invoke a system shutdown, it can be used to generate a software interrupt and, from there, to trigger a system reset directly (eg. write to S)
Device tree entry handling a power button (arch/arm64/boot/dts/broadcom/bcm2712-rpi-cm5.dtsi).
Code 116 is the standard event code for the kernel’s KEY POWER event, and there is a handler for this in the OS.
Raspberry Pi recommends using kernel watchdogs if you are concerned about the firmware or the OS crashing and leaving the power key unresponsive. ARM watchdog support is already present in Raspberry Pi OS via the device tree, and this can be customised to individual use cases. In addition, a long press/pull on the PIR Button (7 seconds) will cause the PMIC’s built-in handler to shut down the device.
Detaljerade pinout-ändringar
CAM1 and DSI1 signals have become dual-purpose and can be used for either a CSI camera or a DSI display.
The pins previously used for CAMO and DSIO on Raspberry Pi Compute Module 4 now support a USB 3.0 port on Raspberry Pi Compute Module 5.
The original Raspberry Pi Compute Module 4 VBAC COMP pin is now a VBUS-enabled pin for the two USB 3.0 ports, and is active high. Raspberry Pi Compute Module 4 has extra ESD protection on the HDMI, SDA, SCL, HPD, and CEC signals. This is removed from Raspberry Pi Compute Module 5 due to space limitations. If required, ESD protection can be applied to the baseboard, although Raspberry Pi Ltd does not regard it as essential.
|
Stift |
CM4 | CM5 | Kommentar |
| 16 | SYNC_IN | Fan_tacho | Fan tacho input |
| 19 | Ethernet nLED1 | Fan_pwn | Fan PWM output |
| 76 | Reserverad | VBAT | RTC battery. Note: There will be a constant load of a few uA, even if CM5 is powered. |
| 92 | RUN_PG | PWR_knapp | Replicates the power button on Raspberry Pi 5. A short press signals that the device should wake up or shut down. A long press forces shutdown. |
| 93 | nRPIBOOT | nRPIBOOT | If the PWR_Button is low, this pin will also be set low for a short time after power-up. |
| 94 | AnalogIP1 | CC1 | This pin can connect to the CC1 line of a Type-C USB connector to enable the PMIC to negotiate 5A. |
| 96 | AnalogIP0 | CC2 | This pin can connect to the CC2 line of a Type-C USB connector to enable the PMIC to negotiate 5A. |
| 99 | Global_EN | PMIC_ENABLE | No external change. |
| 100 | nEXTRST | CAM_GPIO1 | Pulled up on Raspberry Pi Compute Module 5, but can be forced low to emulate a reset signal. |
| 104 | Reserverad | PCIE_DET_nWAKE | PCIE nWAKE. Pull up to CM5_3v3 with an 8.2K resistor. |
| 106 | Reserverad | PCIE_PWR_EN | Signals whether the PCIe device can be powered up or down. Active high. |
| 111 | VDAC_COMP | VBUS_SV | Output to signal that USB VBUS should be enabled. |
| 128 | CAM0_D0_N | USB3-0-RX_N | May be P/N swapped. |
| 130 | CAM0_D0_P | USB3-0-RX_P | May be P/N swapped. |
| 134 | CAM0_D1_N | USB3-0-DP | USB 2.0 signal. |
| 136 | CAM0_D1_P | USB3-0-DM | USB 2.0 signal. |
| 140 | CAM0_C_N | USB3-0-TX_N | May be P/N swapped. |
| 142 | CAM0_C_P | USB3-0-TX_P | May be P/N swapped. |
| 157 | DSI0_D0_N | USB3-1-RX_N | May be P/N swapped. |
| 159 | DSI0_D0_P | USB3-1-RX_P | May be P/N swapped. |
| 163 | DSI0_D1_N | USB3-1-DP | USB 2.0 signal. |
| 165 | DSI0_D1_P | USB3-1-DM | USB 2.0 signal. |
| 169 | DSI0_C_N | USB3-1-TX_N | May be P/N swapped. |
| 171 | DSI0_C_P | USB3-1-TX_P | May be P/N swapped. |
Utöver ovanstående är PCIe CLK-signalerna inte längre kapacitivt kopplade.
PCB
Raspberry Pi Compute Module 5′s PCB is thicker than Raspberry Pi Compute Module 4′s, measuring at 1.24mm+/-10%.
Spårlängder
HDMI0 track lengths have changed. Each P/N pair remains matched, but the skew between pairs is now <1mm for existing motherboards. This is unlikely to make a difference, as the skew between pairs can be in the order of 25 mm.
HDMI1 track lengths have also changed. Each P/N pair remains matched, but the skew between pairs is now <5mm for existing motherboards. This is unlikely to make a difference, as the skew between pairs can be in the order of 25 mm.
Ethernet-spårlängderna har ändrats. Varje P/N-par förblir matchat, men snedställningen mellan paren är nu <4 mm för befintliga moderkort. Detta kommer sannolikt inte att göra någon skillnad, eftersom snedställningen mellan paren kan vara i storleksordningen 12 mm.
Kontakter
De två 100-poliga kontakterna har bytts till ett annat märke. Dessa är kompatibla med de befintliga kontakterna men har testats vid höga strömstyrkor. Den anslutningsbara delen som sitter på moderkortet är Amphenol P/N 10164227-1001A1RLF
Effektbudget
As Raspberry Pi Compute Module 5 is significantly more powerful than Raspberry Pi Compute Module 4, it will consume more electrical power. Power supply designs should budget for SV up to 2.5A. If this creates an issue with an existing motherboard design, it is possible to reduce the CPU clock rate to lower the peak power consumption.
The firmware monitors the current limit for USB, which effectively means that usb mas surrant, enable is always 1 on CM5, the 10 board design should take the total USB current required into consideration.
The firmware will report the detected power supply capabilities (if possible) via device-tree. On a running system, see /proc/device tree/chosen/poser/Dessa files lagras som 32-bitars big-endian binärdata.
Programvaruändringar/krav
Ur ett mjukvaruperspektiv view, ändringarna i hårdvara mellan Raspberry Pi Compute Module 4 och Raspberry Pi Compute Module 5 är dolda för användaren av ett nytt enhetsträd files, vilket innebär att majoriteten av programvaran som följer standard Linux API:er kommer att fungera utan ändringar. Enhetsträdet fileSe till att rätt drivrutiner för hårdvaran laddas vid start.
Enhetsträd files finns i Raspberry Pi Linux-kärnträdet. Till exempelampde:
https://github.com/raspberrypi/linux/blob/rpi-612.y/arch/arm64/boot/dis/broadcom/bom2712-pi-om5.dtsi.
Användare som byter till Raspberry Pi Compute Module 5 rekommenderas att använda de programvaruversioner som anges i tabellen nedan, eller senare. Även om det inte finns något krav på att använda Raspberry Pi OS, är det en användbar referens, därav dess inkludering i tabellen.
| Programvara | Version | Datum | Anteckningar |
| Raspberry Pi OS | Bookworm (12) | ||
| Firmware | From 10 Mar 2025 | Se https://pip.raspberrypi.com/categories/685-app-notes-guides- whitepapers/documents/RP-003476-WP/Updating-Pi-firmware.pdf for details on upgrading firmware on an existing image. Note that Raspberry Pi Compute Module 5 devices come pre-programmed with appropriate firmware | |
| Kärna | 6.12.x | Från 2025 | This is the kernel used in Raspberry Pi OS |
Moving to standard Linux APIs/libraries from proprietary drivers/
firmware
Alla ändringar som listas nedan var en del av övergången från Raspberry Pi OS Bullseye till Raspberry Pi OS Bookworm i oktober 2023. Även om Raspberry Pi Compute Module 4 kunde använda de äldre, föråldrade API:erna (eftersom den nödvändiga äldre firmware fortfarande fanns), är detta inte fallet på Raspberry Pi Compute Module 5.
Raspberry Pi Compute Module 5, liksom Raspberry Pi 5, förlitar sig nu på DRM-displaystacken (Direct Rendering Manager), snarare än den äldre stacken som ofta kallas DispmanX. Det finns INGET firmware-stöd på Raspberry Pi Compute Module 5 för DispmanX, så det är viktigt att övergå till DRM.
A similar requirement applies to cameras, Raspberry Pi Compute Module 5 only supports the libcamera library’s API, so older applications that use the legacy firmware MMAL APIs, such as raspi-still and rasps-vid, no longer function.
Applikationer som använder OpenMAX API (kameror, codecs) kommer inte längre att fungera på Raspberry Pi Compute Module 5, så de måste skrivas om för att använda V4L2. ExempelampLäs mer om detta finns i libcamera-apps GitHub-arkivet, där det används för att komma åt H264-kodarens hårdvara.
OMXPlayer is no longer supported, as it also uses the MMAL API for video playback, you should use the VLC application. There is no command-line compatibility between these applications: see the VLC documentation for details on usage.
Raspberry Pi previously published a whitepaper that discusses these changes in more detail: https://pip.raspberrypi.com/categories/685-app-notes-guides-whitepapers/documents/RP-006519-WP/Transitioning-from-Buliseye-to-Bookworm.pdf.
Ytterligare information
While not strictly related to the transition from Raspberry Pi Compute Module 4 to Raspberry Pi Compute Module 5, Raspberry Pi Ltd has released a new version of the Raspberry Pi Compute Module provisioning software and also has two distro generation tools that users of Raspberry Pi Compute Module 5 may find useful.
rpi-sb-provisioner is a minimal-input, automatic secure boot provisioning system for Raspberry Pi devices. It is entirely free to download and use, and can be found on our GitHub page here: https://github.com/raspberrypi/rpi-sb-provisioner.
pi-gen is the tool used to create the official Raspberry Pi OS images, but it is also available for third parties to use to create their own distributions. This is the recommended approach for Raspberry Pi Compute Module applications that require customers to build a custom Raspberry Pi OS-based operating system for their specific use case. This is also free to download and use, and can be found here: https://github.com/RPi-Distro/pi-gen. The pi-gen tool integrates well with rpi-sb-provisioner to provide an end-to-end process for generating secure boot OS images and implementing them on Raspberry Pi Compute Module 5.
rpi-image-gen is a new image creation tool (https://github.com/raspberrypi/rpi-image-gen) that may be more appropriate for more lightweight customer distributions
For bring-up and testing and where there is no requirement for the full provisioning system rpiboot is still available on Raspberry Pi Compute Module 5. Raspberry Pi Ltd recommends using a host Raspberry Pi SBC running the latest version of Raspberry Pi OS and the latest rathoot from https://github.com/raspberrypi/usbboot. You must use the ‘Mass Storage Gadget option when running rpiboot, as the previous firmware-based option is no longer supported.
Kontaktuppgifter för mer information
Vänligen kontakta
applications@iraspberrypi.com
if you have any queries about this whitepaper.
Web: www.raspberrypi.com
Dokument/resurser
 |
Raspberry Pi Compute Module 4 [pdf] Användarhandbok Beräkningsmodul 4, Modul 4 |