ROCK Programmazione SMS

Transcript

1 MOBISAT - SISTEMI DI PROTEZIONE SATELLITARE ROCK Programmazione SMS v1.1.1 INDICE QUESTO MANUALE ILLUSTRA NEI DETTAGLI TUTTI I PARAMETRI DI CONFIGURAZIONE CHE POSSONO ESSERE INVIATI A (O DA) ROCK TRAMITE SMS, DA QUALSIASI TELEFONO CELLULARE 1 - SOFTWARE VS SMS COMMANDS 2 - I PARAMETRI 3 - INVIARE COMANDI CON IL CELLULARE 4 - SETPARAM E GETPARAM 5 - PARAMETERS VALUE TYPE 6 - IN-OUTS SETTINGS - ID ALLARMI 7 - CONFIGURAZIONE SMS DEGLI ALLARMI 8 - SMS COMMANDS 9 - CHANGE LOG support@mobisat.it -

2 1 - SOFTWARE VS SMS COMMANDS Tutti le impostazioni di ROCK possono essere attivate con un click attraverso il software di configurazione. Imparare ad utilizzare il software è semplice e consente di inviare moltissime impostazioni in pochi secondi. Tuttavia questa modalità di configurazione è possibile solo collegando ROCK (che deve essere alimentato con una batteria a 12V) al PC. Questo potrebbe risultare scomodo, qualora aveste già installato il prodotto. Plug it! Tutti i comandi possono essere inviati, letti, modificati via SMS, con un telefono cellulare o con il servizio Mobisat: Plug it! Questo documento include tutti i parametri e le impostazioni modificabili inviando SMS. 2 - I PARAMETRI Ogni funzione di ROCK è associata a un PARAMETRO che a sua volta ha sempre uno o più VALORI associati. Per esempio, il parametro che controlla la funzionalità di risparmio energetico è il n. 1 e possiede 3 valori ad esso associati: PARAMETRO 1 (modalità di risparmio energetico) VALORI ASSOCIABILI AL PARAMETRO = Active mode 1 = GPS sleep mode 2 = Deep sleep mode Alcuni Parametri funzionano assieme ad altri Parametri. Per esempio, la funzionalità: risparmio energetico (Parametro: 1) funziona assieme al Parametro:2 (Sleep Timeout). PARAMETRO VALORE ASSOCIATO AL PARAMETRO 1 2 Funziona con: 2 3 Nell esempio qui sopra, ROCK entrerà nella modalità: DEEP SLEEP dopo 3 minuti dal momento in cui viene rilevato lo stato di: VEICOLO FERMO. LO SCOPO DI QUESTO DOCUMENTO, è fornire una guida veloce in cui vengono indicati tutti i Parametri configurabili via SMS. Tutti i dettagli inerenti ad ogni Parametro e le relative logiche di funzionamento possono essere ottenuti scaricando il manuale aggiornato del prodotto sul sito di Mobisat alla pagina: Controllare spesso il sito per verificare che le versioni del manuale, del sistema operativo di ROCK (il Firmware) e di questo documento, siano sempre aggiornate (apportiamo spesso miglioramenti e nuove funzionalità). MOBISAT ROCK - Programmazione SMS - Pagina 2 di 16

3 3 - INVIARE COMANDI CON IL CELLULARE TUTTO IN MINUSCOLO Il sistema operativo di ROCK riconosce e discrimina l utilizzo di caratteri in Maiuscolo e in Minuscolo. Tutti i comandi SMS, DEVONO essere inviati in minuscolo. GLI SPAZI SONO IMPORTANTI Ogni comando è composto da caratteri e spazi. Gli spazi vanno sempre indicati correttamente. In tutta la guida, ma anche nel manuale di ROCK, lo spazio viene indicato nel seguente modo: <spazio> Nella compilazione di un comando SMS, <spazio> non va scritto ma interpretato, semplicemente aggiungendo 1 spazio tra un carattere ed un altro. LOGIN E PASSWORD Ogni comando verrà ignorato in assenza delle credenziali di riconoscimento: login e password. Ogni SMS va inviato specificando, prima di qualsiasi comando, i valori impostati per login e password nel seguente formato: <login><spazio><password><spazio><comando><id parametro><spazio><valore associato> Supponiamo che avete impostato questi valori nel seguente modo: LOGIN = Mobi Password = ROCK1 Il comando da inviare sarebbe: Mobi<spazio>ROCK1<spazio><comando><spazio><parametro><spazio><valore associato> Per es.: Mobi ROCK1 setparam 1 2 Concentriamoci per ora solamente nel modo corretto per accreditarsi con le credenziali: Login e Password, chiariremo nella prossima pagina le altre parti del comando. NOTA BENE: nella configurazione default di Mobisat i valori login e password sono liberi e quindi vuoti. Se preferite non indicare le credenziali di accesso, basterà inviare ogni comando nel seguente formato: <spazio> <spazio><comando><spazio><id parametro><spazio><valore associato> Per comodità, negli esempi che seguiranno lasceremo vuoti i campi delle credenziali: Login e Password. L invio dei messaggi SMS sarà più veloce evitando ogni volta di digitare le credenziali. Basterà cominciare ogni messaggio SMS con 2 spazi vuoti: <spazio> <spazio>setparam<spazio>1<spazio>2 MOBISAT ROCK - Programmazione SMS - Pagina 3 di 16

4 4 - setparam e getparam setparam: si utilizza per cambiare il valore di un parametro Nell esempio precedente abbiamo attivato la funzionalità Deep Sleep inviando il seguente comando: <spazio><spazio>setparam<spazio>1<spazio>2 Per configurare un parametro e il suo valore, la formula del messaggio SMS è sempre identica! Imparando questa formula è possibile modificare velocemente qualsiasi parametro via SMS. <spazio><spazio>setparam<id parametro><spazio><valore associato> Per attivare e/o disattivare qualsiasi funzione (o parametro) di ROCK, utilizzare il comando: setparam. getparam: si utilizza per chiedere a ROCK quale valore è associato ad un particolare parametro Supponiamo che abbiate la necessità di sapere se la modalità di risparmio energetico (parametro: 1) è stata attivata, e quale valore è stato associato al parametro (=Non Attiva; 1=GPS Sleep, 2=DEEP SLEEP). Possiamo utilizzare il comando getparam: <spazio><spazio>getparam<spazio>1 Inviando questo comando SMS, ROCK risponderà con un SMS indicando il valore associato al parametro 1. Anche in questo caso la formula del messaggio SMS è sempre identica: <spazio><spazio>getparam<spazio><id parametro> Potrete chiedere a ROCK il valore associato a qualsiasi parametro utilizzando il comando: getparam. Good news! Nel capitolo successivo, troverete la lista di tutti i parametri configurabili dall utente. MOBISAT ROCK - Programmazione SMS - Pagina 4 di 16

5 5 - PARAMETERS VALUE TYPE E la lista di tutti i parametri configurabili dall utente. SYSTEM PARAMETERS PARAM MIN MAX DESCRIPTION DEFAULT Sleep Mode 1 2 = Active mode 1 1 = GPS sleep mode 2 = Deep sleep mode Analog Input value range 11 1 = 1V 1 = 3V Stop Detection Source 12 2 = Ignition 1 = movement sensor 2 = GPS Stop detection timeout Value = seconds 18 Saving/Sending Without 21 1 = Disabled 1 TIme Synchronization 1 = Enabled Sleep Timeout 2 3 Value = minutes 3 Static navigation Mode sn 1 = Disabled 1 = Enabled 1 SYSTEM PARAMETERS MOBISAT ROCK - Programmazione SMS - Pagina 5 di 16

6 RECORDS PARAMETERS PARAM MIN MAX DESCRIPTION DEFAULT Sorting 11 1 = from newest 1 = from oldest Active Data Link Timeout Value = seconds 14 Server response Timeout Value = seconds 5 GSM PARAMETERS PARAM MIN MAX DESCRIPTION DEFAULT GPRS content activation = GPRS OFF 1 1 = GPRS ON APN Name 1242 empty 32 char string Define APN (acess point name) tiscalimobileinternet APN username 1243 empty 3 char string APN username (empty) APN Password 1244 empty 3 char string APN Password (empty) Target Server IP address 1245 empty 16 char string Define Target Server IP address Target Server Port 1246 empty Define Target Server Port 7777 Protocol = TCP 1 = UDP SMS Login char Example: RK1 (empty) SMS Password char Example: 1aA4 (empty) SMS data sending settings = SMS Binary OFF 1 = SMS Binary ON SMS Data send week time 1273 Parameter defines SMS data sending according to week time schedule schedule. Authorized phone numbers Number must be entered without + or. Example: F,,,,,,,,,,,,,,,,,,,FF (empty) SMS Events phone numbers Number must be entered without + or. Example: Operator List 1271 GSM operator codes are comma separated. First in a list is Home Operator Code, then Preferred Roaming Operator Codes. Example: 2221, 2221,2228 (empty) 2221 MOBISAT ROCK - Programmazione SMS - Pagina 6 di 16

7 MOBISAT ROCK - Programmazione SMS - Pagina 7 di 16

8 DATA ACQUISITION MODES PARAMETERS HOME NETWORK GSM OPERATOR CODE VEHICLE ON STOP PARAMETERS PARAM MIN MAX DESCRIPTION DEFAULT Min Period Value = seconds 36 Min Saved Records Value = units 1 Send Period Value = seconds 36 GPRS Week Time 1545 This parameter manages when it is allowed to open GPRS context 7F,FF,FF,FF,FF,FF,FF,FF,FF,FF,F F,FF,FF,FF,FF,FF,FF,FF,FF,FF HOME NETWORK GSM OPERATOR CODE VEHICLE MOVING PARAMETERS Min Period Value = seconds 6 Min Distance Value = meters 5 Min Angle Value = Angle degree 3 Min Saved Records Value = units 1 Send Period Value = seconds 12 GPRS Week Time 1555 This parameter manages when it is allowed to open GPRS context 7F,FF,FF,FF,FF,FF,FF,FF,FF,FF,F F,FF,FF,FF,FF,FF,FF,FF,FF,FF ROAMING NETWORK GSM OPERATOR CODE VEHICLE ON STOP" PARAMETERS Min Period Value = seconds 36 Min Saved Records Value = units 1 Send Period Value = seconds GPRS Week Time 1565 This parameter manages when it is allowed to open GPRS context 7F,,,,,,,,,,,,,,,,,,,FF ROAMING NETWORK GSM OPERATOR CODE VEHICLE MOVING PARAMETERS Min Period Value = seconds 6 Min Distance Value = meters 5 Min Angle Value = Angle degree 3 Min Saved Records Value = units 1 Send Period Value = seconds GPRS Week Time 1575 This parameter manages when it is allowed to open GPRS context 7F,,,,,,,,,,,,,,,,,,,FF UNKNOWN NETWORK GSM OPERATOR CODE VEHICLE ON STOP PARAMETERS Min Period Value = seconds 36 Min Saved Records Value = units 1 Send Period Value = seconds GPRS Week Time 1585 This parameter manages when it is allowed to open GPRS context 7F,,,,,,,,,,,,,,,,,,,FF UNKNOWN NETWORK GSM OPERATOR CODE VEHICLE MOVING PARAMETERS Min Period Value = seconds 6 Min Distance Value = meters 5 Min Angle Value = Angle degree 3 Min Saved Records Value = units 1 Send Period Value = seconds GPRS Week Time 1595 This parameter manages when it is allowed to open GPRS context 7F,,,,,,,,,,,,,,,,,,,FF MOBISAT ROCK - Programmazione SMS - Pagina 8 di 16

9 FEATURES PARAMETERS Digital Output No.1 usage scenarios PARAM MIN MAX DESCRIPTION DEFAULT 16 2 = Tutti gli scenari: OFF 1 = Green Driving: ON 2 = OverSpeeding: ON 3 = Jamming D.: ON 4 = Jamming D. & Green D.: ON 5 = OverSp. & Green D.: ON Max Acceleration Force Triggers harsh acceleration.25 event Max Braking Force Triggers harsh braking event.35 Max Cornering Angle Triggers harsh cornering event.3 Max allowed Speed Value = Kmh (empty) Digital Output No.2 usage scenarios = Nessuno Scenario 1 = Authorized Driving 2 = Immobilizer Trip = Disabled 1 = Enabled Start Speed Value = Kmh 5 Ignition Off Timeout Value = seconds 6 Trip Continuous distance counting = Disabled 1 = Continuous MOBISAT ROCK - Programmazione SMS - Pagina 9 di 16

10 GEOFENCING PARAM MIN MAX DESCRIPTION DEFAULT Frame border Value = meters 1 Geofence Zone #1 Shape 13 1 = Circle 1 = Rectangular Geofence Zone #1 Priority = Low 1 = High 2 = Panic Geofence Zone # = No event Generate Event 1 = Event On entering zone 2 = Event On exiting zone 3 = On both Geofence Zone # Logitude Circle Center. Longitude (X1 = Circle) Geofence Zone # Longitude Left down corner. Longitude (X1 = Rectangular) Geofence Zone # Latitude Circle Center. Latitude (Y1 = Circle) Geofence Zone # Latitude Left down corner. Latitude (Y1 = Rectangular) Geofence Zone # Circle radius in meters. Longitude (X2 circle) Geofence Zone # Longitude right upper corner. Longitude (X2 rectangular) Geofence Zone # Latitude right upper corner. Latitude (Y2) GEOFENCE GEOFENCE GEOFENCE GEOFENCE GEOFENCE MOBISAT ROCK - Programmazione SMS - Pagina 1 di 16

11 AUTO - GEOFENCING PARAM MIN MAX DESCRIPTION DEFAULT Enable/Disable = Disabled 1 1 = Enabled Activation Timeout Value = seconds 6 Deactivate by 11 1 = Ignition 1 = ibutton AutoGeofence event Priority = Low 1 1 = High AutoGeofence event = Event On entering zone 1 generating 1 = Event On exiting zone 2 = On both Radius Value = meters 1 ibutton List FFFFFFFFFFFF FFFF IButton recognized codes (empty) I/O PARAMETERS PARAM MIN MAX DESCRIPTION DEFAULT IO#1 property parameter 13 byte = Disabled 1 = Enabled IO#1 priority = Low 1 = High 2 = Panic IO#1 High level Value = units IO#1 Low level Value = units IO#1 logic operand = On Range Exit 3 1 = On Range Exit 2 = On Both 3 = Monitoring IO#1 averaging length unit = 3ms 1 MOBISAT ROCK - Programmazione SMS - Pagina 11 di 16

12 IO ELEMENT PARAMETERS IO ELEMENT DEFAULT NUMBER Digital input IO# Disabled Digital input IO#1 Disabled Digital input IO#2 Disabled Analog input IO#3 Disabled Digital output IO#4 Disabled Digital output IO#5 Disabled PDOP IO#6 Disabled HDOP IO#7 Disabled Power voltage IO#8 Disabled GPS power IO#9 Disabled Movement sensor IO#1 Disabled Odometer IO#11 Enabled (Monitoring) Actual operator code IO#12 Disabled Speedometer IO#13 Disabled ibutton ID IO#14 Disabled Operating Mode IO#15 Disabled GSM Signal IO#16 Disabled Deep Sleep IO#17 Disabled Cell ID IO#18 Disabled Area Code IO#19 Disabled Temperature IO#2 Disabled MOBISAT ROCK - Programmazione SMS - Pagina 12 di 16

13 6 - IN-OUTS SETTINGS - ID ALLARMI ROCK invia allarmi satellitari indicando per ogni allarme, non solo i dati GPS ma anche una particolare condizione degli Ingressi e delle uscite. Questo viene rappresentato da un CODICE IDENTIFICATIVO e dal VALORE associato allo stato corrente. Ad esempio, se abbiamo impostato ROCK per inviare un allarme ad ogni avviamento del veicolo (ovvero: Digital Input 1 = 1), riceveremmo un l allarme nel seguente formato: ID: 1 - VALUE: 1. Seguono i parametri di tutti gli allarmi che ROCK può generare. ID PROPERTY NAME BYTES DESCRIPTION 1 Digital Input Status 1 1 Logic: /1 2 Digital Input Status 2 1 Logic: /1 3 Digital Input Status 3 1 Logic: /1 9 Analog Input 1 2 Voltage: mv, 3 V 21 GSM signal level 1 Value in scale Speedometer 2 Value in km/h, xxx km/h 66 External Power 2 Voltage: mv, 3 V Voltage 69 GPS Power 2 States: short circ., 1 connected 72 Dallas Temperature 4 1 * Degrees ( C ), , if 3 Dallas error 78 ibutton Input 8 ibutton ID number 8 Working mode 1 home on stop, 1 home on move, 2 roaming on stop, 3 roaming on move, 4 unknown on stop, 5 unknown on move 179 Digital output 1 state 1 Logic: /1 18 Digital output 2 state 1 Logic: /1 181 PDOP 2 Probability * 1; HDOP 2 Probability * 1; Virtual Odometer 4 Distance between two records: m 2 Deep sleep 1 not deep sleep mode, 1 gps sleep mode, 2 -deep sleep mode 25 Cell ID 2 GSM base station ID 26 Area code 2 Location Area code (LAC), it depends on GSM operator. It provides unique number which assigned to a set of base GSM stations. Max value: Movement 1 not moving, 1 moving 241 Current operator code 4 Currently used GSM Operator code 155 Geofence zone 1 1 Event: target left zone, 1 target entered zone 156 Geofence zone 2 1 Event: target left zone, 1 target entered zone 157 Geofence zone 3 1 Event: target left zone, 1 target entered zone 158 Geofence zone 4 1 Event: target left zone, 1 target entered zone 159 Geofence zone 5 1 Event: target left zone, 1 target entered zone 175 Auto Geofence 1 Event: target left zone, 1 target entered zone 248 Custom Scenario 1 Event: In range => Out range, - Event: 1 Out range => In range 249 Jamming Detection 1 Event: Jamming detection = False, - Event: 1 Jamming detection = True 25 Trip 1 1 trip start, trip stop 251 Immobilizer 1 1 ibutton connected 252 Authorized driving 1 1 authorized ibutton connected 253 Green driving type 1 1 harsh acceleration, 2 harsh braking, 3 - harsh cornering 254 Green driving value 1 Depending on green driving type: if harsh acceleration or braking g*1 m/s2, if harsh cornering degrees 255 Over speeding 2 At over speeding start km/h, at over speeding end km/h MOBISAT ROCK - Programmazione SMS - Pagina 13 di 16

14 7 - CONFIGURAZIONE SMS DEGLI ALLARMI ROCK può inviare qualsiasi allarme via SMS. Per ricevere gli allarmi generati su un telefono cellulare, è necessario registrare quel n. di cellulare affinché gli allarmi possano essere inoltrati via SMS. E possibile autorizzare fino a 1 numeri per la ricezione di allarmi satellitari. Ogni allarme satellitare potrà essere quindi inviato ad 1 numero specifico trai 1 registrabili. INDICE DEI N. TELEFONICI PER GLI EVENTI SMS INDICE N. TELEFONICI NUMERO TELEFONICO (DEFAULT: VUOTO) ID CONFIG. VIA SMS Es.: per abilitare il primo numero telefonico alla ricezione di allarmi SMS, inviare il seguente comando: <spazio><spazio>setparam<spazio>15<spazio> Importante: davanti al numero occorre sempre specificare il prefisso internazionale nel seguente modo: ü il segno: + ( = ERRATO) ü i 2 zeri: ( = ERRATO) ü = CORRETTO CONFIGURAZIONE DEGLI EVENTI SMS Per configurare l invio di un Evento (o allarme) SMS ad un numero telefonico specifico, inviare a ROCK un SMS nel seguente formato: <spazio><spazio>setparam<spazio>x<spazio>y,w,z (facendo attenzione all utilizzo corretto delle virgole, e degli spazi che sono assenti trai valori separati dalla virgola). Interpretare il comando: ü X ID Evento (nella tabella seguente) ü Y Disabilitato / Abilitato (/1) ü W Valore dell Indice dei N. Telefonici a cui inviare l Evento ü Z Testo da includere nel SMS relativo ad un particolare Evento Ad esempio, per inviare l allarme Autogofence al primo numero registrato nella lista dei numeri telefonici abilitati alla ricezione di allarmi satellitari, inviare il seguente messaggio: <spazio><spazio>setparam<spazio>135<spazio>1,,allarme FURTO! MOBISAT ROCK - Programmazione SMS - Pagina 14 di 16

15 INDICE DI CONFIGURAZIONE DEGLI EVENTI SMS INDICE EVENTI NOME DELL ELEMENTO ID CONFIG. VIA SMS Digital Input Digital Input Digital Input Analog Input 13 4 Digital Output Digital Output GPS PDOP 16 7 GPS HDOP 17 8 External Voltage 18 9 GPS Power 19 1 Movement Sensor Odometer Value GSM Operator Speed Button ID Data Mode GSM Signal Deep Sleep Cell ID Area Code Dallas Temperature Reserved Reserved Reserved Reserved Green Driving OverSpeeding Authorized Driving Immobilizer Trip Geo Zone Geo Zone Geo Zone Geo Zone Geo Zone Auto Geofence Reserved Reserved Reserved Reserved 139 MOBISAT ROCK - Programmazione SMS - Pagina 15 di 16

16 8 - SMS COMMANDS Oltre a setparam e getparam, esistono altri comandi SMS che consentono all utente di richiedere informazioni specifiche allo stato di funzionamento del sistema ad esempio, oppure la versione corrente del firmware, o il codice imei di ROCK, ecc. Segue una lista dei comandi SMS riconosciuti dal sistema satellitare SMS COMMANDS getweektime getops getcfgtime getgps getgpslink getver getinfo getio readio # setdigout ## getparam #### setparam #### # flush #,#,#,#,#,#,# getstatus format cpureset deleterecords ROCK risponde con l orario corrente di ROCK, il giorno della settimana ed il n. di minuti trascorsi dall inizio della settimana. ROCK risponde con la lista degli operatori GSM disponibili al momento della ricezione del comando. ROCK risponde con con data e ora dell ultima configurazione funzionante. ROCK risponde con la propria posizione geografica e l indicazione dei dati rilevati dal GPS (data, ora, n. satelliti, velocità, angolo direzionale, ecc. Il messaggio è in formato Text. ROCK risponde con un Hiperlink a Google Maps. Indicato per chi ha uno Smartphone ed una connessione ad internet. ROCK risponde con la versione corrente del Firmware, il seriale e l Imei del modem. ROCK risponde con le informazioni di runtime e di sistema. ROCK risponde indicando lo stato corrente di tutti gli ingressi e le uscite (DIN1, DIN2, DIN3, AIN1,DOUT1,DOUT2). ROCK risponde con il valore assegnato ad uno specifico ID tra gli I/O (input/output). Ved. Capitolo 6 di questo documento per una lista completa dei codici ID di ingressi e uscite. Questo comando serve ad accendere e spegnere le uscite digitali DOUT1 e DOUT2, dove il primo valore da indicare è lo stato logico dell Uscita Digitale 1 (DOUT1) ed il secondo dell Uscita Digitale DOUT2. I valori possono essere solo = OFF ed 1 = ON. Se ad esempio, avete collegato l uscita 2 al Blocco Avviamento: per bloccare il veicolo inviare il seguente comando: <spazio><spazio>setdigout<spazio>1 per sbloccare il veicolo inviare il seguente comando: <spazio><spazio>setdigout<spazio> ROCK risponde con il valore assegnato ad uno specifico parametro. Viene utilizzato per assegnare o modificare un valore ad uno specifico parametro. Invia tutti i dati registrati nella memoria flash ad un server. 1.# IMEI - 2.# APN - 3.# - LOGIN - 4.# PASS - 5.# IP - 6.# PORT 7.# MODE (-TCP/1-UDP). ROCK risponde con lo stato attuale del modem Questo comando effettua un RESET della configurazione attiva, caricando il profilo Default (maggiori informazioni sul manuale di ROCK al capitolo: ). Effettua un Reset di sistema (questo comando non fornisce alcun SMS di risposta). Cancella tutti i dati registrati nella memoria flash (questo comando non fornisce alcun SMS di risposta). 9 - CHANGE LOG N Data Versione Commenti Rilascio della Bozza Preliminare dei parametri relativi agli Scenari MOBISAT ROCK - Programmazione SMS - Pagina 16 di 16