Porta l'SDK del dispositivo finale sul tuo dispositivo

Porta l'SDK del dispositivo finale sulla piattaforma del tuo dispositivo. Segui questi passaggi per connettere i tuoi dispositivi a AWS IoT Device Management.

Scarica e verifica l'SDK del dispositivo finale

1. Scarica l'ultima versione dell'SDK per il dispositivo finale dalla console delle integrazioni gestite.

2. Verifica che la tua piattaforma sia nell'elenco delle piattaforme supportate in. Riferimento: piattaforme supportate

   Nota

   L'SDK del dispositivo finale è stato testato sulle piattaforme specificate. Altre piattaforme potrebbero funzionare, ma non sono state testate.

3. Estrai (decomprimi) i file SDK nel tuo spazio di lavoro.

4. Configura il tuo ambiente di compilazione con le seguenti impostazioni:

   • Percorsi dei file di origine

   • Directory dei file di intestazione

   • Librerie richieste

   • Bandiere del compilatore e del linker

5. Prima di eseguire il porting di Platform Abstraction Layer (PAL), assicurati che le funzionalità di base della piattaforma siano inizializzate. Le funzionalità includono:

   • Attività del sistema operativo

   • Periferiche

   • Interfacce di rete

   • Requisiti specifici della piattaforma

Trasferisci il PAL al tuo dispositivo

1. Crea una nuova directory per le implementazioni specifiche della piattaforma nella directory della piattaforma esistente. Ad esempio, se usi FreerTOS, crea una directory in. platform/freertos

   Esempio Struttura delle cartelle SDK

   
   ├── <SDK_ROOT_FOLDER>
   │   ├── CMakeLists.txt
   │   ├── LICENSE.txt
   │   ├── cmake
   │   ├── commonDependencies
   │   ├── components
   │   ├── docs
   │   ├── examples
   │   ├── include
   │   ├── lib
   │   ├── platform
   │   ├── test
   │   └── tools

2. Copia i file di implementazione di riferimento POSIX (.c e .h) dalla cartella posix nella nuova directory della piattaforma. Questi file forniscono un modello per le funzioni che dovrai implementare.

   • Gestione della memoria flash per l'archiviazione delle credenziali

   • Implementazione PKCS #11

   • Interfaccia di trasporto di rete

   • Sincronizzazione oraria

   • Funzioni di riavvio e ripristino del sistema

   • Meccanismi di registrazione

   • Configurazioni specifiche del dispositivo

3. Configura l'autenticazione Transport Layer Security (TLS) con TLS. MBed

   • Utilizza l'implementazione POSIX fornita se disponi già di una versione MBed TLS che corrisponde alla versione SDK sulla tua piattaforma.

   • Con una versione TLS diversa, implementate gli hook di trasporto per il vostro stack TLS con stack. TCP/IP

4. Confronta la configurazione mbedTLS della tua piattaforma con i requisiti SDK in. platform/posix/mbedtls/mbedtls_config.h Assicurati che tutte le opzioni richieste siano abilitate.

5. L'SDK si affida a CoreMQTT per interagire con il cloud. Pertanto, è necessario implementare un livello di trasporto di rete che utilizzi la seguente struttura:

   
   typedef struct TransportInterface
   {
       TransportRecv_t recv;
       TransportSend_t send;
       NetworkContext_t * pNetworkContext;
   } TransportInterface_t;

   Per ulteriori informazioni, consulta la documentazione dell'interfaccia Transport sul sito Web di FreerTOS.

6. (Facoltativo) L'SDK utilizza l'API PCKS #11 per gestire le operazioni relative ai certificati. CorePKCS #11 è un'implementazione PKCS non specifica per l'hardware per la prototipazione. Ti consigliamo di utilizzare criptoprocessori sicuri come Trusted Platform Module (TPM), Hardware Security Module (HSM) o Secure Element nel tuo ambiente di produzione:

   • Consulta l'implementazione PKCS #11 di esempio che utilizza il file system Linux per la gestione delle credenziali all'indirizzo. platform/posix/corePKCS11-mbedtls

   • Implementa il livello PKCS #11 PAL su. commonDependencies/core_pkcs11/corePKCS11/source/include/core_pkcs11.h

   • Implementa il file system Linux suplatform/posix/corePKCS11-mbedtls/source/iotmi_pal_Pkcs11Operations.c.

   • Implementa la funzione store and load del tuo tipo di storage suplatform/include/iotmi_pal_Nvm.h.

   • Implementa l'accesso standard ai file inplatform/posix/source/iotmi_pal_Nvm.c.

   Per istruzioni dettagliate sul porting, consulta Porting the core PKCS11 library nella FreerTOS User Guide.

7. Aggiungi le librerie statiche SDK al tuo ambiente di compilazione:

   • Imposta i percorsi delle librerie per risolvere eventuali problemi relativi ai linker o conflitti tra simboli

   • Verificate che tutte le dipendenze siano collegate correttamente

Testa la tua porta

È possibile utilizzare l'applicazione di esempio esistente per testare la porta. La compilazione deve essere completata senza errori o avvisi.

Nota

Ti consigliamo di iniziare con l'applicazione multitasking più semplice possibile. L'applicazione di esempio fornisce un equivalente multitasking.

1. Trovate l'applicazione di esempio in. examples/[device_type_sample]

2. Convertite il main.c file nel vostro progetto e aggiungete una voce per chiamare la funzione main () esistente.

3. Verificate di poter compilare correttamente l'applicazione demo.