Device Endpoints
The hosts, protocols and ports devices connect to when they push data to Perspio.
Devices that push data to Perspio connect to one of four endpoints, depending on the device family. The ingress connector you enable determines which one your devices use, and its onboarding instructions in the Perspio web app give the settings for that family.
Devices that Perspio collects from by polling a vendor's API, which is most connectors, don't connect to any of these. See Connectors for the difference between pull and push.
Endpoints
| Protocol | AU | US | Dev |
|---|---|---|---|
| MQTT | mqtt.perspio.io | us-mqtt.perspio.io | mqtt.perspio.dev |
| TCP | tcp.perspio.io | us-tcp.perspio.io | tcp.perspio.dev |
| UDP | udp.perspio.io | us-udp.perspio.io | udp.perspio.dev |
| Azure IoT Hub | ingress.perspio.io | us-ingress.perspio.io | ingress.perspio.dev |
Use the endpoint for the region your tenant is hosted in. Dev is a test environment you can point devices at before connecting them to production. See Network Endpoints for the rest of Perspio's hosts.
MQTT
Devices publish to port 1883. Each device family has its own topic.
| Device family | Topic |
|---|---|
| Senquip | devices/SENQUIP/# |
| Milesight | devices/MILESIGHT/# |
| Lenze | devices/LENZE/# |
TCP
Each device family has its own port.
| Device family | Port |
|---|---|
| Teltonika | 10050 |
| Deep Sea Electronics (DSE) | 11000 |
| Topfly | 12000 |
UDP
| Device family | Port |
|---|---|
| Positioning Universal (PUI) | 11500 |
Azure IoT Hub
Devices provisioned as IoT Hub device identities connect on the standard IoT Hub ports.
| Port | Protocol |
|---|---|
8883 | MQTT |
5671 | AMQP |
443 | MQTT and AMQP over WebSockets, and HTTPS |
Allowing Perspio through your network
Devices need outbound access to the endpoint and port for their family. The IP addresses behind these hostnames are dynamic, so allow them by hostname rather than by IP address.
Need help connecting a device?Contact [email protected] with the device make and model, and we'll confirm the endpoint, port and credentials for it.
Updated 1 day ago