Platform Provisioning

Before programming your hardware, you must establish its digital twin on the Favoriot platform:

1. Register an account on the Favoriot Platform at platform.favoriot.com
2. Log into the Favoriot Platform Dashboard.
3. Create a Project, followed by an Application, and a Group.
4. Create a Device under your group.
5. Note down the Device Developer ID (e.g., deviceDefault@myproject) and the auto-generated Device Access Token.

Constructing the Payload

Your device or gateway must format its payload as a valid JSON object. The core keys are defined below:

• device_developer_idString identifying your registered device.
• dataObject containing an arbitrary number of key-value parameters.

{
  // Example payload
  "device_developer_id": "deviceDefault@myproject",
  "data": {
    "temperature": 26.5,
    "humidity": 62,
    "battery": 94,
    "status": "active"
  }
}

Protocol Integration & Code Implementation

Integrating via REST API (HTTP)

• Endpointhttps://api.favoriot.com/v2/streams
• MethodPOST
• HeadersContent-Type: application/json, apikey: YOUR_DEVICE_ACCESS_TOKEN

curl -X POST https://apiv2.favoriot.com/v2/streams \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_DEVICE_ACCESS_TOKEN" \
  -d '{"device_developer_id":"deviceDefault@myproject", "data":{"temperature":26.5}}'

Integrating via MQTT

• Broker Hostmqtt.favoriot.com
• Ports1883 (Non-secure)  |  8883 (Secure TLS/SSL)
• CredentialsUsername & Password are both set to your YOUR_DEVICE_ACCESS_TOKEN
• Publish TopicYOUR_DEVICE_ACCESS_TOKEN/v2/streams
• Subscribe TopicYOUR_DEVICE_ACCESS_TOKEN/v2/streams/status

mosquitto_pub -h mqtt.favoriot.com -p 1883 \
  -u "YOUR_DEVICE_ACCESS_TOKEN" -P "YOUR_DEVICE_ACCESS_TOKEN" \
  -t "YOUR_DEVICE_ACCESS_TOKEN/v2/streams" \
  -m "{\"device_developer_id\":\"deviceDefault@myproject\",\"data\":{\"humidity\":\"60\"}}"

Verification & Data Validation

1. Telemetry Check — Go to the Device Data or Streams tab on the Favoriot Dashboard to verify values in real-time.
2. Data Graphing — Build a temporary line widget or gauge to confirm numbers parse accurately.

Gateway / Edge Translation (If Applicable)

For LoRaWAN, Zigbee, or Bluetooth gateways:

1. Program the gateway to parse incoming peripheral packets (binary/Hex).
2. Pack decoded variables into the standard Favoriot JSON format at the edge.
3. Forward the translated JSON payload using the REST or MQTT setups documented above.