Arduino HID subdriver: Add support for Ugreen US3000 (PercentLoad and voltage mappings)

[ada-pan]

Device Information

• Manufacturer: UGREEN
• Model: US3000
• Vendor ID: 2b89
• Product ID: ffff
• NUT Version: 2.8.4
• Driver: usbhid-ups
• Subdriver: Arduino HID 0.21

Problem

The Arduino HID subdriver successfully connects to the Ugreen US3000 UPS but does not expose several variables that the device is actually reporting via HID, including:

• Load percentage (ups.load)
• Input voltage (input.voltage)
• Output voltage (output.voltage)

Current upsc output

battery.charge: 100
battery.charge.low: 20
battery.runtime: 65535
ups.status: OL DISCHRG
(full output available on request)

HID data from explore mode

Running usbhid-ups -DD -a ups -x explore shows the UPS IS providing:

• UPS.PowerSummary.PercentLoad (Value: 1) - not mapped to ups.load
• UPS.PowerConverter.Output.Voltage (Value: 19) - not mapped to output.voltage
• UPS.PowerConverter.Input.[1].Voltage (Value: 20) - not mapped to input.voltage

Full explore output attached

paste.txt

Request

Please add HID mappings to the Arduino subdriver for:

1. UPS.PowerSummary.PercentLoad → ups.load
2. UPS.PowerConverter.Output.Voltage → output.voltage (with appropriate scaling)
3. UPS.PowerConverter.Input.[1].Voltage → input.voltage (with appropriate scaling)

This would enable proper monitoring/dashboard support for this UPS model.

Additional context

The UPS works functionally with the Arduino subdriver for shutdown purposes, but dashboards cannot display load or voltage information without these mappings.