Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions en/key_stone/k1/k1_docs/k1_ds.md
Original file line number Diff line number Diff line change
Expand Up @@ -3756,8 +3756,8 @@ Instead, the input thresholds of Schmitt Trigger Mode of I/O PADs are tabled bel
| Item | Symbol | Min | Max | Unit |
|-----------------------------------|--------|------|------|------|
| Operating Temperature<br>(Industrial Standard) | Ta | -40 | +85 | °C |
| Junction Temperature | Tj | N/A | 125 | ℃ |
| Storage Temperature | Tstg | -40 | 125 | ℃ |
| Junction Temperature | Tj | N/A | 125 | °C |
| Storage Temperature | Tstg | -40 | 125 | °C |

### 5.3 Pin Max Currents

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -113,8 +113,8 @@ sidebar_position: 5
| Item | Symbol | Min | Max | Unit |
|-----------------------------------|--------|------|------|------|
| Operating Temperature<br>(Industrial Standard) | Ta | -40 | +85 | °C |
| Junction Temperature | Tj | N/A | 125 | ℃ |
| Storage Temperature | Tstg | -40 | 125 | ℃ |
| Junction Temperature | Tj | N/A | 125 | °C |
| Storage Temperature | Tstg | -40 | 125 | °C |

## 4.3 Pin Max Currents

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
sidebar_position: 7
sidebar_position: 8

# 7. Interrupt Assignments

Expand Down
2 changes: 1 addition & 1 deletion en/key_stone/k1/k1_docs/k1_usermanual/8.CPU_System.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 8
sidebar_position: 9
---

# 8. CPU System
Expand Down
4 changes: 2 additions & 2 deletions en/key_stone/k1/k1_sw/k1_sw_faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -974,7 +974,7 @@ TBD
open the thermal control related device tree file `arch/riscv/boot/dts/spacemit/k1-x_thermal_cooling.dtsi`.
- **Modify thermal control settings:**
In the file, locate the thermal control nodes such as `cls0_trip4` and `cls1_trip4`, and set the `temperature` and `hysteresis` parameters. These attributes define the temperature threshold and hysteresis value for triggering shutdown.
As shown in the following dts configuration, set 115℃ to trigger shutdown to protect the chip:
As shown in the following dts configuration, set 115°C to trigger shutdown to protect the chip:
```c
//arch/riscv/boot/dts/spacemit/k1-x_thermal_cooling.dtsi

Expand All @@ -995,7 +995,7 @@ TBD
- **Step 2:** Flash the new device tree (dts) to the device and reboot the system.
- **Step 3: Verify the changes:** Monitor system temperature with appropriate tools, and ensure the thermal control settings work as expected.
**Note.** Changing thermal control settings may affect system stability and hardware lifespan, so please be cautious.
It is recommended to read relevant documents or seek professional guidance before making changes (the recommended maximum temperature is 115℃).
It is recommended to read relevant documents or seek professional guidance before making changes (the recommended maximum temperature is 115°C).
To disable thermal control, you can turn off the kernel compilation configuration CONFIG\_THERMAL, but this is not recommended.

10. **How to Pull Up GPIO via Command Line?**
Expand Down
52 changes: 26 additions & 26 deletions en/key_stone/k3/k3_hw/k3_hw_design_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -566,9 +566,9 @@ The K3 provides 17 UART interfaces, divided into two categories: X100 UART and R
- UART1 can be used in the secure domain
- RCPU UART: 6 ports

#### 1.4.3 IIC
#### 1.4.3 I²C

The K3 provides 11 IIC interfaces.
The K3 provides 11 I²C interfaces.

- 9 x general-purpose I2C interfaces.
- 1 × PWR I2C and 1 × RCPU PWR I2C, used for power IC configuration and control
Expand Down Expand Up @@ -975,7 +975,7 @@ PCB insertion loss requirement: < 2 dB @ 2.7 GHz

### 3.1 Thermal Resistance Simulation Results

| Package | Jc (℃/W) | Jb (℃/W) |
| Package | Jc (°C/W) | Jb (°C/W) |
| --- | --- | --- |
| Thermal resistance | 0.17 | |

Expand All @@ -989,7 +989,7 @@ Thermal control strategy: step_wise (temperature rise triggers gradual frequency

Key parameters:
- OPP index starts from 0. Lower index = higher frequency
- Hysteresis: 2 ℃ (trigger temperature - 2 ℃ = exit temperature)
- Hysteresis: 2 °C (trigger temperature - 2 °C = exit temperature)

Dual cluster configuration:
- Cluster1 (CPU0–7): opp_table0_x100
Expand Down Expand Up @@ -1023,27 +1023,27 @@ OPP8: 1300 MHz

#### 3.2.2 Full Temperature Range Strategy (Heating + Cooling)

1. Temperature < 83 ℃
1. Temperature < 83 °C

Status: No limitation (maximum performance)
- Cluster1: 2400 MHz (OPP0)
- Cluster2: 2000 MHz (OPP0)

Temperature rise: ≥85 ℃ → enter 85 ℃ frequency lock
Temperature rise: ≥85 °C → enter 85 °C frequency lock

Temperature drop: maintain full performance, no action

2. 83 ℃ ≤ Temperature < 93 ℃ (85 ℃ active thermal control)
2. 83 °C ≤ Temperature < 93 °C (85 °C active thermal control)

Limit: Fixed frequency lock
- Cluster1: OPP2 = 2200 MHz
- Cluster2: OPP3 = 1800 MHz

Temperature rise: ≥95 ℃ → enter 95 ℃ dynamic throttling
Temperature rise: ≥95 °C → enter 95 °C dynamic throttling

Temperature drop: ≤83 ℃ → release lock, restore full performance (OPP0)
Temperature drop: ≤83 °C → release lock, restore full performance (OPP0)

3. 93 ℃ ≤ Temperature < 103 ℃ (95 ℃ passive thermal control)
3. 93 °C ≤ Temperature < 103 °C (95 °C passive thermal control)

Limit: Dynamic frequency scaling within range
- Cluster1: OPP3 ~ OPP5 → 2150 MHz ~ 2000 MHz
Expand All @@ -1053,11 +1053,11 @@ OPP8: 1300 MHz
- Temperature rise: hotter → higher OPP index → lower frequency
- Temperature drop: cooler → lower OPP index → higher frequency

Temperature rise: ≥105 ℃ → enter 105 ℃ deep throttling
Temperature rise: ≥105 °C → enter 105 °C deep throttling

Temperature drop: ≤93 ℃ → return to 85 ℃ fixed frequency lock
Temperature drop: ≤93 °C → return to 85 °C fixed frequency lock

4. 103 ℃ ≤ Temperature < 113 ℃ (105 ℃ deep passive thermal control)
4. 103 °C ≤ Temperature < 113 °C (105 °C deep passive thermal control)

Limit: Deep aggressive throttling
- Cluster1: OPP6 ~ OPP8 → 1900 MHz ~ 1800 MHz
Expand All @@ -1067,11 +1067,11 @@ OPP8: 1300 MHz
- Temperature rise: hotter → throttle to lowest frequency in range
- Temperature drop: cooler → gradually return to higher frequency in range

Temperature rise: ≥115 ℃ → emergency shutdown
Temperature rise: ≥115 °C → emergency shutdown

Temperature drop: ≤103 ℃ → return to 95 ℃ dynamic throttling
Temperature drop: ≤103 °C → return to 95 °C dynamic throttling

5. Temperature ≥ 113 ℃ (115 ℃ critical)
5. Temperature ≥ 113 °C (115 °C critical)

Action: System immediately shuts down / reboots

Expand All @@ -1085,11 +1085,11 @@ Note: After K3 system boot, the default maximum frequencies are

| Temperature Range | Control Method | Cluster1 | Cluster2 | Temperature Rise Trigger (Enter Next Stage) | Temperature Drop Trigger (Return to Previous Stage) |
| --- | --- | --- | --- | --- | --- |
| < 83℃ | Full performance | 2400 MHz | 2000 MHz | ≥85℃ → frequency lock | None |
| 83~93℃ | Fixed frequency lock | 2200 MHz | 1800 MHz | ≥95℃ → dynamic throttling | ≤83℃ → restore full performance |
| 93~103℃ | Dynamic throttling | 2150~2000 MHz | 1700~1600 MHz | ≥105℃ → deep throttling | ≤93℃ → return to frequency lock |
| 103~113℃ | Deep throttling | 1900~1800 MHz | 1500~1300 MHz | ≥115℃ → shutdown | ≤103℃ → return to dynamic |
| ≥115℃ | Emergency shutdown | Shutdown | Shutdown | Immediate shutdown | No automatic recovery |
| < 83°C | Full performance | 2400 MHz | 2000 MHz | ≥85°C → frequency lock | None |
| 83~93°C | Fixed frequency lock | 2200 MHz | 1800 MHz | ≥95°C → dynamic throttling | ≤83°C → restore full performance |
| 93~103°C | Dynamic throttling | 2150~2000 MHz | 1700~1600 MHz | ≥105°C → deep throttling | ≤93°C → return to frequency lock |
| 103~113°C | Deep throttling | 1900~1800 MHz | 1500~1300 MHz | ≥115°C → shutdown | ≤103°C → return to dynamic |
| ≥115°C | Emergency shutdown | Shutdown | Shutdown | Immediate shutdown | No automatic recovery |

### 3.3 PCB Thermal Design Reference

Expand Down Expand Up @@ -1142,8 +1142,8 @@ K3 chips use environmentally friendly materials. Pb-Free process is recommended.

| Material / Parameter / Tool | Criteria | 49VP03 |
| --- | --- | --- |
| Soaking time (127~170 ℃) | 60~90 sec | 61~64 sec |
| Ramp up rate (170~245 ℃) | 0.5~1.2 (℃/sec) | 0.81~0.86 (℃/sec) |
| Peak temperature | 235~245 ℃ | 235.94~238.3 ℃ |
| Reflow time (> 220 ℃) | 35~55 sec | 44~47 sec |
| Cooling rate (245~120 ℃) | ≤ 2.5 (℃/sec) | 1.23~1.28 (℃/sec) |
| Soaking time (127~170 °C) | 60~90 sec | 61~64 sec |
| Ramp up rate (170~245 °C) | 0.5~1.2 (°C/sec) | 0.81~0.86 (°C/sec) |
| Peak temperature | 235~245 °C | 235.94~238.3 °C |
| Reflow time (> 220 °C) | 35~55 sec | 44~47 sec |
| Cooling rate (245~120 °C) | ≤ 2.5 (°C/sec) | 1.23~1.28 (°C/sec) |
4 changes: 2 additions & 2 deletions en/power_stone/p1/p1_docs/p1_ds.md
Original file line number Diff line number Diff line change
Expand Up @@ -830,7 +830,7 @@ Table 6-4: PMIC Mode Management
| VSYS | DIGITAL | - | - | x | x | x | x |
| AONLDO | GPIO | - | - | - | - | x | x |
| | INT | - | - | - | - | x | x |
| | IIC | - | - | - | - | x | x |
| | I²C | - | - | - | - | x | x |

### 6.3 PMIC Events and Behaviors

Expand Down Expand Up @@ -1301,7 +1301,7 @@ When the shutdown protection for a power rail is enabled (PROT_EN[5:0], Table 7-

Over-Temperature Protection Levels

| SYS_CFG0[7] (Table 7-125) | Warning Temp (℃) | Severe Temp (℃) | Critical Temp (℃) |
| SYS_CFG0[7] (Table 7-125) | Warning Temp (°C) | Severe Temp (°C) | Critical Temp (°C) |
|----------------------------|-----------------|----------------|------------------|
| 0 | 95 | 115 | 135 |
| 1 | 110 | 130 | 150 |
Expand Down
Loading
Loading