Vollständiger technischer Text aus der chinesischen Quelle V1.0.0 für RK3399 und Linux 4.4 / 4.19. Nur ArmSoM-Plattformreferenz: SoC, SDK/BSP, trust/ATF, Kernel, PMIC, Versorgungsbaum und Aufweckpins der konkreten Platine prüfen. Keine pauschale Unterstützung aller ArmSoM-Platinen. Kein englisches PDF und keine separaten technischen Abbildungen vorhanden; alle vier Sprachen basieren auf der chinesischen Quelle. Code, Konfiguration und Logs sind Quellbeispiele, keine ArmSoM-Hardwaretests; Suspend- oder Versorgungsbefehle wurden nicht ausgeführt.
Fehlerhafte Abschalt-, Takt- oder Aufweckeinstellungen können Resume verhindern oder Datenverlust verursachen. Beispiele vor Verwendung von einem mit der Hardware vertrauten Ingenieur prüfen lassen. Quellkommentare, Schreibweisen, Platzhalter und Unklarheiten bleiben erhalten; Konstanten werden nicht erfunden.
1. System-Suspend
Auf SoC-Plattformen mit trust wird System-Suspend in trust implementiert. Die Implementierung unterscheidet sich je nach Plattform; Optionen und Verfahren dürfen daher nicht zwischen Plattformen übertragen werden. Dieses Handbuch gilt ausschließlich für RK3399. Typische Vorgänge sind das Abschalten von Power-Domänen, Takten und PLLs, DDR-Selbstauffrischung, das Umschalten des Systembusses auf einen langsamen Takt (24M oder 32K), das Versetzen des PMIC in den Schlafmodus und das Konfigurieren der Aufweckquellen. Für produktspezifische Suspend-Anforderungen werden die Einstellungen beim Start über DTS-Knoten an trust übergeben.
1.1 Treiberdateien
./drivers/soc/rockchip/rockchip_pm_config.c
./drivers/firmware/rockchip_sip.c
./include/dt-bindings/suspend/rockchip-rk3399.h
1.2 DTS-Knoten
rockchip_suspend: rockchip-suspend {
compatible = "rockchip,pm-rk3399";
status = "okay";
// 常规配置
rockchip,sleep-mode-config = <
(0
| RKPM_SLP_ARMPD
| RKPM_SLP_PERILPPD
| RKPM_SLP_DDR_RET
| RKPM_SLP_CENTER_PD
)
>;
// 唤醒源配置
rockchip,wakeup-config = <
(0
| RKPM_GPIO_WKUP_EN
)
>;
// 电源配置
rockchip,pwm-regulator-config = <
(0
| PWM2_REGULATOR_EN
)
>;
// 对应APIO断电
rockchip,apios-suspend = <
(0
| RKPM_APIOxxx
)
>;
// 休眠控制GPIO的电平，关断对应供电
rockchip,power-ctrl =
<&gpioX RK_PXX GPIO_ACTIVE_HIGH>;
};
2. DTS-Konfiguration
Die derzeit unterstützten Konfigurationsoptionen sind hier definiert:
./include/dt-bindings/suspend/rockchip-rk3399.h
2.1 Allgemeine Konfiguration
Konfigurationseigenschaft:
rockchip,sleep-mode-config = <...>;
Konfigurationsdefinitionen:
// 休眠 CPU 处在 WFI 状态，只有调试时⽤到
#define RKPM_SLP_WFI (1 << 0)
// 休眠 cpu_pd power down
#define RKPM_SLP_ARMPD (1 << 1)
// 休眠perilp_pd power down
#define RKPM_SLP_PERILPPD (1 << 2)
// 休眠 ddr 进⼊⾃刷新且处在 retention 状态
#define RKPM_SLP_DDR_RET (1 << 3)
// 休眠 PLL power down
#define RKPM_SLP_PLLPD (1 << 4)
// 休眠 OSC disable，系统时钟切到 32K
#define RKPM_SLP_OSC_DIS (1 << 5)
// 休眠 center_pd power down
#define RKPM_SLP_CENTER_PD (1 << 6)
// 休眠 AP_OFF 会被拉⾼，⽤于控制 PMIC 或者其他分⽴电源进⼊休眠态
#define RKPM_SLP_AP_PWROFF (1 << 7)
2.2 Versorgungskonfiguration
Konfigurationseigenschaft:
rockchip,pwm-regulator-config = <...>;
Konfigurationsdefinitionen:
// 使⽤ pwm-regulator
#define PWM0_REGULATOR_EN (1 << 0)
#define PWM1_REGULATOR_EN (1 << 1)
#define PWM2_REGULATOR_EN (1 << 2)
#define PWM3A_REGULATOR_EN (1 << 3)
#define PWM3B_REGULATOR_EN (1 << 4)
Hinweis zur Versorgung: Ob pwm-regulator verwendet wird, richtet sich nach der externen Schaltung. Die Konfiguration muss zur Hardware passen.
2.3 Aufweckkonfiguration
Konfigurationseigenschaft:
rockchip,wakeup-config = <...>;
Konfigurationsdefinitionen:
// ⽀持所有的中断唤醒
#define RKPM_CLUSTER_L_WKUP_EN (1 << 0)
// ⽀持所有被指定到⼤核的中断唤醒
#define RKPM_CLUSTER_B_WKUPB_EN (1 << 1)
// ⽀持 GPIO 唤醒
#define RKPM_GPIO_WKUP_EN (1 << 2)
// ⽀持 SDIO 唤醒
#define RKPM_SDIO_WKUP_EN (1 << 3)
// ⽀持 SDMMC 唤醒
#define RKPM_SDMMC_WKUP_EN (1 << 4)
// ⽀持 TIMER 唤醒
#define RKPM_TIMER_WKUP_EN (1 << 6)
// ⽀持插拔 USB 唤醒
#define RKPM_USB_WKUP_EN (1 << 7)
// ⽀持 SOFTWARE 唤醒
#define RKPM_SFT_WKUP_EN (1 << 8)
// ⽀持 WDT 唤醒
#define RKPM_WDT_M0_WKUP_EN (1 << 9)
// ⽀持 TIMEOUT 唤醒，⼀般⽤于调试
#define RKPM_TIME_OUT_WKUP_EN (1 << 10)
// ⽀持 PWM 唤醒
#define RKPM_PWM_WKUP_EN (1 << 11)
// ⽀持 PCIE 唤醒
#define RKPM_PCIE_WKUP_EN (1 << 13)
// ⽀持 USB 协议唤醒
#define RKPM_USB_LINESTATE_WKUP_EN (1 << 14)
Aufweckhinweis: Ein Interrupt, der in der Kernel-Phase nicht über enable_irq_wake() beim GIC registriert wurde, kann das System nicht aufwecken.
2.4 Debug-Konfiguration
Konfigurationseigenschaft:
rockchip,sleep-debug-en = <...>;
Debug-Hinweis: Der Wert 1 aktiviert Debug-Ausgaben. Während Suspend und Resume werden die entsprechenden ATF-Protokolle ausgegeben.
2.5 APIO-Abschaltkonfiguration
Konfigurationseigenschaft:
rockchip,apios-suspend = <...>;
Konfigurationsdefinitionen:
/* APIO 电压域 */
#define RKPM_APIO0_SUSPEND (1 << 0)
#define RKPM_APIO1_SUSPEND (1 << 1)
#define RKPM_APIO2_SUSPEND (1 << 2)
#define RKPM_APIO3_SUSPEND (1 << 3)
#define RKPM_APIO4_SUSPEND (1 << 4)
#define RKPM_APIO5_SUSPEND (1 << 5)
APIO-Hinweis: Die APIO-Domänen der RK3399-GPIOs sind in APIO1–APIO5 unterteilt. Wenn die Schaltung dies unterstützt, lassen sie sich im Suspend unabhängig abschalten.
2.6 GPIO-gesteuerte Versorgung
Konfigurationseigenschaft:
rockchip,power-ctrl = <...>
Konfigurationsbeispiel:
// 休眠将GPIO1_C1拉⾼，控制外部电源断电
rockchip,power-ctrl = <&gpio1 RK_PC1 GPIO_ACTIVE_HIGH>,
3. Protokollmeldungen
Im Folgenden werden trust-Meldungen bei Suspend und Resume erläutert. Einige Ausgaben sind für die Erläuterung auf mehrere Zeilen verteilt. Unterschiedliche Stromsparmodi liefern ebenfalls unterschiedliche Meldungen; maßgeblich ist die tatsächliche Ausgabe.
RK3399-System-Suspend-Protokoll:
// 休眠模式
INFO: sleep mode config[0xde]:
INFO: AP_PWROFF
INFO: SLP_ARMPD
INFO: SLP_PLLPD
INFO: DDR_RET
INFO: SLP_CENTER_PD
// ⽀持的唤醒源
INFO: wakeup source config[0x804]:
INFO: GPIO interrupt can wakeup system
INFO: PWM interrupt can wakeup system
// 休眠需要控制的pwm regulator
INFO: PWM CONFIG[0x4]:
INFO: PWM: PWM2D_REGULATOR_EN
// 休眠需要控制的APIO
INFO: APIOS info[0x0]:
INFO: not config
// 通过GPIO控制的电源
INFO: GPIO POWER INFO:
INFO: GPIO1_C1
INFO: GPIO1_B6
// 休眠模式寄存器的值
INFO: PMU_MODE_CONG: 0x1466bf51
RK3399-System-Resume-Protokoll:
// 唤醒打印
INFO: RK3399 the wake up information:
INFO: wake up status: 0x4
INFO: GPIO interrupt wakeup
INFO: GPIO0: 0x0
INFO: GPIO1: 0x200000
INFO: GPIO2: 0x0
INFO: GPIO3: 0x0
INFO: GPIO4: 0x0
// 唤醒源
GPIO interrupt wakeup
gpio1_c5中断唤醒系统