Quick start
lens-hardware
lens-hardware --once
lens-hardware --plain
lens-hardware --filter serial
lens-hardware --jsonUse the arrow keys to select a system, sensor or device row and press Enter for its source, identifiers and thresholds. The cockpit also shows sensor, USB and serial counts.
Hardware identity and firmware
On Linux, Lens reads the device-tree and standard DMI sysfs fields for model, manufacturer, board, revision, serial number and firmware. On macOS it reads the native hardware profile for model, Apple silicon or CPU type, serial number and system firmware.
These fields are useful when a fleet contains several board revisions or when a support case depends on the exact gateway, firmware build or physical unit.
Temperatures and limits
Linux sensors come from thermal zones and hwmon. Lens displays the kernel sensor name, current temperature, source path, and maximum or critical thresholds exposed by the driver. Raspberry Pi SoC temperature is also read through vcgencmd.
Health raises an attention or critical finding when a sensor reaches its reported limit, with practical fallback thresholds for drivers that publish only a current temperature.
Raspberry Pi power and thermal status
On Raspberry Pi, Lens decodes the firmware throttling flags into current and recorded conditions: under-voltage, frequency capping, throttling and the soft temperature limit. Current under-voltage or throttling appears as a critical health finding; recorded events remain visible for intermittent power and cooling investigations.
The raw hexadecimal firmware value is retained in the detail view and JSON, alongside the decoded conditions.
USB and serial inventory
Linux USB inventory comes from sysfs and includes product name, manufacturer, vendor/product IDs and serial number where the device exposes them. Serial inventory includes stable /dev/serial/by-id links and common USB, ACM and UART devices. macOS uses the native USB profile and lists /dev/cu.* serial endpoints.
Stable serial paths and USB identifiers help distinguish a modem, sensor or adapter from another unit after reboot or re-enumeration.
Structured output and health checks
JSON adds hardware, temperatures and hardware_devices to the shared snapshot. Use --filter for a sensor name, source, device type, path, manufacturer or serial number. Use --limit 0 when an inventory must include every matching device.
Machine and peripheral serial numbers are inventory data. Review a snapshot before attaching it to a public issue.
lens-health includes high-temperature, power and throttling findings when the platform exposes them, so these conditions appear in the main cockpit as well as the specialist view.