Glossary
Radio terms, demystified
Underlined words across the site link here. Read the short definition, then the longer plain-English entry.
- Reflector
- A shared online meeting room for digital voice radios — operators connect and hear each other.
- A reflector is a server on the internet that links digital voice radios together. When you connect your radio (or a hotspot) to a reflector, you join a shared audio space with other operators. Think of it as a conference bridge for ham radio digital voice — not a website chat, but live radio audio over the network.
- Module
- A named room on a reflector (like Main Room, Nets, or Echo Test) with a clear purpose.
- Modules are the rooms inside an OmniRef reflector. Each one has a letter and a job: A is the Main Room, C is for nets, Z is echo test, and so on. You pick a module the same way you pick a talkgroup or room on older systems — except OmniRef names them in plain English so newcomers are not guessing.
- Mode
- The digital voice format your radio speaks — DMR, D-STAR, Fusion/YSF, M17, AllStar, and more.
- A mode is the digital voice language your radio uses. DMR, D-STAR, Yaesu System Fusion (YSF), M17, and AllStar are different modes. Same-mode means everyone on that module uses the same format. Cross-mode means OmniRef translates between formats — which needs an AMBE dongle when the codecs require it.
- Dongle (AMBE)
- Optional hardware that unlocks cross-mode voice conversion between radio formats that need AMBE codecs.
- An AMBE dongle is a small hardware device that handles proprietary voice codecs used by some digital modes. OmniRef works same-mode with no dongle and no license fees. Cross-mode conversion is opt-in: attach a dongle locally, or reach one over the network, only if you want radios of different modes to talk to each other.
- Same-mode
- Everyone on a module uses the same digital voice format — no conversion hardware required.
- Same-mode operation means DMR talks to DMR, D-STAR to D-STAR, and so on. OmniRef does this out of the box with a single binary or Docker image. No AMBE dongle, no proprietary license fees, no special hardware beyond your radio or hotspot.
- Cross-mode
- Optional translation between digital voice formats so different radios can hear each other.
- Cross-mode conversion lets, for example, a DMR radio and a D-STAR radio share the same conversation. OmniRef treats this as opt-in. Attach an AMBE dongle on the same machine or remotely over the network when you need it. If you do not need cross-mode, leave it off.
- MCP (Model Context Protocol)
- A standard way for AI assistants to talk to tools and servers — check status, manage modules, and more.
- MCP is an open protocol that lets AI coding assistants and chat agents call structured tools. A planned OmniRef MCP server would let an assistant check reflector status, list modules, and help manage configuration — with your permission — instead of only reading docs. It pairs with AGENTS.md and SKILL.md so setup stays plain-English and automatable.
- AGENTS.md
- A file that tells coding assistants how to install, configure, and operate OmniRef safely.
- AGENTS.md is project documentation written for AI coding assistants (and humans). It explains how to install OmniRef, validate config, and avoid common mistakes. Pair it with SKILL.md for step-by-step skills an agent can follow.
- SKILL.md
- A reusable playbook an AI assistant can follow to install or configure OmniRef.
- SKILL.md files are focused instructions an agent can load when you ask it to set up or maintain OmniRef. They complement AGENTS.md with concrete steps: validate JSON Schema config, run the binary or Docker image, and verify modules.
- Hotspot
- A small device that connects your digital radio to the internet and onto a reflector.
- A hotspot bridges your handheld or mobile radio to the network. You configure it with the reflector address and module, then key up like any other digital contact. OmniRef is the server side of that link.
- AllStar
- A linking system for analog FM (and related) nodes over VoIP — supported as a mode in OmniRef.
- AllStar Link connects amateur radio nodes over the internet using VoIP. OmniRef treats AllStar as one of its supported modes alongside digital voice formats like DMR and D-STAR, so clubs can keep familiar linking patterns in the same reflector.
- JSON Schema config
- Configuration files checked against a schema, with `omniref validate` catching mistakes early.
- OmniRef uses JSON (with a JSON Schema) for configuration. That means editors and tools can autocomplete fields, and `omniref validate` can reject bad config before you go live. Clear schemas also help AI assistants configure the reflector correctly.