Technischer Starting-Guide - Sigfox
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
Technischer Starting-Guide
Sie haben ein neues Device bei uns bestellt und Sie wissen nicht genau, was Sie damit machen
sollen?
Diese Anleitung zeigt Schritt für Schritt was konfiguriert werden muss, um das Device nutzen
zu können.
● Sigfox Subscription kaufen
Um Sigfox Konnektivität zu kaufen, gibt es 2 Möglichkeiten:
Option 1: Sigfox Buy :
https://buy.sigfox.com/
● Klicken Sie auf Buy Connectivity
● Wählen Sie Germany und gehen anschließend auf Subscriptions
● Wählen Sie die Menge von Subscriptions sowie die maximal erlaubte Anzahl von
Nachrichten pro Tag.
Der Atlas Native Geolocation Service kann auch dazu bestellt werden. Mehr
Informationen under: https://build.sigfox.com/geolocation-sigfox-atlas
Für Atlas WiFi, scrollen Sie bitte weiter zu Option 2.
● Erstellen Sie sich ein Konto und klicken Sie auf Proceed to Payment:
Option 2: Operator kontaktieren
Für Subscription mit Atlas WiFi, kontaktieren Sie bitte shop@sigfox.de
● Mein Device im Sigfox Backend registrieren
Voraussetzungen
1. Login im Sigfox Backend vorhanden
2. Bestehender Vertrag
3. Device Credentials (ID/PAC)*
4. End product certificate (P_Certificate Number)*
*NOTES
ID/PAC
ID (Identifier) und PAC sowie das End product certificate finden Sie in der Versandbestätigung.
Die ID und PAC befindet sich auch häufig auf dem Gerät selbst.
PAC
Die PAC (Porting Authentication code) ist ein Einmalpasswort, dieses ändert sich nach jeder Verwendung im
Sigfox Backend.
Die auf dem Device abgebildete PAC kann sich in seltenen Fällen durch Funktionstests des Hersteller geändert
haben.
A. Geräte müssen unter einem Device Type registriert werden.
● Klicken Sie dafür auf Device Type
● Klicken Sie auf New
● Wählen Sie Ihre Gruppe: ● Füllen Sie die angeforderten Informationen aus: 1. Wählen Sie den Namen Ihres Device Types 2. Geben Sie eine Beschreibung ein 3. (Optional) Sie können einen Keep-alive einrichten. Mehr Informationen über das Keep-alive finden Sie hier: https://support.sigfox.com/docs/set-a-keep-alive-delay 4. Wählen Sie Ihren Sigfox-Subscription Vertrag 5. (Optional) Sie können eine Altert e-Mail-Adresse eingeben, um Alarme zu bekommen, wenn die Callbacks dieses Device types nicht funktionieren 6. Wählen Sie den Downlink Callback Modus. Mehr darüber finden Sie unter: https://support.sigfox.com/docs/downlink-callbacks 7. Falls Downlink Mode auf DIRECT gestellt wird, muss man hier die Downlink Konfiguration eingeben. 8. Klicken Sie auf Ok. Ihr Device type wird dann erfolgreich hergestellt werden.
B. Device Registrieren:
● Klicken Sie auf Device
Sie haben zwei Möglichkeiten für die Registrierung:
- Entweder eine Single Registrierung, in der Sie ein Device registrieren können.
Dafür bitte auf New klicken
- Oder Sie haben mehrere Devices und möchten alle auf einmal registrieren.
Dann bitte auf New Series klicken
● Für den Fall New, folgen Sie bitte diesen Schritten:
(Device New Series Registrierung erfolgt im nächsten Punkt)
1. Suchen Sie Ihre Gruppe, in der Sie Ihr Device registrieren möchten
2. Füllen Sie die Felder aus:
- ID und PAC*
- Product Certificate*
*Siehe Notiz unter Voraussetzungen
Klicken Sie auf Ok, Ihr Device ist jetzt registriert.
● Falls Sie mehrere Devices gleichzeitig registrieren wollen, klicken Sie auf New
Series, folgen Sie bitte folgenden Schritten:
1. Selektieren Sie Ihre Gruppe, in welcher Sie das Device registrieren möchten:
2. Füllen Sie die Felder aus:
- ID und PAC*
- Product Certificate*
*Siehe Notiz unter Voraussetzungen
- IDs und PACs sind in einer Batch Datei wie folgt beschrieben und können als
*.csv oder *.txt hochgeladen werden:
Die Devices sind jetzt registriert.
● Meine Devices Daten in eine Plattform
verknüpfen
Die Nachrichten, die von Ihren Devices gesendet wurden, kommen auf dem Sigfox
Backend als Hexadecimal Rohdaten an. Diese Daten können an dritte Plattformen
gesendet werden. Um auf diese Daten automatisch zugreifen zu können, gibt es 2
Möglichkeiten.
Option 1: REST API
Um API Endpoints zu nutzen, müssen Sie zunächst API Access Credentials erstellen:
1. Gehen Sie auf die Gruppe, in der Ihre Devices registriert sind:
2. Klicken Sie im linken Panel-Menü auf API Access .
3. Klicken Sie in der oberen rechten Ecke auf Neu
4. Füllen Sie die infos:
○ Name
○ Ihre Timezone
○ Profil Rechte (Sie finden hier mehr infos dazu)
5. Der API Schlüssel ist generiert:
Mehr Informationen finden Sie hier :
https://support.sigfox.com/docs/api-documentation
https://support.sigfox.com/apidocs#operation/getApiUser
Option 2: Callbacks
● Callback-Dienste senden eine benutzerdefinierte Anfrage, die Ihre Gerätedaten
zusammen mit anderen Variablen enthält, an einen bestimmten
Server/Plattform.
● Je nach Callback-Dienst wird ein Callback durch ein bestimmtes Ereignis in der
Sigfox Cloud ausgelöst.
● Sigfox Cloud bietet 2 Hauptkategorien von Callback-Diensten:
1. Daten- und Service-Callback-Dienste, die durch ein Netzwerkereignis
(Gerätemeldung oder Kommunikationsverhalten des Geräts) ausgelöst
werden. Diese Callback-Dienste werden auf Gerätetyp-Ebene
konfiguriert.
2. Ereignis-Callback-Dienste, die durch ein Ereignis auf der Entität des
Gerätes (dessen Lebenszyklus, Kommunikationsstatus und
Abonnement) ausgelöst und auf Gruppenebene konfiguriert werden
● Die verschiedenen Callbacks finden Sie hier hier :Trigger
Callback service Description
Reception of the
DATA Uplink Send Uplink Message
first frame
Received event
BIDIR Send uplink Message
Received and return
downlink message
SERVICE STATUS Send device battery and
temperature information
received for modules
allowing Out-Of-Band
status messages.
ACKNOWLEDGE Send the network
acknowledgment
confirming the downlink
message emission.REPEATER service messages (battery,
number of repeated
messages,…) only
applicable for repeater
devices.
25 seconds after
DATA ADVANCED Send Uplink Message
Reception of the
Received with enriched
first frame
data:
Connectivity Metadata (Link
Quality Indicator and
country of sending)
● Geolocation
Metadata (Latitude,
Longitude, radius,
and source -
Contract option
required)
● Network Metadata
(Base station Id, RSSI
per duplicates -
contract option
required)ERROR Send an alert when DeviceType
a device does not Setting
comply with the
keepalive delay set
at device type level.
Event base
EVENT Device events Send alerts that are
triggered upon event
occurrence (see Event
types)
● Die Callbacks sind auf Device type Ebene zu schreiben:
1. Gehen Sie auf Device type, wo Ihre Devices registriert sind
2. Klicken Sie auf Callbacks
3.
4. Klicken Sie auf “New”5. Sie haben dann die Wahl zwischen verschiedenen Callbacks. Die Standard Callbacks können durch Custom Callbacks eingestellt werden. 6. Sie können dann Ihre Callbacks konfigurieren : Detaillierte Informationen finden Sie hier
Sie können auch lesen
