Antennas
Antennas are the BLE signal receivers installed in the site's zones. Each antenna captures the BLE advertisements emitted by the beacons and sends them to the server via MQTT for location calculation — the antenna itself acts as a gateway (BLE → MQTT), with no need for an intermediary device.
Iongrade's field antenna is the Radium Gateway. ION Guard is also compatible with third-party BLE gateways — currently the Minew MG4C —, which act as antennas in the same way.
On this page, antenna is the generic term for the Synapsys module's field device. Iongrade's antenna is the Radium Gateway; the Minew MG4C is a compatible third-party gateway. The instructions apply to both, except where indicated (e.g., the scan parameters specific to Minew gateways).
Antenna status
| Status | Indicator | Meaning |
|---|---|---|
| Pending | Gray | Registered but has not connected yet |
| Online | Green (pulsing) | Receiving and transmitting signals |
| Offline | Red | Stopped transmitting signals |
| Maintenance | Blue | Temporarily offline for scheduled maintenance |
Antenna list
The Antennas page (/antennas) displays all antennas of the selected site:
- Hardware ID — Unique device identifier (MAC address)
- Label — Friendly name
- Status — With a visual indicator (pulsing dot when online)
- Zone — Assigned zone (or "Not assigned")
- Last signal — When the antenna was last seen
Available filters
- Search by hardware ID or label
- Status: Pending, Online, Offline, Maintenance
- Sorting by hardware ID, label, or last signal
Register an antenna
- In the antenna list, click "Add Antenna"
- Fill out the form:
| Field | Required | Description |
|---|---|---|
| Hardware ID | Yes | Gateway MAC address (e.g., AC233FC22C94). Unique per site |
| Driver | Yes | Compatible hardware driver (e.g., Minew MG4C Gateway) |
| Label | Yes | Friendly name (e.g., "Antenna - North Reception"). Max. 255 characters |
| Gateway IP | No | Gateway IP address on the local network (e.g., 192.168.1.100). Required for automatic provisioning |
| Zone | No | Zone the antenna is associated with. Can be assigned later |
- Click "Save"
Check the server's ARP table (arp -a) or the router panel to find the gateway IP by its MAC address. Minew gateways appear with a hostname in the format MG4C-xxxxxx.
Gateway configuration
After registering the antenna, it needs to be configured to send data to the ION Guard server via MQTT. There are two ways to do this:
Automatic provisioning (recommended)
ION Guard can configure the gateway automatically via its local HTTP API. This method is available when the server and the gateway are on the same network (on-premises installations).
- On the antenna details page, verify that the Gateway IP field is filled in
- Click the "Provision Gateway" button
- The system checks whether the gateway is reachable and displays its information (model, version, battery)
- Confirm by clicking "Provision"
Provisioning automatically performs:
- Generation of unique MQTT credentials (username + password)
- Sending the full configuration to the gateway (MQTT broker, topics, scan parameters)
- Rebooting the gateway to apply the settings
After ~10 seconds, the gateway reconnects to the MQTT broker and starts sending data. The status changes from Pending to Online.
When you re-provision an antenna that has already been configured, the previous credentials are invalidated. The gateway will automatically receive new credentials.
Manual configuration
For gateways that are not reachable over the network (e.g., SaaS installations where the server is in the cloud), configuration must be done manually:
- Click "Generate MQTT Credentials" to obtain a username and password
- Click the MQTT info button to view the connection parameters
- Access the gateway's web interface (e.g.,
http://192.168.1.100) and configure:
| Parameter | Value |
|---|---|
| MQTT URL | mqtt://{ip-do-servidor}:{porta} |
| Client ID | Antenna hardware ID (e.g., AC233FC22C94) |
| Username | Value generated by the system |
| Password | Value generated by the system |
| Publish Topic | ionguard/{hardware_id}/signals |
| Subscribe Topic | ionguard/{hardware_id}/to |
| Response Topic | ionguard/{hardware_id}/from |
| QoS | 1 |
| Keep Alive | 30 seconds |
The MQTT password is displayed only once at the moment it is generated. If you lose it, generate new credentials.
Scan parameters (Minew gateways)
Automatic provisioning configures the following default BLE scan parameters:
| Parameter | Value | Description |
|---|---|---|
| Upload Interval | 5s | Interval for sending data to the server |
| Scan Interval | 100ms | Interval between BLE scans |
| Scan Window | 100ms | Scan window (100% = continuous scan) |
| Active Scan | Yes | Captures advertising + scan response packets |
| RSSI Filter | -90 dBm | Ignores signals weaker than -90 dBm (noise) |
| MAC Filter | ^AC233F.*|^C30000.* | Filters only Minew beacons |
| NTP Server | br.pool.ntp.org | Brazilian time server |
| Timezone | UTC+3 | Brasília time |
Zone assignment
The zone assigned to an antenna determines which zone the Location Engine considers when that antenna receives a beacon signal. Therefore:
- Each antenna must be assigned to exactly one zone
- A zone can have multiple antennas (improves accuracy)
- Antennas without an assigned zone do not contribute to location calculation
To assign or change the zone, edit the antenna and select the zone from the dropdown.
Antenna details
When you click an antenna, the details page displays:
- General information — Label, hardware ID, driver, status, assigned zone
- Gateway IP — IP address on the local network
- Gateway Status —
Configured on {data}when provisioned - MQTT Configuration — Connection data for reference
Available actions
| Button | Function |
|---|---|
| Provision Gateway | Automatically configures the gateway (generates credentials + sends config + reboot) |
| MQTT Guide | Displays the MQTT connection parameters for manual configuration |
| Generate Credentials | Generates or regenerates MQTT credentials (without configuring the gateway) |
| Edit | Changes label, zone, and gateway IP |
| Delete | Removes the antenna and its MQTT credentials |
Edit an antenna
On the details page, click "Edit". You can change:
- Label — Friendly name
- Gateway IP — IP address on the local network
- Zone — Assign, change, or remove the zone
Delete an antenna
In the list or on the details page, click "Delete". A confirmation dialog appears. Deleting disassociates the antenna from the zone and removes the record.
Troubleshooting
Gateway does not connect after provisioning
- Check whether the gateway restarted (the LED blinks during boot)
- Wait ~15 seconds for the MQTT connection to be established
- Check the MQTT logs:
docker logs ionguard_mosquitto_{deploy} | tail -20 - Confirm that the firewall allows the MQTT port (1883)
"Provision" button disabled
The button is disabled when the Gateway IP field is not filled in. Edit the antenna and add the IP.
Gateway responds but does not send data
- Check whether the MQTT credentials are correct:
docker logs ionguard_mosquitto_{deploy} | grep {hardware_id} - If "not authorised" appears, generate new credentials via provisioning
- Check the MAC filter (
regex_mac) — only Minew beacons (AC233F*) are captured by default