Uploaded image for project: 'Observium'
  1. Observium
  2. OBS-5328

Zebra printers: printhead temperature, status entities and odometers (ZEBRA-MIB), ZebraNet print server status (ESI-MIB)

    XMLWordPrintable

Details

    • Improvement
    • Resolution: Fixed
    • Minor
    • None
    • None
    • Discovery, OS

    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.

      Attachments

        Activity

          People

            landy Mike Stupalov
            rebeluca Luca Rebellato
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: