====== Things Needed: ======


  * SiteSync module and project installed 
  * URL of Things Industries server
  * AppID of Things app to add devices into
  * API Token registered with app
  * MQTT username and password registered with app

====== MQTT Connection  ======

 {{ :wiki:mqtt_integration.png?direct&400 |}}
{{ :wiki:ttnsitesyncmqtt.png?direct&400 |}}

  * Connection Name: a friendly name for this connection
  * Protocol: SSL or TCP, depending on your MQTT Broker connection
  * IP Address or URL to Listen at: Can be found in the MQTT integration portion of the app
  * MQTT Topic: the topic is strictly v3/{MQTT username}/devices/+/up
  * MQTT Username:  Can be found in the MQTT integration portion of the app
  * MQTT Password: Generated in the MQTT integration portion of the app.


===== Join Server =====

 
{{ :wiki:ttnjoinserversitesync.png?direct&400 |}}
  * Join Server: TTN
  * Join Server Address: The URL of your Things server
  * Application ID: The ID of the app you want to sync devices into
{{ :wiki:appidttn.png?direct&400 |}}

An API key with permissions to create and edit devices, and interact with downlinks must be created, the following is a sample of the permissions needed:
{{ :wiki:ttnapikey.png?direct&400 |}}
 


The Module will try to connect to your broker, and the status label will update with the connection attempts results. Full logs can be found under Data/Diagnostics, searching the term BROKER to see logs related to connecting.