Documentazione dettagliata per tutti i servizi 1NCE, dai primi passi al livello di sviluppatore.
Trova risposte e suggerimenti utili sull’uso dei prodotti 1NCE.
Contatta il team 1NCE tramite il nostro centro di assistenza
Nel nostro Help Center facciamo tutto il possibile per trovare una risposta a tutte le tue domande. Il Team di 1NCE si impegna sempre per risolvere rapidamente i tuoi problemi e le tue richieste. In questo modo, potrai realizzare i tuoi progetti di IoT in modo semplice e senza complicazioni. Se i nostri tutorial e la documentazione sui prodotti 1NCE non dovessero essere sufficienti, non esitare a contattarci tramite il modulo di contatto. Sei già cliente? Allora dai un’occhiata al nostro portale clienti. Il centro di supporto 1NCE ti aiuta in maniera semplice e veloce. Saremo lieti di ricevere e prenderci cura delle tue richieste!
La scheda SIM 1NCE è progettata per trasmettere su LTE Cat-NB1 (NB-IoT), 2G (GSM, GPRS), 3G (UMTS), 4G (LTE) e CAT-M (LTE-M) e può connettersi direttamente a una rete mobile (MNO) senza ulteriori configurazioni.
Su tutti gli standard radio i dati possono essere trasmessi con la scheda SIM 1NCE con una larghezza di banda massima fino a 1Mbit/s.
Affinché un dispositivo possa stabilire con successo una connessione dati su NB-IoT o 2G, 3G, 4G, LTE-M, è necessario configurare l'APN 1NCE: iot.1nce.net.
L'offerta 1NCE IoT Tariffa Fissa a vita include l'accesso alla rete in tutti i paesi della mappa di copertura 1NCE attraverso NB-IoT, 2G, 3G, 4G e LTE-M con l'APN 1NCE, senza costi aggiuntivi o ulteriori configurazioni dell'APN. Con la connessione dati ogni scheda SIM riceve un indirizzo IP privato dedicato.
L'APN 1NCE può essere impostato manualmente sul dispositivo IoT impostando l'APN "iot.1nce.net" nella sezione della connessione alla rete dati del menu di configurazione del dispositivo.
L'APN può anche essere impostato tramite un comando AT. In questo caso è necessario consultare la "directory dei comandi AT" del rispettivo produttore del dispositivo.
Di seguito è riportato un esempio di utilizzo di un comando AT per impostare l'APN su un Quectel BG-96:
AT+QICSGP=1,1, "iot.1nce.net","","",1
(Si noti che i comandi AT variano a seconda del dispositivo e del produttore. Utilizzare sempre il manuale d'uso del dispositivo o la directory dei comandi AT).
Attualmente 1NCE supporta lo standard radio NB-IoT solo attraverso la rete di Telekom Deutschland. Telekom Deutschland utilizza la banda 8 dell'LTE per la comunicazione NB-IoT. Il modulo NB-IoT, anche in questo caso utilizzando l'esempio del Quectel BG96, deve essere configurato sulla banda 8 con il seguente comando AT:
AT+QCFG=”band”,0,0,80,1
Inoltre, deve essere assegnata anche la rete di Telekom Deutschland (26201):
AT+COPS=1.2, "26201″,9
Su diversi dispositivi, la banda LTE 8 può essere impostata anche manualmente nel menu di configurazione. In questo caso si consiglia di seguire le istruzioni del produttore.
NarrowBand IoT (NB-IoT) è uno standard radio basato sulle cellule e progettato specificamente per l'Internet delle cose (IoT). Si basa sulle tecnologie di rete LTE e consente di collegare dispositivi e macchine con un'elevata copertura radio e un basso consumo energetico.
Grazie all'estensione della copertura, il segnale radio di NB-IoT è ora accessibile anche in luoghi tradizionalmente difficili da raggiungere, come gli scantinati. NB-IoT è una tecnologia LPWA (Low Power Wide Area) che trasmette su frequenze con licenza. Il termine tecnico per NB-IoT è LTE Cat-NB1.
Lo standard di comunicazione mobile NB-IoT è già offerto da molti MNO (Mobile Network Operator) ed è in continua espansione. Un elenco aggiornato dei Paesi e dei rispettivi operatori di telefonia mobile che offrono o espandono NB-IoT è riportato di seguito: https://www.gsma.com/iot/mobile-iot-commercial-launches/
1NCE utilizza la rete NB-IoT di Deutsche Telekom, che offre una copertura di rete quasi completa in Germania. Per tutti i paesi con copertura NB-IoT, consultare la mappa di copertura di 1NCE.
NB-IoT è più adatto ai dispositivi fissi poiché non supporta il passaggio di cella senza soluzione di continuità, il che significa che la connessione deve essere ristabilita quando il dispositivo si collega a una nuova torre di rete cellulare.
1NCE utilizza la rete NB-IoT di Deutsche Telekom che offre una copertura di rete quasi completa in Germania.
Quando si attraversa il confine tra due Paesi coperti dall'impronta 1NCE, la scheda SIM 1NCE fornisce una connettività senza problemi. Tuttavia, funziona solo sugli standard radio 2G, 3G, 4G e LTE-M. NB-IoT in genere non supporta il cosiddetto "passaggio di cella senza soluzione di continuità", ossia il flusso di connettività senza problemi durante il cambio di cella radio. In questo caso, la connessione viene interrotta e deve essere ristabilita. Va inoltre notato che NB-IoT non è ancora supportato in tutti i Paesi dell'impronta 1NCE.
Tramite il partner Deutsche Telekom, 1NCE dispone di due o più reti partner per paese nell'impronta 1NCE offerta per garantire la copertura di base.
1NCE IoT Tariffa Fissa a vita contiene di solito 500 MB per un periodo massimo di 10 anni e fornisce una connessione dati trasparente tramite NB-IoT, 2G, 3G, 4G e LTE-M. L'applicazione del cliente utilizza solitamente TCP o UDP come protocollo di trasporto.
Il volume di dati incluso viene misurato e fatturato con l'approssimazione di 1kByte. Questo include sia i cosiddetti dati di overhead, generati dall'uso di protocolli come UDP o TCP, sia il payload vero e proprio (i dati dell'utente). Vengono calcolati tutti i dati di trasporto tra il dispositivo o il modem e il server di applicazioni. Questo include sia i pacchetti di dati in uplink che in downlink.
Per la trasmissione dei dati nella rete 1NCE e nelle reti dei partner in roaming 1NCE, vengono applicati i rispettivi meccanismi di sicurezza dei vari standard di telefonia mobile. La trasmissione dei dati via Internet al server dell'applicazione IoT può essere protetta da una connessione VPN.
1NCE offre il client OpenVPN già incluso nella 1NCE IoT Tariffa Fissa a vita come standard, mentre una soluzione IPSec viene offerta a pagamento.
A differenza delle tariffe di telefonia mobile dell'ambiente consumer, può capitare che i dispositivi IoT e M2M non trasmettano dati per periodi di tempo molto lunghi. La 1NCE IoT Tariffa Fissa a vita risponde a questa particolare esigenza e consente agli utenti IoT di lasciare i propri dispositivi inattivi fino a 18 mesi.Questo copre anche la durata massima della modalità di sospensione NB-IoT.
Se una carta SIM ha esaurito il volume incluso di 500 MB prima della fine del periodo di attivazione di 10 anni, rimarrà attivata per un massimo di 18 mesi.Durante questo periodo, il cliente ha la possibilità di riordinare un ulteriore volume di dati di 500 MB. Se entro questi 18 mesi non viene prenotato un ulteriore volume di dati, la carta SIM verrà automaticamente disattivata dal sistema con effetto dalla fine del 18° mese.
L'acquisto di un volume di dati aggiuntivo è possibile in qualsiasi momento. Se i 500 MB inclusi nella 1NCE IoT Tariffa Fissa a vita sono esauriti, è possibile acquistare altri 500 MB per altri 10 EUR. Tale ricarica è ovviamente possibile anche per qualsiasi altro livello di consumo. Il periodo di attivazione di 10 anni rimane invariato. Per ogni carta SIM il cui consumo di dati ha raggiunto l'80% del volume incluso nella 1NCE IoT Tariffa Fissa a vita (500 MB), il cliente riceve automaticamente un messaggio sul livello di consumo e un riferimento alla successiva opzione di prenotazione di altri 500 MB.
Prima della fine del periodo contrattuale di 10 anni, 1NCE informerà il cliente dell'imminente scadenza del periodo concordato. Se il cliente prenota un'altra ricarica da quel momento in poi alle condizioni applicabili in quel momento, il suo contratto sarà prolungato in base a queste condizioni.
Inoltre, il cliente ha la possibilità di riattivare la propria carta entro i primi 12 mesi dalla data di scadenza del periodo contrattuale, alle condizioni allora vigenti. Dopo la scadenza di questo periodo transitorio, il contratto per la carta corrispondente si estingue a tempo indeterminato, senza che sia necessaria alcuna disdetta.
L'1NCE IoT Tariffa Fissa a vita include già l'accesso all'APN 1NCE M2M/IoT senza costi aggiuntivi. I dispositivi mobili M2M/IoT possono connettersi all'applicazione M2M/IoT nel data center del cliente tramite APN. I dispositivi mobili M2M/IoT ricevono un indirizzo IP privato dedicato dalla rete 1NCE.
Pertanto, per connettere un dispositivo alla rete 1NCE utilizzando 2G, 3G, 4G o NB-IoT, è necessario definire l'APN 1NCE sul dispositivo dotato di scheda SIM 1NCE. L'APN 1NCE: iot.1nce.net
L'abbonamento 1NCE IoT Tariffa Fissa a vita comprende 250 SMS. Gli SMS possono essere inviati sia come SMS Mobile Terminated (MT) che Mobile Originated (MO). Gli SMS inviati da un dispositivo terminale a un altro dispositivo terminale non sono supportati.
Tuttavia, gli SMS sono rilevanti per i messaggi di sveglia dall'applicazione IoT (SMS orientati all'applicazione) all'endpoint (terminato dal cellulare). Pertanto, l'invio e la ricezione di messaggi di testo tra i dispositivi della carta SIM e il server sono supportati.
Nel portale clienti 1NCE, nella vista "SMS" della scheda "Le mie SIM" è possibile inviare un SMS (MT) direttamente dal portale clienti al dispositivo applicativo. Facendo clic sulla scheda "Configurazione" è possibile trovare la funzione Configurazione inoltro SMS.
Utilizzando la funzionalità API, le schede SIM possono essere amministrate anche direttamente tramite servizi web e comprendono anche le richieste di gestione degli SMS.
Open VPN è un'applicazione gratuita e consigliata da 1NCE per stabilire una connessione dati sicura tra la rete 1NCE e il server del cliente.
Pertanto, il client OpenVPN deve essere installato sul server del cliente (alias application server) a cui verranno trasmessi i dati del dispositivo. La connessione OpenVPN alla rete 1NCE viene stabilita dal client OpenVPN, che può essere scaricato dal portale clienti 1NCE nella scheda "Configurazione".
Sono disponibili due versioni diverse per Windows e per Linux/MacOS.
1NCE offre un'interfaccia di programmazione delle applicazioni (di seguito "API") già inclusa nell'1NCE IoT Tariffa Fissa a vita che consente agli utenti di implementare le funzioni più importanti del portale clienti nell'ambiente del cliente. Le funzioni supportate dell'API 1NCE consentono in generale al cliente di gestire, controllare e monitorare le schede SIM 1NCE da un sistema esterno.
L'API 1NCE e una breve documentazione sono disponibili qui.
1NCE offre un servizio chiamato "Data Streams". Il servizio Data Stream consente di sottoscrivere in tempo reale i dati sugli eventi e sull'utilizzo per tutte le carte SIM, inviando i dati direttamente al server del cliente o a un servizio cloud già integrato come AWS Kinesis, DataDog o Keen.io. Attualmente il servizio Data Stream consente tre flussi individuali (Dati di utilizzo, Eventi e Dati di utilizzo ed eventi), che possono essere gestiti tramite il Portale clienti.
I clienti possono mettere in pausa e riprendere il flusso in qualsiasi momento utilizzando i pulsanti di azione accanto ai dettagli del flusso.
Per impostare i flussi di dati per una RestAPI o una RestAPI in modalità Bulk è necessario specificare un callback API. Il flusso di dati 1NCE agisce come un client HTTP e necessita di un server HTTP per gestire ogni messaggio. Ogni messaggio inviato include un array di uno o più oggetti.
Ordina in modo semplice e rapido su 1NCE Shop: Seleziona il formato di SIM desiderato e inserisci tutte le informazioni necessarie. Una volta confermata la transazione riceverai le SIM entro 2-3 giorni lavorativi.
