GSatMicro Operations Manual

Transcription

1 GSatMicr Operatins Manual : gsat.us

2 GSatMicr Operatins Manual Specificatins Dimensins: 45mm x 45mm x 34mm including battery, mdem and antenna (OEM versin). 45mm x 45mm x 20mm including battery and mdem SiRFstarIV GPS with an amazing -163dBm sensitivity AES 256-bit encryptin supprted (ptinal) Rechargeable Lithium Plymer battery (2.4 Ah, up t 1000 psitin reprts) Integrated mnidirectinal helical antenna (high gain ceramic patch antenna fr OEM mdel) Over the air cnfiguratin f terminal USB, RS-232 and Bluetth cnnectins fr prgramming Full 2 way cmmunicatins netwrk Bluetth 4.0 (LE) smartphne cnnectivity fr messaging and cnfiguratins Truly glbal cverage with the Iridium satellite netwrk. Interfaces DC Pwer (6V t 36V max USC Interface (Pwer, Serial Cnsle/Lgging, Firmware Update) RS232 Interface (Serial Cnsle/Lgging) Bluetth 4.0 Lw Energy 2 Relay 250Ma (Open Drain) 2 Analg Inputs (0V t 30V DC) Getting Started Out f the bx, yur unit shuld be in ff r strage mde. In rder t pwer it up and start transmitting yu will need t hld dwn the pwer buttn until pwer and GPS lights "fade up" (dark t bright). When yu release the buttn it will start a psitin reprt cycle. The states f which are described belw: While the unit is pwered n, it will g thrugh prgressive stages f acquiring, transmitting, and sleeping, as indicated by the Pwer and Message LED's.

3 1) Upn pwer up r wakeup frm sleep, the Pwer LED will "fade up" until initializatin is cmplete, after this the LED will indicate battery state (flashing up t 5 times if the battery is full). 2) Next, when GPS is enabled the GPS LED will fade up until satellites are acquired, at which pint the number f flashes indicates the number f satellites acquired (up t 5) until a fix achieved, then the LED will stay n, slid. 3) Next, the Iridium mdem will be enabled and the Satellite LED will fade up until signal is acquired. Once iridium signal is acquired, the LED will flash 1-5 times indicating signal level. The LED will stay n slid nce a transmissin has been successful. 4) If nly ne reprt r message was pending the unit will then sleep until the next transmissin. On battery all LEDs will turn ff. If plugged int an external pwer surce, LEDs will reflect last state achieved. The last status can be displayed by briefly pressing the pwer buttn if the unit is n battery. If transmissin was successful yur unit shuld appear n the map at its current lcatin. See the "Terminal Behavir" sectin belw fr mre details n buttn and LED behavir.

4 Terminal Behavir The frnt interface panel has three buttns and 5 lights. Behavir is described belw. Buttn Behavir Buttn Pwer Check-in Cnfiguratin! Descriptin <1 secnd: flash LEDs shwing last state befre sleep >=1 secnd: Frm ff/strage, resume transmit/sleep (Pwer and GPS LEDs will "fade up" t indicate this will happen when buttn is released). Frm sleep r wake, enter ff mde (pwer and GPS LEDs will "fade dwn") >=10 secnds: Frm any mde. Enter strage mde (Pwer, GPS, Satellite and Message LEDs will "fade dwn" t indicate the mde is selected) Set the check-in bit fr next transmissin. Hld fr >=10 secnds (message LED will fade up) t enable Bluetth pairing. Hld fr >=10 secnds while in pairing mde t disable pairing (led will fade dwn) If ALERT mde is disabled, enable (Alarm will flash), transmit immediately. If ALERT is enabled, disable. Check-in+ Cnfiguratin When yu depress the Pwer buttn fr mre than 1 secnd, the unit will either turn Off if it is currently On and g int a deep sleep withut transmitting, r if it is currently sleeping, will wake the unit and immediately transmit a psitin. When yu depress the Check-In buttn WHILE the unit is n, the next successful transmissin reprt will cntain a bit flag indicating that it is a Check In message. This mde will be cleared nce a successful transmissin is made. The MSG light will begin flashing slwly. When yu depress the Cnfiguratin + Check In buttn tgether fr ALERT mde, the unit will IMMEDIATELY begin transmitting it's current lcatin (even if it was sleeping). The MSG light will begin flashing rapidly. The unit will als use change the sleep interval t the value specified by "ALERT sleep" time in secnds indicated in the

5 "settings" functin belw. T exit ALERT mde, depress the Pwer + Check In buttn tgether again and the MSG light will turn ff again. LED mdes Descriptin Pwer 1-5 flashes 1: 0-19% battery 2: 20-39% battery 3: 40-59% battery 4: 60-79% battery 5: % battery When charging between flashes LED will glw with diminished brightness. When nt charging, LED is ff between flashes. When n external pwer and battery >=95% pwer LED will be slid n. Fade up Pwering up Fade dwn Pwering Dwn Off Off GPS Descriptin GPS Slw flash Pwered, n fix 1-4 flashes 1-4 GPS satellites 5 flashes >=5 GPS satellites On GPS fix acquired Off Off Descriptin Iridium/ Satellite Fade up Radi n, n signal 1-5 flashes Iridium signal acquired, flash cunt crrespnds t signal. Mre flashes, better signal On Transmitted message Off Off, r pwered with n radi

6 ! Alert (!) Fast Flash Off Descriptin ALERT mde, cleared n successful transmit Nt n ALERT mde Message Medium Flash Off Fade up Fade dwn Descriptin Check-in mde, cleared n successful transmit Nt in check-in mde Bluetth pairing enabled (verrides check-in) Disabling Bluetth check-in

7 Lua Functins These ptins can be sent t the terminal via the "Send Cmmand" functin within the tracking platfrm, r entered thrugh the RS232 serial cnnectin, r the USB cable via CDC mde. NOTE: Cmmands sent frm the tracking platfrm will nt shw cmmand utput anywhere ther than n the serial cnsle. Hwever, messages can be cmpsed using the tracking platfrm s functins and the Iridium transmit functin can be used t send them. GPS functins // GPS Pwer gps.setpwer( {mde} ) NOTE: Iridium mdem must be pwered n fr GPS t get signal mde: 1: n and initialize 0: ff // Get GPS Time {secnd}, {minute}, {hur}, {day}, {mnth}, {year} = gps.gettime() {epchsecnds} = gps.getunixtime() // Get Psitin {latitude}, {lngitude}, {speed}, {altitude}, {curse}, {hdp} = gps.getps() Messaging functins // Encde psitin reprt in Palmer frmat {string} = gsattrack.encpsitin({latitude}, {lngitude}, {speed}, {curse}, {battery percent}, {minute}, {altitude}, {epchsecnds} ) // Encde /text message {string} = gsattrack.enctext( {destinatin}, {message} ) // Encde settings reprt {string} = gsattrack.encsettings()

8 Iridium functins // Pwer Iridium Mdem iridium.setpwer( {mde} ) mde: 1: n 0: ff NOTE: Must be called with mde 1 t enable signal fr GPS functinality // Enable Iridium Radi iridium.setradi( {mde} ) mde: 1: n 0: ff iridium.transmit( {string} ) string: arbitrary string t transmit ver SBD Example: iridium.transmit(gps.encde(lat,ln,speed,curse,batp,min,alt)) GPIO functins { variable } = gpi.wakereasn() values: gpi.unknown: n matching wake reasn gpi.powerup: unit was just pwered n gpi.resetpin: unit was reset using the reset buttn gpi.wakepin: unit was wken using the wake pin gpi.rtc: unit was wken by RTC gpi.powerconnected: unit was wken when pwer was cnnected Cmpass functins // Cmpass heading in degrees { variable } = cmpass.getheading() // Mnitr cmpass and accelermeter values { variable } = cmpass.setmnitr( {mde} ) mde: 1: n 0: ff

9 Example utput: A#51,-120,-157,-213,-288,48,17168 A#<heading>, <mag. field x>, <mag. field y>, <mag. field z>, <accel x>, <accel y>, <accel z> Accelermeter functins // Temperature in degrees Celsius { variable } = accel.gettemp() // Unit rientatin { variable } = accel.getrientatin() values t cmpare with: accel.up_sx (0x44): Y-lw accel.up_dx (0x42): X-high accel.dw_sx (0x41): X-lw accel.dw_dx (0x48): Y-high accel.top (0x60): Z-high accel.bottom (0x50): Z-lw accel.na (0x00) :?? NOTE: need t add diagram here shwing rientatin f unit and maybe change the names f these t be mre intuitive. Battery functins //Battery percentage integer value frm 0 t 100 print(bat.getpercent()) //Battery vltage in millivlts IE: 4000 = 4.0V print(bat.getvltage()) // Enable/disable peridic battery state lgging bat.setmnitr( {mde} ) mde: 1: n 0: ff Settings functins These settings can be cnfigured thrugh the "Send Cmmand" functin n the GSatTrack site (fund under the dwn arrw menu fr the GSatMicr asset f interest). The "Get Parameters" functin frm this screen can request the current parameters stred n the device. Sending parameter requests

10 thrugh the site t the unit will nt autmatically update fields n the site. "Get Parameters" can be used t cnfirm the current cnfiguratin state f the unit. //Set variable int flash settings.flash( {setting}, {value} ) //Read variable frm flash {variable} = settings.flash( {setting} ) setting: settings.sleep // Secnds t sleep when in NORMAL mde (between cycles) (range: 0 - ( 2^31-1 ) ) settings.ss_sleep //Secnds t sleep when in SOS mde (between cycles) (range: 0 - ( 2^31-1 ) ) settings.g_timeut //GPS Timeut in secnds, default 120 (range: 0 - ( 2^31-1 ) ) settings.g_hdp //GPS Hrizntal Dilutin f Precisin needed x10, default 20 (range 0-500) settings.g_settle // Secnds t settle GPS after getting a fix, default 15 (range: 0 - ( 2^31-1 ) ) settings.i_tx_timeut //Iridium transmit timeut, default 60 (range: 0 - ( 2^31-1 ) ) settings.i_signal_timeut //Iridium signal timeut, default 60 (range: 0 - ( 2^31-1 ) ) settings.i_tx_retries //Iridium transmit attempts, default 3 (range: 0 - ( 2^31-1 ) ) settings.sleep_w_pwer // Set t 1 t sleep when n external high vltage // (des nt sleep n USB), default 0 (range: 0=sleep,1=run, cunt dwn t next cycle) settings.led_mask // mask t mask ff LED's, default 0xFF (range: 0-255, 0=all ff, 255=all n) Membrane Panel Individual Bits: bit0: GPS bit1: Message bit2: Pwer bit3: Satellite bit4: Alarm bit5-7: ignred settings.i_rx_always // keeps radi awake always t receive cmmands, default 0 (range: 0=ff,1=n) settings.tx_altitude // transmit altitude with psitin reprts (range: 0=ff,1=n) Example: //Set sleep time between reprts t 10 minutes settings.flash(settings.sleep, 600) //Print current sleep time print(settings.flash(settings.sleep)) LEDs NOTE: These functins are currently verridden during nrmal transmit behavir by built-in functins. //Set LED led.led( {led}, {led mde}, {cycles} ) // Set LED with cycles set t cntinuus led.led( {led}, {led mde} )

11 //Read current LED mde {variable} = led.led( {led} ) led: led.pwr: Pwer led.gps: GPS led.sat: Satellite/Iridium led.alrm: Alarm led.msg: Message led mde: led.ff: ff led.n: n (slid) led.fadeff: fade frm bright t dark led.faden: fade frm dark t light led.slw: slw flash led.medium: medium flash led.fast: fast flash led.1: single flash led.2: tw flashes led.3: three flashes led.4: fur flashes led.5: five flashes cycles: The number f times t repeat the mde sequence. 255 = frever. Example: //Set LED 0 t ON permanently led.led(led.pwr, led.n, 255) Interrupts / Event Handlers A set f Lua functins can be defined fr servicing varius state changes n the GSatMicr. cpu.set_int_handler( {interrupt type}, {functin} ) interrupt type: cpu.int_iridium_signal: Iridium mdem has signal frm satellite netwrk cpu.int_iridium_tx_ok: SBD transmit cmpleted successfully cpu.int_iridium_tx_fail: SBD transmissin failed (after settings.i_tx_retries retries) cpu.int_iridium_timeout: Iridium timeut waiting fr signal frm satellite netwrk cpu.int_gps_valid: GPS fix is valid and settled cpu.int_gps_timeout: timeut waiting fr GPS fix cpu.int_boot: called at bt cpu.int_contention: Iridium mdem is already receiving when a radi cmmand was issued

12 Example: functin iridium_signal() lat,ln,speed,alt,curse=gps.getps() sec,min=gps.gettime() if(speed < 5) then curse = cmpass.heading() end batp = bat.percent() iridium.transmit(gps.encde(lat,ln,speed,curse,batp,min,alt)) end cpu.set_int_handler( cpu.int_iridium_signal, iridium_signal)

13 COCOM Limits COCOM limits are a GPS limitatin by internatinal law t disable GPS chipsets at high altitudes r high speeds. The GSatMicr will stp reprting if the unit exceeds 1,000 knts AND exceeds 18,000 meters. Bth f these limits must be exceeded fr COCOM limits t be enabled which will disable the internal GPS receiver until ne f the tw limits returns t nrmal. Pinut v.1 1. RS232 - TX 2. RS232 - RX 3. USB - V+ ( v DC) 4. USB - D- 5. USB - D+ 6. OUTPUT: 0 7. OUTPUT: 1 8. INPUT: 0 9. INPUT: GROUND 11. VCC (7.5v-40v DC) Pinut v.7 Name Flex Pin Hirse Pin Cable Clr ADC IN ADC IN OUTPUT 1 13/12 2 OUTPUT 0 11/10 3 V_USB 9 7 yellw USB D- 8 6 white USB D green RS232 TX 6 12 blue RS232 RX 5 11 grey VCC 4/3 8 red GND 2/1 4 black

14 Message Frmats Mbile Terminated (MT) Future versins will make use f a header byte with values ranging frm 0-31 t define message type. Mbile Originated (MO) Psitin Reprt: Text Message: header (byte): 1 destinatin length (byte): <0-255> destinatin (byte array): <destinatin length bytes> message (byte array): <byte array bunded by end f MO message> Settings Dump: header (byte): 2 interface versin (byte): <versin, currently: 1> settings versin (byte): <versin, currently: 1> setting 0 (signed 32 bit integer): <value f first setting>... setting N-1 (signed 32 bit integer): <value f Nth setting> Current rder: 0: defaultv 1: g_hdp 2: g_timeut 3: i_tx_timeut 4: i_signal_timeut 5: i_tx_retries 6: sleep 7: ss_sleep 8: sleep_w_pwer 9: led_mask 10: i_rx_always 11: tx_altitude 12: g_settle 13: t_adc_id 14: t_adc_threshld 15: status_line 16: lw_bat_ff