doc descriptions are wrong,

[Gnara221]

---

Title: [Docs] Incorrect description for Temp X keys in jtop.stats reference

Describe the bug

There is a discrepancy between the official documentation for the jtop.stats property and the actual returned data.

The documentation describes the keys Temp X and Temp TOT as Power indicators ("Current power from rail X" / "Total power"). However, the actual API returns Temperature readings (in Celsius) for these keys.

To Reproduce

Steps to reproduce the behavior:

1. Go to the documentation page: https://rnext.it/jetson_stats/reference/jtop.html#jtop.jtop.stats
2. Look at the table row for Temp X. It states:
   • Name: Temp X
   • Reference: power
   • Description: (Optional) Current power from rail X
3. Run the following Python script on a Jetson device:

   from jtop import jtop
   with jtop() as jetson:
       print(jetson.stats)

4. Observe the output. The values for Temp CPU or Temp GPU are temperature values (e.g., 50.1), not power values. Additionally, disconnected sensors show -256.0, which is a thermal zone error code, not a power reading.

Screenshots

1. Documentation claims it is Power:

Temp X | float | power | (Optional) Current power from rail X

2. Actual Output (It is Temperature):

{
    ...
    'Temp CPU': 50.187,   # Clearly 50°C, not 50mW or 50W
    'Temp GPU': 41.531,
    'Temp CV0': -256.0,   # Negative value indicates invalid thermal zone, impossible for power
    'Temp Tboard': 35.0,
    ...
}

Expected behavior

The documentation should be updated to reflect that Temp X fields in the stats dictionary represent Temperature readings from the thermal zones, usually measured in Celsius.

The description should likely be: "(Optional) Temperature reading from sensor X".

Additional context

Based on the log provided below, the values align perfectly with standard idle temperatures for a Jetson AGX Orin (approx 40-50°C).

Log from jtop.service

(Skipped, documentation issue)

Log from jetson-stats installation

(Skipped, documentation issue)

RAW Data

Output from jetson.stats showing the issue:

{'time': datetime.datetime(2026, 2, 4, 10, 27, 22, 502191), 'uptime': datetime.timedelta(days=3, seconds=80167, microseconds=780000), 'CPU1': 43, 'CPU2': 41, 'CPU3': 41, 'CPU4': 41, 'CPU5': 40, 'CPU6': 39, 'CPU7': 39, 'CPU8': 39, 'CPU9': 38, 'CPU10': 38, 'CPU11': 38, 'CPU12': 39, 'RAM': 0.31811564081245647, 'SWAP': 0.0, 'EMC': 0, 'GPU': 17.5, 'APE': 'OFF', 'DLA0_CORE': 'OFF', 'DLA0_FALCON': 'OFF', 'DLA1_CORE': 'OFF', 'DLA1_FALCON': 'OFF', 'NVDEC': 'OFF', 'NVENC': 'OFF', 'NVJPG': 'OFF', 'NVJPG1': 'OFF', 'PVA0_CPU_AXI': 'OFF', 'PVA0_VPS': 'OFF', 'SE': 473600, 'VIC': 'OFF', 'Fan pwmfan0': 50.19607843137255, 'Temp CPU': 50.187, 'Temp CV0': -256.0, 'Temp CV1': -256.0, 'Temp CV2': -256.0, 'Temp GPU': 41.531, 'Temp loc1': 38.0, 'Temp MAC Temperature': 38.382, 'Temp PHY Temperature': 39.953, 'Temp SOC0': 43.281, 'Temp SOC1': 43.0, 'Temp SOC2': 42.937, 'Temp Tboard': 35.0, 'Temp Tdiode': 34.75, 'Temp tj': 49.937, 'jetson_clocks': 'OFF', 'nvp model': 'MAXN'}