De TTN LoRa Sandbox is bedoeld voor iedereen die wil leren en experimenteren met LoRaWAN in een laagdrempelige en risicovrije omgeving. Allereerst dient u zich via de link aan te melden, maak een gratis account aan als u dat nog niet heeft: www.thethingsnetwork.org/get-started

Hier kunt u uw applicatie(s) en gateway(s) aanmaken/beheren.

Klik op Europe 1 cluster: Thethingsnetwork Console

Start met de aanmaak van uw eerste applicatie. Elke applicatie moet een unieke ID krijgen, mocht de door u opgegeven ID al gebruikt zijn door iemand dan krijgt u daar een melding van en dient u iets anders te verzinnen. Ook geeft u er een naam aan en kunt u er eventueel een omschrijving bijzetten. Een voorbeeld: 

• ID: hcc-homeassistant
• Naam: Mijn HomeAssistant LoRa applicatie
• Omschrijving: Mijn LoRa avontuur

U kunt aan een applicatie meerdere LoRa sensoren toevoegen, dat hoeft niet allemaal in één keer natuurlijk.

In het hoofdmenu ziet u een aantal onderdelen, u kunt nu uw nieuwe LoRa sensor toevoegen. Dat kan zowel via het Overview menu als via het End devices menu.U zult daar in het begin geen devices zien, maar zodra u een nieuwe LoRa sensor toevoegt zult u deze zien verschijnen.

Laten we nu de LoRa sensor toevoegen, klik op Register end device.

Selecteer in de diverse keuze-lijsten de items zoals weergegeven in de bovenstaande afbeelding. De weergegeven Region moet overeenkomen met de werkfrequentie van de hardware. Het weergegeven Frequency plan wordt aanbevolen. Meer info over de diverse opties kunt u vinden via de bijbehorende vraagtekens.

Nadat u dit gedaan heeft dient u een hexadecimale code in het JoinEUI (App-EUI) veld in te vullen. De LDS02 wordt fabrieksmatig aangeleverd met geregistreerde codes, deze kunt u vinden op een sticker in het doosje van uw LDS02. Om uw LDS02 te kunnen registreren dient u deze codes gebruiken en moet u dus zelf geen codes verzinnen of genereren!

Zoals u hierboven ziet is het mogelijk om de DevEUI en de AppKey te genereren, dit kunt u bijvoorbeeld doen voor een TTGO T-Beam of ander mooi LoRa apparaatje waarbij dat niet al fabrieksmatig is ingebakken. Als laatste dient u nog een End device ID te verzinnen en in te vullen en op Register end device te klikken. Als u dit allemaal uitgevoerd heeft dan bent u gereed om de LoRa sensor te koppelen: haal de 2 AAA-batterijen even uit de sensor en plaats ze weer terug, u ziet dan even het ledje in verschillende kleuren oplichten en zodra het ledje als laatste groen was en weer uit gaat dan is de sensor als het goed is gekoppeld. In het Live data tabblad zult u allerlei gegevens zien binnen komen op volgorde van datum&tijd. In onderstaande afbeelding een voorbeeld:

Wat we het meest interessant vinden zijn natuurlijk de sensor gegevens, in het geval van onze sensor zijn dat de temperatuur, Lux, vochtgehalte en de status van de interne batterij. Dit alles wordt verpakt in de payload:

Nu kunt u uw LoRa sensor data altijd bekijken in uw TTN Sandbox maar het is natuurlijk wel zo leuk als we de sensoren ook daadwerkelijk ergens voor kunnen gebruiken, het TTN platform biedt hiervoor diverse integraties aan. Om zo'n integratie te kunnen gebruiken hebben we in ieder geval een API key nodig. Deze kunnen we aanmaken via het API keys menu aan de linkerkant van de TTN console (zie afbeelding bij stap4). Geef de API key een naam, vul de gewenste verloopdatum in en vink alleen onderstaande opties aan. De optie View application information is hierbij optioneel.

Klik vervolgens op Create API key, het volgende scherm zal verschijnen:

U kunt nu de aangemaakte API key kopiëren en ergens veilig opslaan voor later gebruik.

Laten we nu even naar de MQTT gegevens kijken, deze zijn te vinden via het Integrations->MQTT menu aan de linkerkant:

U ziet dat alle benodigde gegevens al zijn ingevuld. Desgewenst kunt u een nieuw MQTT wachtwoord aanmaken door op de knop Generate new API key te klikken maar dat is eigenlijk niet nodig omdat we in de vorige stap al een hiervoor geschikte API key hebben aangemaakt.

U kunt met uw MQTT applicatie op twee manieren een verbinding met de TTN MQTT server maken: onversleuteld via poort 1883 en versleuteld via poort 8883 (TLS). Wellicht handig als u eerst even de verbinding met de MQTT server test, bijvoorbeeld met het mqtt-explorer programma.

Als u alle stappen met succes heeft doorlopen dan is het nu tijd dat we de sensor data daadwerkelijk gaan gebruiken. We nemen even aan dat u HomeAssistant gebruikt en dat u bekend bent met MQTT en dat ook al gebruikt.

De data van de TTN MQTT server kunt u binnen halen op een aantal manieren.

Met behulp van YAML:

Zet de volgende code in configuration.yaml en herstart HomeAssistant:

mqtt:
broker: eu1.cloud.thethings.network
port: 1883
username: "[TTN Applicatie ID]"
password: "[API key]"
discovery: true
discovery_prefix: homeassistant

Uiteraard dient u wel even uw TTN Applicatie ID en API key in te vullen.

Met behulp van de HomeAssistant thethingsnetwork integratie:

https://www.home-assistant.io/integrations/thethingsnetwork

(mooi maar te traag voor bijvoorbeeld een magneetcontact)

Met behulp van de NODERED MQTT node:

https://flows.nodered.org/node/node-red-contrib-cayenne-mqtt-client