aps.example.yaml

# diting AP aliases — sample config
#
# Resolution semantics (override-wins → first-five-octet → mid-four
# → cluster-label fallback) are pinned in
# openspec/specs/inventory/spec.md.
#
# This file is OPTIONAL. Without it, diting still groups every
# BSSID by physical AP using auto-cluster labels like '?40:fe:95',
# which is enough for daily use on enterprise networks where you
# cannot pull mgmt MACs out of the controller anyway.
#
# To get human-readable AP names ('1F-bedroom' instead of '?40:fe:95'):
#   1. cp aps.example.yaml aps.yaml          (next to this file)
#   2. fill in the entries below from your router or AP controller's
#      management UI ('AP list' / 'Access points' page)
#   3. diting will pick it up automatically; no restart needed
#
# Override the location with DITING_INVENTORY=/full/path/aps.yaml.
#
# Most controllers (H3C, Aruba, Ubiquiti, Cisco, ASUS mesh, ...) only
# expose the AP-level **management MAC** — not the per-radio BSSIDs
# the AP actually broadcasts. Just list the mgmt MACs here. diting
# derives radio attribution at runtime by two rules, both gated by a
# last-byte proximity check (radios are mgmt + N for small N):
#   1. first five octets match (chip's primary OUI block — the common
#      case for nearly all consumer / SMB gear)
#   2. middle four octets match (chip serial bits; covers vendors that
#      allocate VAPs from a sibling OUI block — H3C, some others)

aps:
  # Management MACs read straight off the H3C AC "AP列表" page.
  - name: AX51-E_1-B1
    mgmt_mac: 40:fe:95:8a:3c:07
  - name: AX51-E_4-B2
    mgmt_mac: 40:fe:95:8a:3c:54
  - name: AX51-E_5-3F
    mgmt_mac: 40:fe:95:8a:3c:15
  - name: AX51-E_3-2F
    mgmt_mac: 40:fe:95:89:c7:df
  - name: AX60_2
    mgmt_mac: bc:22:47:ca:79:46

# radio_overrides: {}
#
# Optional. Use ONLY if your AP vendor randomizes per-radio MACs so
# that radio BSSIDs do not share the first five octets with the
# mgmt MAC (some Cisco Meraki SKUs are like this). Maps an exact
# BSSID directly to an AP name, bypassing the prefix-matching rule:
#
# radio_overrides:
#   bc:22:47:ca:99:99: AX60_2