Teltonika FMM130 Introduzione à AWS IoT Core User Guide

https://wiki.teltonika-gps.com/view/FMM130_Getting_Started_with_AWS_IoT_Core

• FMM130 (tracker) - Dispositiu di seguimentu GNSS fabricatu da Teltonika Telematics.
• Wiki - Teltonika IoT cunniscenza basa - https://wiki.teltonika-iot-group.com/.
• FOTA - Firmware Over The Air.
• Configurator - Strumenta per cunfigurà i dispositi Teltonika Telematics.
• Crowd support forum - basa di cunniscenza dedicata à a risoluzione di i prublemi.

Storia di Revisioni (Versione, Data, Descrizzione di u cambiamentu)

Versione	Data	Descrizzione
v1.5	2023.02.14	Ligami aghjurnati
v1.4	2022.12.19	Actualizazione di l'infurmazioni minori
v1.3	2022.11.29	Pagina creata

Overview

FMM130 hè un terminale di tracciamentu in tempu reale chjucu è prufessiunale cù cunnessione GNSS è LTE CAT-M1/NB-IoT/GSM è batteria di salvezza. Dispositivu dotatu di moduli GNSS/Bluetooth è LTE CAT-M1/NB-IoT cun fallback à a rete 2G, antenne interne GNSS è LTE, ingressi digitali configurabili, ingressi analogici è uscite digitali, input negativu, input d'impulse. Hè perfettamente adattatu per l'applicazioni induve l'acquistu di locu di oggetti remoti hè necessariu: gestione di flotte, cumpagnie di noleggio di vitture, cumpagnie di taxi, trasportu publicu, cumpagnie di logistica, vitture persunali è cusì.

Attualmente per u firmware di valutazione di suluzione MQTT hè necessariu di utilizà - 03.27.10.Rev.520. Per firmware chì supporta MQTT, cuntattate u vostru direttore di vendita o cuntattate direttamente via Teltonika Helpdesk.

I cambiamenti in e versioni di firmware è l'infurmazioni di l'aghjurnamentu ponu esse truvati in a pagina wiki di u dispositivu: FMM 130 firmware errata

Descrizzione Hardware

Data Sheet
A scheda di dati di u dispusitivu FMM130 pò esse scaricata quì: Data Sheet
Cuntenutu di u Kit Standard
U PACCHETTU STANDARD CONTE

• 10 pezzi. di trackers FMM130
• 10 pezzi. di cavi d'alimentazione di input / output (0.9 m) Scatola di imballaggio cù marca Teltonika

Teltonika suggerisce codici d'ordine standard per l'acquistu di u dispositivu, cuntattateci, pudemu creà un codice d'ordine speciale chì risponde à i bisogni di l'utilizatori.

Più infurmazione di ordine à: Cumanda

Articuli furniti da l'utilizatori

• Alimentazione (10-30V).
• Cavu Micro USB à USB A.

Configurate u vostru Ambiente di Sviluppu

Installazione di strumenti (IDE, Toolchains, SDK)
FMM130 vene cù u nostru firmware creatu, per quessa, ùn hè micca necessariu un sviluppu supplementu o scripting per questa unità per supportà AWS IoT. Solu utilizendu Teltonika Configurator Configuratore FM versioni, u puntu di cunnessione di u servitore AWS IoT hè necessariu.
Un altru software necessariu per sviluppà è debug applicazioni per u dispusitivu
Per situazioni di debugging, i logs interni di u dispositivu ponu esse scaricati OTA cù u nostru FotaWEB piattaforma o utilizendu Teltonika Configurator.
Configurate u vostru hardware
Tutti i dettagli nantu à FMM130 ponu esse situatu in a nostra pagina wiki dedicata FMM130 Wiki

• Istruzzioni di partenza di u dispositivu di basa furnite in FMM130 Prima partenza.
• Caratteristiche di u dispusitivu, infurmazione di l'alimentazione: FMM130 Descrizzione generale
• U cambiamentu di firmware FMM130 pò esse realizatu via FotaWEB (u cumpratore direttu accede à sta piattaforma) o via un dispositivu Cunfiguratore
• Informazione LED di u dispusitivu: Status LED FMM130
• Scaricamentu di driver USB, datasheet è scaricamentu di guida rapida: Download FMM130

Document Information

Glossariu
Wiki - Teltonika IoT cunniscenza basa - https://wiki.teltonika-iot-group.com/. FOTA - Firmware Over The Air.

• cunfiguratore - Strumentu per cunfigurà i dispositi Teltonika Telematics.
• Forum di supportu di folla - basa di cunniscenza dedicata à a risoluzione di i prublemi.

Per firmware chì supporta MQTT, cuntattate u vostru direttore di vendita o cuntattate direttamente via Teltonika Helpdesk.
Un altru software necessariu per sviluppà è debug applicazioni per u dispusitivu
Per situazioni di debugging, i logs interni di u dispositivu ponu esse scaricati OTA cù u nostru FotaWEB piattaforma o utilizendu Teltonika Configurator.

Configurate u vostru contu AWS è i permessi

Consulta a documentazione AWS in linea in Configurazione di u vostru contu AWS. Segui i passi descritti in e sezioni sottu per creà u vostru contu è un utilizatore è cuminciate:

• Iscriviti per un contu AWS
• Crea un utilizatore è cuncede permessi
• Aprite a cunsola AWS IoT

Prestate una attenzione particulare à i Note.

Crea risorse in AWS IoT

Consulta la documentazione AWS in linea in Crea risorse AWS IoT. Segui i passi descritti in queste sezioni per furnisce risorse per u vostru dispositivu:

• Crea una pulitica AWS IoT
• Crea un oggettu di cosa

Prestate una attenzione particulare à i Note.
Fornite u Dispositivu cù credenziali
U dispositivu tutale, AWS IoT è l'infurmazioni di teste ponu esse scaricati in formatu PDF quì.
NOTA: MQTT ùn funziona micca senza certificati TLS caricati.
AWS IoT Core Configuration
Configurazione di AWS IoT Core
Quandu avete logatu in a cunsola AWS, cliccate nant'à Servizi in u screnu in cima à a manca, per accede à u core IoT.

Figura 1. Accessu à AWS IoT core da a console AWS
NOTA: Se ùn pudete micca vede "Servizi" in cima à manca, cliccate nantu à "U mo contu" in cima à destra è "AWS Management Console" Selezziunate Manage, Security, Policies (Gestisce> Security> Policies) è premete Crea una pulitica o Crea buttoni .
Figura 2. Accessu à a creazione di pulitica
In a finestra Crea una pulitica, inserite u nome di a pulitica. In a tabulazione di u documentu di Politica per l'Azione di Politica (1) selezziunate "*" è per a risorsa di Politica (2) entre "*" è pressu creà.
Figura 3. Crià una pulitica Avà, chì avete creatu una pulitica, selezziunate Gestisce nantu à a barra laterale à u latu manca, dopu selezziunate Tutti i dispositi, Cose (Gestisce> Tutti i dispositi> Cose). È cliccate nant'à Crea e cose.

Figura 4. Accessu à e cose Dopu selezziunate Crea una sola cosa è cliccate Next.
Figura 5. Crea una sola cosa
Dopu avè creatu una sola cosa, entre in u nome di a cosa è in a tabulazione Device Shadow selezziunate Ombra senza nome (classica). Dopu cliccate Next.

Figura 6. Proprietà di a cosa
Dopu, quandu selezziunate u certificatu di u dispositivu, selezziunate Generate automaticamente un novu certificatu è cliccate Next.

Figura 7. Cunfigurazione di u certificatu
Avà, selezziunate a pulitica chì avete creatu prima per aghjunghje à u certificatu è a cosa. Dopu chì cliccate Crea cosa.
Figura 8. Attaccà a pulitica à u certificatu
Allora finestra cù Certificatu files è chjave fileL'opzioni di scaricamentu di s deve spuntà. Hè cunsigliatu di scaricà tuttu files, perchè più tardi alcuni di elli ùn saranu micca dispunibili per u scaricamentu. U fileI richiesti per l'usu cù i dispositi FMX sò: Certificatu di u dispositivu (1), chjave privata (2) è Amazon Root CA 1 file(3), ma hè cunsigliatu di scaricà tutti è almacenà in un locu sicuru.

Figura 9. Scaricamentu di certificatu è chjave
Truvà u puntu finale di dati di u dispositivu (dominiu di u servitore)
Per riceve u duminiu di u servitore (in l'endpoint AWS) cliccate nantu à a barra laterale à a manca Settings (AWS IoT->Settings). O cliccate nant'à a barra laterale à a manca Cose, selezziunate a cosa creata, dopu cliccate Interact->View Settings. Percorsu tutale - (Cose->*YourThingName*->Interagisce->Viewparàmetri). A pagina chì cuntene endpoint si apre. Copia tuttu l'indirizzu endpoint. U portu per accede à questu endpoint hè 8883.
Configurazione di u dispusitivu
Figura 10. Puntu finale di dati di u dispositivu

Sicurezza è certificati

Utilizà u certificatu, a chjave privata è u certificatu root. (Via Cable)
Truvà u certificatu file finiscinu cù l'estensione pem.crt (a fine pò esse solu .pem) Chjave privata file è AmazonRootCA1 file (ùn hè bisognu di cambià filenomi). Quessi files duverebbe esse scaricatu durante a creazione di Thing in AWS IoT Core.

Figura 17. Certificatu, chjave privata è certificatu radice Caricate u citatu files in a tabulazione Sicurezza in u Configuratore Teltonika.
Figura 18. Caricà i certificati è e chjavi Dopu à i certificati, andate à a tabulazione Sistema è in a sezione di u protocolu di Dati selezziunate - Codec JSON.

Figura 19. Scelta di u protocolu di dati
Configurazione GPRS di u dispositivu per AWS IoT Custom MQTT settings
In a tabulazione GPRS, sottu Impostazioni di u Servitore selezziunate:

1. Domain - Endpoint da AWS, Port: 8883
2. Protocolu - MQTT
3. Cifratura TLS - TLS / DTLS

In a sezione Impostazioni MQTT selezziunate:

1. Tipu di Cliente MQTT - AWS IoT Custom
2. ID di u dispositivu - inserisci l'IMEI di u dispositivu (opcional)
3. Lasciate Dati è temi di cumandamentu

Salvà a cunfigurazione à u dispusitivu.
Figura 27. Impostazioni GPRS per MQTT AWS IoT
Verificate i dati ricevuti è invià cumandamenti in u core AWS IoT
I dati ricevuti da u dispusitivu ponu esse truvati in u cliente di teste MQTT, chì si trova sopra "Manage" in a barra laterale à manca.
Figura 28. Locu di u cliente di prova MQTT

Per vede i dati entranti, abbonate à u tema - *DeviceImei*/data . O abbonate à # per vede tutti i dati in uscita in entrata in i Temi.

Figura 29. Client di prova MQTT
I dati entranti sò ricevuti in formatu JSON, per esempiu:
Figura 30. Format di dati ricevutu
Per mandà cumandamenti SMS / GPRS à u dispositivu abbonate à un nome di tema - * DeviceIMEI * / cumandamenti, è, in a stessa finestra di u cliente di teste MQTT, selezziunate Publicà à un tema. Inserite u nome di u tema -

*DeviceIMEI*/cumandamenti. In a carica di u messagiu, inserite u cumandamentu GPRS / SMS desideratu in u seguente formatu è appughjà Publicà:
{"CMD": " ”}Figura 31. Invio di Command in AWS IoT Core
A risposta à u cumandamentu serà mostrata in u tema Dati:

Figura 32. Risposta à un cumandamentu in u tema di dati, u cumandamentu hè statu publicatu in u tema di cumanda

Debugging

In a situazione quandu u prublema cù l'upload di l'infurmazioni appare, i logs interni di u dispositivu ponu esse pigliati direttamente da u software di cunfigurazione di u dispositivu (istruzioni), via Terminal.exe culligandu selezziunendu u portu di cunnessione USB di u dispositivu, o ricevendu logs internu via FotaWEB in sezione compitu.

Risoluzione di prublemi

L'infurmazioni ponu esse sottumessi à Teltonika HelpDesk è l'ingegneri di Teltonika aiuteranu cù a risoluzione di i prublemi. Per una infurmazione più dettagliata nantu à quale infurmazione deve esse recullata per u debugging, visitate a pagina dedicata Teltonika Wiki.

In alternativa, Teltonika hà un Crowd Support Forum dedicatu à a risoluzione di prublemi, induve l'ingegneri sò attivamente risolve i prublemi.

Risoluzione di prublemi

L'infurmazioni ponu esse sottumessi à Teltonika HelpDesk è l'ingegneri di Teltonika aiuteranu cù a risoluzione di i prublemi. Per una infurmazione più dettagliata nantu à quale infurmazione deve esse recullata per u debugging, visitate a pagina dedicata Teltonika Wiki.

In alternativa, Teltonika hà un Crowd Support Forum dedicatu à a risoluzione di prublemi, induve l'ingegneri sò attivamente risolve i prublemi.

Debugging

In a situazione quandu u prublema cù l'upload di l'infurmazioni appare, i logs interni di u dispositivu ponu esse pigliati direttamente da u software di cunfigurazione di u dispositivu (istruzioni), via Terminal.exe culligandu selezziunendu u portu di cunnessione USB di u dispositivu, o ricevendu logs internu via FotaWEB in sezione compitu.

Documenti / Risorse

Teltonika FMM130 Introduzione cù AWS IoT Core [pdfGuida di l'utente FMM130 Introduzione cù AWS IoT Core, FMM130, Introduzione à AWS IoT Core, Iniziata cù AWS IoT Core, AWS IoT Core, IoT Core, Core

Referenze

• Manuale d'usu