Pool status code 5 shown as 'Unknown status: 5' (UGOS: 'Data organizing')

[jvilhuber]

Summary

On a DH4300 Plus (UGOS), a storage pool's status sensor shows Unknown status: 5 while the UGOS web UI reports the pool state as "Data organizing". The pool-status code→label map in format_sensor_value() only covers codes 0–3, so 5 falls through to the Unknown status: {raw} default from format_status_code().

Environment

• Integration version: v2026.10.1
• NAS model: DH4300 Plus (RK3588C, UGOS)
• Pool: 4× HDD RAID. All member disks Normal, fan Normal, no fault present.

Current mapping — custom_components/ugreen/utils.py

if "pool" in endpoint.description.key and "status" in endpoint.description.key:
# Web GUI .js states: "0":"Normal","1":"Warnung","2":"Gefährlich","3":"Schwerwiegend"
    return format_status_code(raw, {
        0: "Normal",
        1: "Rebuilding",
        2: "Degraded",
        3: "Faulty",
    })

Observed

• sensor.ugreen_nas_pool_1_status = Unknown status: 5
• UGOS web UI → Storage → Pool 1 = "Data organizing"
• Transition: Normal → Unknown status: 5 at exactly 00:00 (a scheduled background pool task starting), with every member disk, the fan, and all disk temperatures remaining normal throughout.

So code 5 corresponds to the pool's "Data organizing" background-maintenance state (benign, not a fault).

Proposed fix

Add 5: "Data organizing" to the pool-status map. PR to follow.

Note

Code 4 for pool status is still unobserved here, so I've left it unmapped — only 5 is confirmed in this report.

[jvilhuber]

Update: pulled the full enum from the UGOS web UI itself. The Storage Manager bundle maps pool status with poolStatus(code) -> overview.poolStatus.status{code} for codes 0–14, and the shipped en-US locale resolves them to:

0 Normal · 1 Syncing · 2 Warning · 3 Degraded · 4 Corrupted · 5 Data organizing · 6 Creating · 7 Deleting · 8 Repairing · 9 Rebuilding · 10 Replacing hard drive · 11 Adding hard drive · 12 RAID upgrading · 13 Upgrade · 14 Waiting for sync

So "Unknown status: 5" = "Data organizing", and the current 1/2/3 labels are also off (should be Syncing/Warning/Degraded; Rebuilding is 9, Corrupted is 4). #285 now maps the whole 0–14 set.

[Tom-Bom-badil]

Thanks Jan @jvilhuber, much appreciated - and merged. :)

/tom

[Tom-Bom-badil]

Addendum: Included in the beta of the next release. Beta installation see here. Let me know if it works for you. :)

/tom