Details
-
Improvement
-
Resolution: Fixed
-
Minor
-
None
-
None
Description
Summary
Full support for Zebra label printers: hardware/version/serial, printhead temperature, printer status entities, and odometer counters for Link-OS printers, plus output status for older printers behind a ZebraNet print server. Before this, Zebra devices were detected as a generic "Printer" with no sensors, statuses or counters.
Patch: 02-zebra-printers.patch (attached). Apply from the Observium root with patch -p1 < 02-zebra-printers.patch. It was built against trunk SVN BASE and applies cleanly.
What it adds
Link-OS printers (ZT41x, GK420 etc., sysObjectID .1.3.6.1.4.1.10642.1.1), via ZEBRA-MIB:
- Hardware, version and serial from zbrGeneralModel, zbrGeneralFirmwareVersion and zbrGeneralUniqueId. These are preferred over the print server's values, so ZEBRA-MIB is listed first.
- Printhead temperature, using the printer's own over/under-temperature thresholds as limits.
- Status entities:
- Overall error/warning (zbrError, zbrWarning).
- Head latch open, head over-temperature error and under-temperature warning.
- Paper out, ribbon out, ribbon-in warning, paused, cutter jam.
- Buffer full and configuration lost.
- RAM, bitmap and cache allocation errors; stored bitmap, font, format and graphic errors; basic forced error.
- Odometer counters: total print length (cm), total label count, total cuts, latch-open count, and the length since a new printhead and since the last head clean.
ZebraNet print servers (legacy, sysObjectID .1.3.6.1.4.1.683.6), via ESI-MIB:
- Product, version, serial and the attached printer model.
- outputStatus / outputExtendedStatus as status entities, and a print-jobs counter (outputTotalJobsLogged).
- Printers behind these print servers don't expose the ZEBRA-MIB print/head tree, so only these are available.
The zebra OS also gets its icon and HTTP remote access.
Files
| File | Status | Purpose |
|---|---|---|
| includes/definitions/mibs/zebra.inc.php | new | ZEBRA-MIB and ESI-MIB definitions (hardware, sensors, states, counters) |
| includes/definitions/os/printer.inc.php | changed | zebra OS: MIB list, icon, http remote_access |
| mibs/zebra/ZEBRA-MIB | new | Hand-written subset (see note) |
| mibs/zebra/ESI-MIB | new | Stock ESI-MIB (Extended Systems print servers) |
Notes for maintainers
- Small upstream bug fixed on the way. The zebra block assigned $config['os'][$os]['mibs'] = "ESI-MIB";, a plain string rather than an array entry. It's now ['mibs'][] = ... for both MIBs.
- ZEBRA-MIB is a hand-written subset. Zebra doesn't publish a complete MIB file. Object names, OIDs and enums follow the public OID registry (https://oid-base.com/get/1.3.6.1.4.1.10642), and only objects verified against real printers are included.
- ESI-MIB is the unmodified vendor MIB, as also distributed in the LibreNMS repository. Please check you're happy to ship it, or replace it with your own copy.
- Lengths are reported in cm by the printer.
Testing
- ZT410/ZT411 (Link-OS 6.7), GK420t, and ZM400 / Z4M Plus behind ZebraNet wired print servers.
- php -l clean.