<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="fr">
	<id>https://wiki.alseno.tech/index.php?action=history&amp;feed=atom&amp;title=The_Things_Network_%28TTN%29</id>
	<title>The Things Network (TTN) - Historique des versions</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.alseno.tech/index.php?action=history&amp;feed=atom&amp;title=The_Things_Network_%28TTN%29"/>
	<link rel="alternate" type="text/html" href="https://wiki.alseno.tech/index.php?title=The_Things_Network_(TTN)&amp;action=history"/>
	<updated>2026-11-20T20:11:23Z</updated>
	<subtitle>Historique des versions pour cette page sur le wiki</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://wiki.alseno.tech/index.php?title=The_Things_Network_(TTN)&amp;diff=52&amp;oldid=prev</id>
		<title>Robot-agri : Alseno Tech : accueil et portail Agritech</title>
		<link rel="alternate" type="text/html" href="https://wiki.alseno.tech/index.php?title=The_Things_Network_(TTN)&amp;diff=52&amp;oldid=prev"/>
		<updated>2026-11-20T19:42:26Z</updated>

		<summary type="html">&lt;p&gt;Alseno Tech : accueil et portail Agritech&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Nouvelle page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;= The Things Network (TTN) =&lt;br /&gt;
The Things Network (TTN) est un réseau LoRaWAN communautaire et gratuit pour démarrer. Il reçoit les messages relayés par les passerelles, vérifie et déchiffre ceux de vos appareils, puis vous les remet décodés. C&amp;#039;est le « serveur réseau » de la chaîne décrite dans [[Chaîne de données]].&lt;br /&gt;
&lt;br /&gt;
Site : https://www.thethingsnetwork.org — console de la région Europe : https://eu1.cloud.thethings.network&lt;br /&gt;
&lt;br /&gt;
== Les objets de la console ==&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Application&amp;#039;&amp;#039;&amp;#039; : le regroupement de vos appareils. Elle porte les formateurs de charge utile, les webhooks et les clés d&amp;#039;accès MQTT.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Appareil (end device)&amp;#039;&amp;#039;&amp;#039; : un capteur. Il a trois identifiants : &amp;lt;code&amp;gt;&amp;lt;DEV_EUI&amp;gt;&amp;lt;/code&amp;gt; (propre à l&amp;#039;appareil), &amp;lt;code&amp;gt;&amp;lt;JOIN_EUI&amp;gt;&amp;lt;/code&amp;gt; (souvent des zéros) et la clé &amp;lt;code&amp;gt;&amp;lt;APP_KEY&amp;gt;&amp;lt;/code&amp;gt; (secrète).&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Passerelle (gateway)&amp;#039;&amp;#039;&amp;#039; : votre [[Passerelle LoRaWAN|passerelle]] déclarée, pour que TTN accepte ses messages.&lt;br /&gt;
&lt;br /&gt;
== Rejoindre le réseau : OTAA ==&lt;br /&gt;
L&amp;#039;activation OTAA (&amp;#039;&amp;#039;over-the-air activation&amp;#039;&amp;#039;) est la méthode à utiliser. L&amp;#039;appareil envoie une demande de « join » signée avec sa clé, TTN répond par une acceptation, et les deux calculent les clés de session. Le « join » est refait automatiquement si besoin.&lt;br /&gt;
&lt;br /&gt;
Étapes :&lt;br /&gt;
# créer l&amp;#039;application ;&lt;br /&gt;
# enregistrer l&amp;#039;appareil avec le plan de fréquences « Europe 863–870 MHz (SF9 for RX2 – recommended) » et la version LoRaWAN 1.0.x ;&lt;br /&gt;
# copier &amp;lt;code&amp;gt;&amp;lt;DEV_EUI&amp;gt;&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;&amp;lt;JOIN_EUI&amp;gt;&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;&amp;lt;APP_KEY&amp;gt;&amp;lt;/code&amp;gt; dans le micrologiciel ;&lt;br /&gt;
# vérifier le « join » &amp;#039;&amp;#039;&amp;#039;à l&amp;#039;établi&amp;#039;&amp;#039;&amp;#039;, en regardant le port série, avant de partir sur le terrain.&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Piège : l&amp;#039;ordre des octets.&amp;#039;&amp;#039;&amp;#039; Dans le micrologiciel LMIC, le DevEUI et le JoinEUI se saisissent dans l&amp;#039;ordre inverse de la console (poids faible d&amp;#039;abord) ; l&amp;#039;AppKey, dans l&amp;#039;ordre affiché. Se tromper est la cause numéro un de « join » silencieux. Un petit script qui écrit les clés dans le croquis en inversant ce qu&amp;#039;il faut évite l&amp;#039;erreur.&lt;br /&gt;
&lt;br /&gt;
== Le formateur de charge utile ==&lt;br /&gt;
Le capteur envoie des octets ; le formateur (&amp;#039;&amp;#039;payload formatter&amp;#039;&amp;#039;) les transforme en valeurs lisibles (JSON). Il s&amp;#039;écrit en JavaScript dans la console, onglet &amp;#039;&amp;#039;Payload formatters&amp;#039;&amp;#039; (voir l&amp;#039;exemple b du [[Kit de démarrage]]).&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Piège : un formateur d&amp;#039;application s&amp;#039;applique à TOUS les appareils de l&amp;#039;application.&amp;#039;&amp;#039;&amp;#039; Chez nous, le formateur du capteur de sol traitait aussi un nœud de relevé de couverture : le compteur de paquets de 2 octets de ce dernier est ressorti comme « humidité du sol = 100 » et « température = compteur ÷ 10 ». 130 fausses mesures sont entrées en base en 40 minutes avant qu&amp;#039;on le voie. Parades, à cumuler :&lt;br /&gt;
* ne décoder qu&amp;#039;un port précis et un format reconnu (identifiant au début de la trame, longueur attendue), et renvoyer une erreur sinon ;&lt;br /&gt;
* définir le formateur sur l&amp;#039;appareil plutôt que sur l&amp;#039;application ;&lt;br /&gt;
* côté base de données, distinguer les capteurs des appareils de test (voir [[Chaîne de données]]).&lt;br /&gt;
&lt;br /&gt;
Autre leçon : un décodeur peut être faux. Conservez toujours la trame brute pour pouvoir tout recalculer.&lt;br /&gt;
&lt;br /&gt;
== Sortir les données de TTN ==&lt;br /&gt;
Deux voies, qui peuvent coexister.&lt;br /&gt;
&lt;br /&gt;
=== Webhook (TTN appelle votre API) ===&lt;br /&gt;
Dans &amp;#039;&amp;#039;Integrations → Webhooks&amp;#039;&amp;#039;, un &amp;#039;&amp;#039;custom webhook&amp;#039;&amp;#039; envoie chaque message montant à une adresse HTTPS, avec un en-tête d&amp;#039;authentification que vous choisissez. L&amp;#039;exemple c du [[Kit de démarrage]] est un récepteur complet. Points d&amp;#039;attention :&lt;br /&gt;
* répondez &amp;#039;&amp;#039;&amp;#039;toujours 200&amp;#039;&amp;#039;&amp;#039; aux messages que vous ne comprenez pas ou déjà reçus : si votre serveur renvoie des erreurs, TTN réessaie puis finit par désactiver le webhook ;&lt;br /&gt;
* ne répondez une erreur (401) qu&amp;#039;en cas d&amp;#039;authentification invalide, et 500 en cas de vraie panne ;&lt;br /&gt;
* l&amp;#039;URL doit être joignable depuis Internet, en HTTPS.&lt;br /&gt;
Au début de nos essais, un webhook configuré ne livrait rien (cause non élucidée) ; nous sommes passés par MQTT ; les deux voies ont ensuite servi à alimenter l&amp;#039;API.&lt;br /&gt;
&lt;br /&gt;
=== MQTT (vous allez chercher les messages) ===&lt;br /&gt;
TTN expose un broker MQTT par région : hôte &amp;lt;code&amp;gt;eu1.cloud.thethings.network&amp;lt;/code&amp;gt;, utilisateur &amp;lt;code&amp;gt;&amp;lt;APP_ID&amp;gt;@ttn&amp;lt;/code&amp;gt;, mot de passe = une &amp;#039;&amp;#039;&amp;#039;clé d&amp;#039;API&amp;#039;&amp;#039;&amp;#039; de l&amp;#039;application. Le sujet des messages montants est &amp;lt;code&amp;gt;v3/&amp;lt;APP_ID&amp;gt;@ttn/devices/&amp;lt;DEVICE_ID&amp;gt;/up&amp;lt;/code&amp;gt;. Créez une clé d&amp;#039;API par usage, avec le droit minimal (par exemple &amp;#039;&amp;#039;read application traffic&amp;#039;&amp;#039; seulement), pour pouvoir la révoquer seule. Un pont MQTT local (un broker Mosquitto qui relaie ce sujet vers votre réseau) permet de brancher un système domotique sans ouvrir de port.&lt;br /&gt;
&lt;br /&gt;
== Limites d&amp;#039;usage équitable ==&lt;br /&gt;
TTN limite le temps d&amp;#039;antenne montant à environ 30 secondes par jour et par appareil et les messages descendants à 10 par jour. Un capteur de sol qui envoie 7 octets toutes les 10 minutes en SF7 (144 messages × 0,057 s ≈ 8 s) reste très en dessous.&lt;br /&gt;
&lt;br /&gt;
== Quand quitter TTN ? ==&lt;br /&gt;
Pour un réseau qui grandit ou des données sensibles, on peut héberger soi-même un serveur réseau (ChirpStack). La migration demande de ré-enregistrer les appareils. À petite échelle, TTN suffit.&lt;br /&gt;
&lt;br /&gt;
== Exemples de code ==&lt;br /&gt;
Formateur de charge utile et récepteur de webhook (voir aussi le [[Kit de démarrage]]).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;javascript&amp;quot;&amp;gt;&lt;br /&gt;
// Formateur de charge utile TTN (montante) — exemple de démarrage (Alseno Tech, licence MIT).&lt;br /&gt;
// À coller dans : console TTN &amp;gt; Application &amp;gt; Payload formatters &amp;gt; Uplink &amp;gt; JavaScript.&lt;br /&gt;
//&lt;br /&gt;
// PIÈGE : un formateur défini au niveau de l&amp;#039;APPLICATION s&amp;#039;applique à TOUS les appareils&lt;br /&gt;
// de cette application (capteurs, mouchards de couverture, tests...). Un appareil qui n&amp;#039;a&lt;br /&gt;
// rien à voir recevrait des « mesures » inventées. Deux protections ci-dessous :&lt;br /&gt;
//   1. on ne décode que le port PORT_SOL ;&lt;br /&gt;
//   2. on exige l&amp;#039;octet d&amp;#039;identification 0xA1 et la bonne longueur ; sinon on répond par une erreur,&lt;br /&gt;
//      jamais par des valeurs plausibles.&lt;br /&gt;
// Mieux encore : définissez le formateur sur l&amp;#039;appareil lui-même (onglet Payload formatters&lt;br /&gt;
// de l&amp;#039;appareil), il ne touche alors que celui-là.&lt;br /&gt;
&lt;br /&gt;
var PORT_SOL = 10;&lt;br /&gt;
var ID_FORMAT = 0xA1;&lt;br /&gt;
var LONGUEUR = 7;&lt;br /&gt;
&lt;br /&gt;
// Calibration de VOTRE sonde (voir la page « Capteur de sol ») : valeur brute dans l&amp;#039;air / dans l&amp;#039;eau.&lt;br /&gt;
var BRUT_SEC = 870;      // sonde à l&amp;#039;air libre : 0 %&lt;br /&gt;
var BRUT_HUMIDE = 560;   // sonde dans l&amp;#039;eau : 100 %  (une sonde capacitive donne MOINS quand c&amp;#039;est plus humide)&lt;br /&gt;
&lt;br /&gt;
function decodeUplink(input) {&lt;br /&gt;
  var b = input.bytes;&lt;br /&gt;
&lt;br /&gt;
  if (input.fPort !== PORT_SOL) {&lt;br /&gt;
    return { errors: [&amp;quot;port &amp;quot; + input.fPort + &amp;quot; non géré par ce formateur&amp;quot;] };&lt;br /&gt;
  }&lt;br /&gt;
  if (b.length !== LONGUEUR || b[0] !== ID_FORMAT) {&lt;br /&gt;
    return { errors: [&amp;quot;trame inconnue (longueur &amp;quot; + b.length + &amp;quot;)&amp;quot;] };&lt;br /&gt;
  }&lt;br /&gt;
&lt;br /&gt;
  var brut = (b[1] &amp;lt;&amp;lt; 8) | b[2];&lt;br /&gt;
  var tempBrute = (b[3] &amp;lt;&amp;lt; 8) | b[4];&lt;br /&gt;
  if (tempBrute &amp;amp; 0x8000) tempBrute -= 0x10000;      // entier signé sur 16 bits&lt;br /&gt;
  var vccMv = (b[5] &amp;lt;&amp;lt; 8) | b[6];&lt;br /&gt;
&lt;br /&gt;
  // Conversion brut -&amp;gt; pourcentage, bornée entre 0 et 100.&lt;br /&gt;
  var pct = 100 * (BRUT_SEC - brut) / (BRUT_SEC - BRUT_HUMIDE);&lt;br /&gt;
  pct = Math.max(0, Math.min(100, Math.round(pct)));&lt;br /&gt;
&lt;br /&gt;
  var data = { sol_brut: brut, sol_pct: pct, batterie_mv: vccMv };&lt;br /&gt;
  if (tempBrute !== -32768) data.temperature_c = tempBrute / 100;   // 0x8000 = « pas de mesure »&lt;br /&gt;
  return { data: data };&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
#!/usr/bin/env python3&lt;br /&gt;
&amp;quot;&amp;quot;&amp;quot;Récepteur minimal de webhook TTN : stocke les mesures dans SQLite.&lt;br /&gt;
&lt;br /&gt;
Exemple de démarrage (Alseno Tech, licence MIT). Une seule dépendance : Flask.&lt;br /&gt;
&lt;br /&gt;
    pip install flask&lt;br /&gt;
    export CLE_INGESTION=&amp;quot;&amp;lt;CLE_A_CHOISIR&amp;gt;&amp;quot;      # longue chaîne aléatoire, à vous&lt;br /&gt;
    python recepteur_webhook.py&lt;br /&gt;
&lt;br /&gt;
Dans la console TTN : Integrations &amp;gt; Webhooks &amp;gt; Custom webhook&lt;br /&gt;
    URL de base : https://&amp;lt;URL_API&amp;gt;      chemin montant : /ttn&lt;br /&gt;
    En-tête     : X-Ingest-Key = &amp;lt;CLE_A_CHOISIR&amp;gt;&lt;br /&gt;
(Exposez le service derrière HTTPS : proxy inverse, tunnel...)&lt;br /&gt;
&lt;br /&gt;
Choix de conception, tirés de l&amp;#039;expérience :&lt;br /&gt;
  * on répond TOUJOURS 200 aux charges inattendues ou déjà vues : un webhook qui reçoit&lt;br /&gt;
    des erreurs réessaie, puis TTN finit par le désactiver. Seules l&amp;#039;authentification&lt;br /&gt;
    (401) et une vraie panne (500) échouent ;&lt;br /&gt;
  * on garde la charge d&amp;#039;origine (colonne brut) : un décodeur peut être faux, et sans le&lt;br /&gt;
    brut on ne peut rien rejouer ;&lt;br /&gt;
  * un doublon (même appareil, même compteur de trame, même heure) est ignoré proprement.&lt;br /&gt;
&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
import hmac&lt;br /&gt;
import json&lt;br /&gt;
import os&lt;br /&gt;
import sqlite3&lt;br /&gt;
&lt;br /&gt;
from flask import Flask, jsonify, request&lt;br /&gt;
&lt;br /&gt;
BASE = os.environ.get(&amp;quot;BASE_SQLITE&amp;quot;, &amp;quot;mesures.db&amp;quot;)&lt;br /&gt;
CLE = os.environ.get(&amp;quot;CLE_INGESTION&amp;quot;, &amp;quot;&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
app = Flask(__name__)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
def ouvrir_base():&lt;br /&gt;
    &amp;quot;&amp;quot;&amp;quot;Ouvre la base et crée les tables au premier appel (mode WAL : lecture pendant l&amp;#039;écriture).&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
    cnx = sqlite3.connect(BASE)&lt;br /&gt;
    cnx.execute(&amp;quot;PRAGMA journal_mode=WAL&amp;quot;)&lt;br /&gt;
    cnx.executescript(&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
        CREATE TABLE IF NOT EXISTS receptions (&lt;br /&gt;
            id INTEGER PRIMARY KEY,&lt;br /&gt;
            appareil TEXT NOT NULL,&lt;br /&gt;
            recu_le TEXT NOT NULL,&lt;br /&gt;
            compteur INTEGER,&lt;br /&gt;
            rssi REAL, snr REAL,&lt;br /&gt;
            brut TEXT NOT NULL,&lt;br /&gt;
            UNIQUE (appareil, compteur, recu_le)&lt;br /&gt;
        );&lt;br /&gt;
        CREATE TABLE IF NOT EXISTS mesures (&lt;br /&gt;
            reception_id INTEGER NOT NULL REFERENCES receptions(id),&lt;br /&gt;
            grandeur TEXT NOT NULL,&lt;br /&gt;
            valeur REAL NOT NULL&lt;br /&gt;
        );&lt;br /&gt;
        CREATE INDEX IF NOT EXISTS idx_mesures ON mesures (grandeur, reception_id);&lt;br /&gt;
    &amp;quot;&amp;quot;&amp;quot;)&lt;br /&gt;
    return cnx&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
def cle_valide():&lt;br /&gt;
    &amp;quot;&amp;quot;&amp;quot;Compare la clé reçue à la clé attendue, en temps constant.&amp;quot;&amp;quot;&amp;quot;&lt;br /&gt;
    recue = request.headers.get(&amp;quot;X-Ingest-Key&amp;quot;, &amp;quot;&amp;quot;)&lt;br /&gt;
    return bool(CLE) and hmac.compare_digest(recue, CLE)&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
@app.post(&amp;quot;/ttn&amp;quot;)&lt;br /&gt;
def recevoir():&lt;br /&gt;
    if not cle_valide():&lt;br /&gt;
        return jsonify(erreur=&amp;quot;non autorise&amp;quot;), 401&lt;br /&gt;
&lt;br /&gt;
    msg = request.get_json(silent=True) or {}&lt;br /&gt;
    montante = msg.get(&amp;quot;uplink_message&amp;quot;)&lt;br /&gt;
    if not montante:                       # événement qui n&amp;#039;est pas une mesure (join, etc.)&lt;br /&gt;
        return jsonify(ok=True, ignore=&amp;quot;pas une mesure&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    appareil = msg.get(&amp;quot;end_device_ids&amp;quot;, {}).get(&amp;quot;device_id&amp;quot;, &amp;quot;inconnu&amp;quot;)&lt;br /&gt;
    decode = montante.get(&amp;quot;decoded_payload&amp;quot;) or {}&lt;br /&gt;
    # On ne retient que les valeurs numériques : un champ texte inattendu ne casse rien.&lt;br /&gt;
    mesures = {k: float(v) for k, v in decode.items()&lt;br /&gt;
               if isinstance(v, (int, float)) and not isinstance(v, bool)}&lt;br /&gt;
    if not mesures:&lt;br /&gt;
        return jsonify(ok=True, ignore=&amp;quot;rien a stocker&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
    meta = (montante.get(&amp;quot;rx_metadata&amp;quot;) or [{}])[0]   # première passerelle ayant entendu la trame&lt;br /&gt;
    cnx = ouvrir_base()&lt;br /&gt;
    try:&lt;br /&gt;
        with cnx:                          # une transaction : tout ou rien&lt;br /&gt;
            cur = cnx.execute(&lt;br /&gt;
                &amp;quot;INSERT OR IGNORE INTO receptions (appareil, recu_le, compteur, rssi, snr, brut) &amp;quot;&lt;br /&gt;
                &amp;quot;VALUES (?, ?, ?, ?, ?, ?)&amp;quot;,&lt;br /&gt;
                (appareil, msg.get(&amp;quot;received_at&amp;quot;, &amp;quot;&amp;quot;), montante.get(&amp;quot;f_cnt&amp;quot;),&lt;br /&gt;
                 meta.get(&amp;quot;rssi&amp;quot;), meta.get(&amp;quot;snr&amp;quot;), json.dumps(msg)))&lt;br /&gt;
            if cur.rowcount == 0:          # doublon : déjà enregistré&lt;br /&gt;
                return jsonify(ok=True, ignore=&amp;quot;doublon&amp;quot;)&lt;br /&gt;
            cnx.executemany(&lt;br /&gt;
                &amp;quot;INSERT INTO mesures (reception_id, grandeur, valeur) VALUES (?, ?, ?)&amp;quot;,&lt;br /&gt;
                [(cur.lastrowid, g, v) for g, v in mesures.items()])&lt;br /&gt;
    finally:&lt;br /&gt;
        cnx.close()&lt;br /&gt;
    return jsonify(ok=True, stocke=len(mesures))&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
if __name__ == &amp;quot;__main__&amp;quot;:&lt;br /&gt;
    app.run(host=&amp;quot;127.0.0.1&amp;quot;, port=8600)    # derrière un proxy HTTPS, jamais exposé tel quel&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Sources ==&lt;br /&gt;
Documentation TTN (https://www.thethingsnetwork.org/docs) ; essais de terrain Alseno Tech (août 2026).&lt;br /&gt;
&lt;br /&gt;
[[Catégorie:LoRaWAN]]&lt;br /&gt;
[[Catégorie:Agritech]]&lt;/div&gt;</summary>
		<author><name>Robot-agri</name></author>
	</entry>
</feed>