Skip to content

Latest commit

 

History

History
83 lines (73 loc) · 2.34 KB

README.md

File metadata and controls

83 lines (73 loc) · 2.34 KB
Raw

sensor-data-bridge

Bridge software for receiving airborne particulate matter data from TheThingsNetwork and forwarding it to sensor.community, opensense

Forwarding to sensor.community and other dashboards is controlled through TTN device attributes, which can be configured for each device in the TheThingsNetwork console:

  • sensor.community
    • attribute 'senscom-id' contains the sensor.community hardware id
  • opensense.org
    • attribute 'opensense-id'

Several data encodings are supported:

  • Cayenne encoding, PM is encoded as analog data, PM10 in channel 1, PM2.5 in channel 2, PM4.0 in channel 4 and PM1.0 in channel 0.
  • JSON encoding, the configuration file specifies how JSON fields map to measurement properties
  • SPS30 encoding, a custom encoding for SPS30 sensors, includes the particle count

Experimental support for Helium LoRaWAN, NB-IOT. Possible future support for Sigfox.

Configuration

TheThingsNetwork configuration

The application requires an application API key with the following individual rights:

  • View devices in application
  • View application information
  • Read application traffic (uplink and downlink)

TTN API key

Make sure to copy/save it to another place immediately after creating in on the TTN console.

Application configuration

Application example config file (YAML):

---
ttn:
  mqtt_url: "tcp://eu1.cloud.thethings.network"
  identity_server_url: "https://eu1.cloud.thethings.network"
  identity_server_timeout: 30
  apps:
  - name: "particulatematter"
    key: "secret"
    decoder:
      encoding: "CAYENNE"
      properties: ""
  - name: "ttn-hittestress"
    key: "secret"
    decoder:
      encoding: "JSON"
      properties:
      - path: "/pm10"
        item: "PM10"
      - path: "/pm2p5"
        item: "PM2_5"
      - path: "/rh"
        item: "HUMIDITY"
      - path: "/temp"
        item: "TEMPERATURE"
  - name: "ttn-soundkit"
    key: "secret"
    decoder:
      encoding: "JSON"
      properties:
      - path: "/la/min"
        item: "NOISE_LA_MIN"
      - path: "/la/avg"
        item: "NOISE_LA_EQ"
      - path: "/la/max"
        item: "NOISE_LA_MAX"
nbiot:
  port: 9000
senscom:
  url: "https://api.sensor.community"
  timeout: 30
opensense:
  url: "https://api.opensensemap.org"
  timeout: 30
geolocation:
  url: "https://location.services.mozilla.com"
  timeout: 30
  apikey: "test"