{
  "schemaVersion": 1,
  "name": "CloudToner printer discovery and telemetry registry",
  "description": "Standard and model-scoped read-only data sources considered by CloudToner during printer discovery.",
  "fallbackOrder": [
    "snmp_v2c",
    "snmp_v1_when_partial_or_unavailable",
    "ipp_identity_status_and_consumables",
    "print_service_evidence"
  ],
  "protocols": [
    {
      "key": "snmp_v2c",
      "name": "SNMP v2c",
      "role": "preferred",
      "description": "Preferred standard MIB query using bounded bulk walks."
    },
    {
      "key": "snmp_v1",
      "name": "SNMP v1",
      "role": "fallback",
      "description": "Retried when v2c is unavailable or returns incomplete identity, counters or measured supply levels."
    },
    {
      "key": "ipp",
      "name": "IPP",
      "role": "enrichment",
      "description": "Read-only Get-Printer-Attributes request for printer identity, state reasons and available consumable levels."
    },
    {
      "key": "print_services",
      "name": "IPP, LPD and JetDirect ports",
      "role": "evidence_only",
      "description": "Reachable print services can support discovery, but an open port alone is not toner telemetry."
    }
  ],
  "supplyLevelSentinels": {
    "-1": "Other: the device does not constrain this value.",
    "-2": "Unknown: the device cannot report a current quantity.",
    "-3": "Some remaining: the device knows supply remains but cannot provide a number."
  },
  "standardOids": [
    {
      "key": "sys_descr",
      "name": "System description",
      "description": "Device-provided make, model, firmware or controller description.",
      "oid": ".1.3.6.1.2.1.1.1.0",
      "capability": "identity",
      "kind": "scalar",
      "source": "RFC 3418",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3418.html"
    },
    {
      "key": "sys_object_id",
      "name": "System object identifier",
      "description": "Enterprise object identifier used as a vendor or print-server hint.",
      "oid": ".1.3.6.1.2.1.1.2.0",
      "capability": "vendor_hint",
      "kind": "scalar",
      "source": "RFC 3418 and IANA PEN registry",
      "sourceUrl": "https://www.iana.org/assignments/enterprise-numbers/"
    },
    {
      "key": "sys_uptime",
      "name": "System uptime",
      "description": "Time since the device network management service restarted.",
      "oid": ".1.3.6.1.2.1.1.3.0",
      "capability": "status",
      "kind": "scalar",
      "source": "RFC 3418",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3418.html"
    },
    {
      "key": "sys_name",
      "name": "System name",
      "description": "Configured device hostname or network node name.",
      "oid": ".1.3.6.1.2.1.1.5.0",
      "capability": "identity",
      "kind": "scalar",
      "source": "RFC 3418",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3418.html"
    },
    {
      "key": "hr_device_type",
      "name": "Host device type",
      "description": "Confirms that a Host-Resources device row is a printer.",
      "oid": ".1.3.6.1.2.1.25.3.2.1.2",
      "capability": "printer_proof",
      "kind": "table column",
      "source": "RFC 2790",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc2790.html"
    },
    {
      "key": "hr_device_description",
      "name": "Host device description",
      "description": "Model or device description associated with the printer row.",
      "oid": ".1.3.6.1.2.1.25.3.2.1.3",
      "capability": "identity",
      "kind": "table column",
      "source": "RFC 2790",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc2790.html"
    },
    {
      "key": "hr_device_status",
      "name": "Host device status",
      "description": "Running, warning, testing or down state for the printer device.",
      "oid": ".1.3.6.1.2.1.25.3.2.1.5",
      "capability": "status",
      "kind": "table column",
      "source": "RFC 2790",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc2790.html"
    },
    {
      "key": "hr_printer_status",
      "name": "Printer status",
      "description": "Printer-specific idle, printing, warm-up or unknown state.",
      "oid": ".1.3.6.1.2.1.25.3.5.1.1",
      "capability": "status",
      "kind": "table column",
      "source": "RFC 2790",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc2790.html"
    },
    {
      "key": "hr_printer_errors",
      "name": "Detected printer errors",
      "description": "Bit field for conditions such as low toner, no paper, a jam or offline state.",
      "oid": ".1.3.6.1.2.1.25.3.5.1.2",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 2790",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc2790.html"
    },
    {
      "key": "printer_name",
      "name": "Printer name",
      "description": "Human-readable printer name from Printer-MIB.",
      "oid": ".1.3.6.1.2.1.43.5.1.1.16",
      "capability": "identity",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "printer_serial",
      "name": "Printer serial number",
      "description": "Manufacturer serial number used for durable printer identity.",
      "oid": ".1.3.6.1.2.1.43.5.1.1.17",
      "capability": "identity",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "marker_counter_unit",
      "name": "Marker counter unit",
      "description": "Unit for each lifetime counter, such as impressions or sheets.",
      "oid": ".1.3.6.1.2.1.43.10.2.1.3",
      "capability": "page_counters",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "marker_life_count",
      "name": "Marker lifetime count",
      "description": "Lifetime page, sheet or impression counter reported by the print engine.",
      "oid": ".1.3.6.1.2.1.43.10.2.1.4",
      "capability": "page_counters",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_colorant_index",
      "name": "Supply colour index",
      "description": "Links a supply row to its colourant row.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.3",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_class",
      "name": "Supply class",
      "description": "Identifies a consumed supply or a waste receptacle.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.4",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_type",
      "name": "Supply type",
      "description": "Toner, cartridge, drum, fuser, transfer unit or another supply type.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.5",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_description",
      "name": "Supply description",
      "description": "Device-provided label for a cartridge or maintenance item.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.6",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_unit",
      "name": "Supply unit",
      "description": "Measurement unit for capacity and remaining level, including percent.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.7",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_capacity",
      "name": "Supply maximum capacity",
      "description": "Maximum measurable capacity used with the current level to calculate a percentage.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.8",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "supply_level",
      "name": "Current supply level",
      "description": "Current toner or maintenance level; negative values are explicit unknown-state sentinels.",
      "oid": ".1.3.6.1.2.1.43.11.1.1.9",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "colorant_value",
      "name": "Colourant value",
      "description": "Human-readable colour name used to map supply rows to black, cyan, magenta or yellow.",
      "oid": ".1.3.6.1.2.1.43.12.1.1.4",
      "capability": "consumables",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "alert_severity",
      "name": "Alert severity",
      "description": "Severity of an active Printer-MIB alert.",
      "oid": ".1.3.6.1.2.1.43.18.1.1.2",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "alert_group",
      "name": "Alert group",
      "description": "Printer sub-unit responsible for an alert, such as marker supply or media path.",
      "oid": ".1.3.6.1.2.1.43.18.1.1.4",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "alert_code",
      "name": "Alert code",
      "description": "Standard Printer-MIB condition code for the active alert.",
      "oid": ".1.3.6.1.2.1.43.18.1.1.7",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "alert_description",
      "name": "Alert description",
      "description": "Device-provided text describing the current condition.",
      "oid": ".1.3.6.1.2.1.43.18.1.1.8",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    },
    {
      "key": "alert_time",
      "name": "Alert time",
      "description": "Device uptime tick when the alert was raised.",
      "oid": ".1.3.6.1.2.1.43.18.1.1.9",
      "capability": "alerts",
      "kind": "table column",
      "source": "RFC 3805",
      "sourceUrl": "https://www.rfc-editor.org/rfc/rfc3805.html"
    }
  ],
  "vendorProfiles": [
    {
      "manufacturer": "HP",
      "networkClass": "network_printer",
      "privateMibState": "official_mib_not_bundled",
      "officialSources": [
        "https://support.hp.com/us-en/document/ish_3007439-2783374-16"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Brother",
      "networkClass": "network_printer",
      "privateMibState": "model_scoped_status_pending_fixture",
      "officialSources": [
        "https://support.brother.com/g/s/es/dev/en/command/faq/index.html"
      ],
      "privateProbes": [
        {
          "key": "brother_mobile_status",
          "oid": ".1.3.6.1.4.1.2435.3.3.9.1.6.1.0",
          "capability": "status",
          "modelTokens": [
            " rj-",
            " td-",
            " pj-",
            " pt-",
            " ql-"
          ],
          "source": "Brother developer command reference",
          "enabled": false
        }
      ]
    },
    {
      "manufacturer": "Canon",
      "networkClass": "network_printer",
      "privateMibState": "device_family_mib_not_bundled",
      "officialSources": [
        "https://oip.manual.canon/USRMA-0312-zz-CS-enGB/contents/1T0002902842.html"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Kyocera",
      "networkClass": "network_printer",
      "privateMibState": "private_mib_not_bundled",
      "officialSources": [
        "https://www.kyoceradocumentsolutions.com/"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Lexmark",
      "networkClass": "network_printer",
      "privateMibState": "optional_ppm_mib_not_bundled",
      "officialSources": [
        "https://publications.lexmark.com/"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Epson",
      "networkClass": "network_printer",
      "privateMibState": "private_or_enpc_pending_fixture",
      "officialSources": [
        "https://files.support.epson.com/docid/cpd6/cpd62380/source/printers/source/networking/reference/web_config_protocol_settings_wfc4310.html"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Fuji Xerox",
      "networkClass": "network_printer",
      "privateMibState": "legacy_xerox_private_mib_not_bundled",
      "officialSources": [
        "https://www.support.xerox.com/en-us/article/KB0119060"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Fujifilm",
      "networkClass": "network_printer",
      "privateMibState": "private_mib_not_bundled",
      "officialSources": [
        "https://support-fb.fujifilm.com/"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Xerox",
      "networkClass": "network_printer",
      "privateMibState": "xcmi_private_mibs_not_bundled",
      "officialSources": [
        "https://www.support.xerox.com/en-us/article/KB0119060"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "OKI",
      "networkClass": "network_printer",
      "privateMibState": "device_media_mib_not_bundled_standard_mc873_fixture_verified",
      "officialSources": [
        "https://www.oki.com/printing/online-manuals-12/459925/id/contents/contents/sw_000023.html",
        "https://www.oki.com/printing/online-manuals-12/459925/id/contents/contents/am_000051.html"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Ricoh",
      "networkClass": "network_printer",
      "privateMibState": "ricoh_private_mib_named_not_bundled",
      "officialSources": [
        "https://support.ricoh.com/bb_v1oi/pub_e/oi_view/0001033/0001033237/view/software/int/0265.htm"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Toshiba",
      "networkClass": "network_printer",
      "privateMibState": "private_mib_not_bundled",
      "officialSources": [
        "https://business.toshiba.com/downloads/KB/f1Ulds/7788/ebridge-OpsManualDocmon-v04.pdf"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Sharp",
      "networkClass": "network_printer",
      "privateMibState": "private_mib_not_bundled",
      "officialSources": [
        "https://global.sharp/restricted/print/manuals/6/bp70m90/us/contents_10-07_018.html"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Samsung",
      "networkClass": "network_printer",
      "privateMibState": "legacy_private_mib_not_bundled",
      "officialSources": [
        "https://support.hp.com/us-en/document/c05584061"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Konica Minolta",
      "networkClass": "network_printer",
      "privateMibState": "generation_specific_private_mibs_not_bundled",
      "officialSources": [
        "https://manuals.konicaminolta.eu/bizhub-651i-551i-451i/EN/contents/WC_12_03_05.html"
      ],
      "privateProbes": []
    },
    {
      "manufacturer": "Dymo",
      "networkClass": "local_first_mixed",
      "privateMibState": "no_verified_network_private_mib",
      "officialSources": [
        "https://download.dymo.com/UserManuals/LabelWriterPrintServer/LW_Print_Server_Guide.pdf"
      ],
      "privateProbes": []
    }
  ]
}