For the complete documentation index, see llms.txt. This page is also available as Markdown.

Verify the First Uplink

Verify the first MIOTY uplink in KiloCenter — confirm data from endpoint through base station to KC-Web.

The first uplink shows that your MIOTY endpoint's message has reached KiloCenter through a base station. Verifying this path is the handoff from registering equipment to receiving data your application can use.

An endpoint is the communicating sensor or device, and a base station is its radio gateway. Check the fresh message and payload in the service center before connecting the traffic to an application through gRPC or MQTT.

Use this guide after connecting a base station and registering the endpoint with matching keys. The endpoint must be transmitting. Inspect the message time and payload to confirm new traffic, rather than relying only on a saved device record or an online base station.

What does this guide achieve?

Confirm that uplink data travels end-to-end from an endpoint through a base station to KiloCenter.

Prerequisites

  • At least one base station connected and online

  • At least one endpoint registered with matching keys (see Register an Endpoint)

  • The endpoint is transmitting data

  1. Open KC-Web at http://localhost/ (container) or http://localhost:5173 (source dev).

  2. Open End Points and select your endpoint. Its Activity tab lists the endpoint's events and uplinks in one table, newest first, with the same columns as the Events Log: each uplink is an ulData row showing its opId, the base stations that received it, and "Uplink #" with the packetCnt over its rssi, snr, eqSnr, the dlOpen/dlAck flags and the payload size. Expand an uplink for every base station's reception and its subpackets, the ulData message and, when a blueprint decoded it, the decoded payload. A base station's Activity tab shows the same for the uplinks that station heard, each named by its endpoint, and exports them as CSV or JSON.

  3. Open the Traffic tab. Uplink Events lists each uplink with rxTime, the receiving bsEui, packetCnt, snr, rssi, eqSnr, the dlOpen, responseExp, dlAck and duplicate flags and userData in hex; expand a row for every base station's reception and its subpackets.

  4. To see the uplinks of every endpoint at once, open Traffic in the navigation.

The Traffic page on Uplink Events with filters and a table of uplinks with dlAck and dlOpen flags
An expanded uplink showing the receiving base stations and the ulData JSON message

If uplinks appear here, your uplink path is working end-to-end. New uplinks appear without a page reload.

Check KC-Core Logs

Look for ulData entries that include your endpoint's EUI. These log lines confirm KC-Core received and processed the uplink from the base station.

Programmatic Verification (Optional)

You can also verify uplinks through the gRPC API:

Troubleshooting

Symptom
Likely Cause

No messages in KC-Web

Endpoint not transmitting, or not attached by any base station

Messages appear in logs but not in KC-Web

Browser cache or KC-Web not connected to KC-Gateway

ulData errors in logs

Network session key mismatch or endpoint not registered

RSSI/SNR values missing

Base station firmware not reporting radio metadata

Last updated