User manual EMTAC BTGPS II TRINE DATA LOGGER

BTGPS II Trine GPS Receiver User Guide Addendum BTGPS II Trine Instruction Set Data Logger Instruction Set BTGPS II Trine Data Logger Instruction Set 1. Product background. 1.1. Base on BTGPS and BTGPS Data Logger function with advance features. 1.2. BTGPS function: The Bluetooth on BTGPS II Trine offers 4 serial port profile (SPP) services to 4 Bluetooth enabled client devices (PDA/PC/Notebook PC) to equally access all the GPS/Data Logger functions at the same time. Remark: Refer to the "Multi-link of Trine" document for details. 1.3. Data Logger function: The Data Logger function now improved with following features. 1.3.1. Backward compatible to original Data Logger Command Set. 1.3.2. Use 512K Byte Flash Memory for data record spaces, with 20 bytes binary data record offers more than 24K records storage. 1.3.3. To use the Flash Memory in a `Roll-Over' method that keeps the latest 22K records in the device. 1.3.4. Logging trigger setting including, Fix type change, DOP change, Elapse-Time, Movement, COG change, Velocity change, Altitude change, Velocity threshold, Altitude threshold, Stall velocity threshold /Time. 1.3.5 Selectable time domain of downloading record data. 1.4. Firmware upgradeable. 1.5 SiRF® GSW 2.3.2 GPS kernel. 1.6. Replaceable and rechargeable battery. 2. Instruction Set. 2.1 $PSRF15x; For backward compatible to `Data Logger' product. 2.1.1. $PSRF150 \ -----------------------------------------------------------------------------------------------------------------------------------\ $PSRF150 Command; Set the Data Logger Parameters. \ Note: This command will NOT erase all existing recorded data in the logger! anymore! \ -----------------------------------------------------------------------------------------------------------------------------------\ Command: \ $PSRF150,,,,*CKSUM \ : 0-65535cInteger Number, for identification of the device or log event. \ : 0-65535: Recording Interval in seconds; 0: No record action. \ : SBAS function; 0: Disable; 1: Enable. \ : 120-138: Forced SBAS PRN No.; 0: Auto search. \ -----------------------------------------------------------------------------------------------------------------------------------\ Response: \ $PSRF150,*CKSUM \ : 0 : No Error; (01|02|04|08)|16: Over-range(Logger-ID|Rec-Int|SBAS-ena|SBAS-prn)|Flash-Error. \ ------------------------------------------------------------------------------------------------------------------------------------ 2 Data Logger Instruction Set 2.1.2. $PSRF151 \ -----------------------------------------------------------------------------------------------------------------------------------\ $PSRF151 Command, Read the Data Logger Parameters/Rec No. \ -----------------------------------------------------------------------------------------------------------------------------------\ Command: \ $PSRF151*CKSUM \ -----------------------------------------------------------------------------------------------------------------------------------\ Response: \ $PSRF151,,,,,*CKSUM \ : 0-65535 Integer Number, for identification of the device or log event. \ : 0-65535: Recording Interval in seconds; 0: No record action. \ : SBAS function; 0: Disable; 1: Enable. \ : 120-138: Forced SBAS PRN No.; 0: Auto search. \ : 0-4094: Total logged record No. \ -----------------------------------------------------------------------------------------------------------------------------------2.1.3. $PSRF152 \ -----------------------------------------------------------------------------------------------------------------------------------\ $PSRF152 Command, Read Single Record Data (ASCII Mode). \ -----------------------------------------------------------------------------------------------------------------------------------\ Command: \ $PSRF152,,*CKSUM \ : 0-26000 : The record No. to be read. \ -----------------------------------------------------------------------------------------------------------------------------------\ Response: \ $PSRF152,,,,,,,,,,,,,,* CKSUM \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ : The record No. read. : 1|0 : DGPS used in fix or not. : 0 : None, 1: 1D 2 : 2D , 3 : 3D fix. : 0-12 : Sat. No. used in fix. : 0.0-50.0 : HDOP value. : ddmmyy. : hhmmss.sss : DDMM.mmmm , The Latitude. : N|S : DDDMM.mmmm , The Longitude. : E|W : Altitude, in 0.1 meter. : Velocity, in 0.1 Km/Hr. : Course over ground, in 0.1 degree. All fields contain '0's represent an empty record! \ ------------------------------------------------------------------------------------------------------------------------------------ 3 Data Logger Instruction Set 2.1.4. $PSRF153 \ -----------------------------------------------------------------------------------------------------------------------------------\ $PSRF153 Command, Download All Record Data (Binary Mode). \ -----------------------------------------------------------------------------------------------------------------------------------\ Command: \ $PSRF153,*CKSUM \ -----------------------------------------------------------------------------------------------------------------------------------\ Response: \ $PSRF153,1 \ After records data downloaded, all data records will be erased. \ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------The binary data format. Record-Length = 32 bytes; Data are in little endium (Lower byte = LSB). -------------------------------------------------------------------------------------------------------------------------------Field Offset Length Description -------------------------------------------------------------------------------------------------------------------------------Fix 0 1 Unsigned 8 bit data, The fix status; 0,2,3(D) 8 + if DGPS used. Su 1 1 Unsigned 8 bit data, Satellite No used in fix. Hdop 2 2 Unsigned 16 bit data, = (HDOP value)*10. Year 4 2 Unsigned 16 bit data, The year, (2002) for example. Month 6 1 Unsigned 8 bit data, The month, 1-12. Day 7 1 Unsigned 8 bit data, The day, 1-31. Hour 8 1 Unsigned 8 bit data, The hour, 0-23. Minute 9 1 Unsigned 8 bit data, The minute, 0-59. Ms 10 2 Unsigned 16 bit data, The millisecond, 0-59999 Lat 12 4 Signed 32 bit data, The latitude, =(DDMM.mmmm)*10000 >0 : North, <0 : South. Lon 16 4 Signed 32 bit data, The longitude, =(DDDMM.mmmm)*10000 >0 : East, <0 : West. Alt 20 4 Signed 32 bit data, The altitude, =(Altitude: meter)*10 Vel 24 2 Unsigned 16 bit data, The Velocity, =(VEL:Km/hr)*10 Cog 26 2 Unsigned 16 bit data, The course over ground, =(COG:degree)*10 Type 28 2 Unsigned 16 bit data, Record Type, NOT Used currently. Rev 30 1 Unsigned 8 bit data, Reserved, NOT Used currently. Cks 31 1 Unsigned 8 bit data, Internal check, NOT Used by User. -------------------------------------------------------------------------------------------------------------------------------- 4 Data Logger Instruction Set 2.1.5. $PSRF154 \ -----------------------------------------------------------------------------------------------------------------------------------\ $PSRF154 Command, Dump All Record Data (ASCII Mode). \ -----------------------------------------------------------------------------------------------------------------------------------\ Command: \ $PSRF154,*CKSUM \ -----------------------------------------------------------------------------------------------------------------------------------\ Response: \ $PSRF154,,,,,,,,,,,,,, *CKSUM \ Repeat till all records dumped, No ERASE occurred after this command. \ -----------------------------------------------------------------------------------------------------------------------------------2.2. $PEMT160 2.2.1 $PEMT160,0 \ $PEMT160,0 ; Read/Write Data Logger ID. \ ; Read Data Logger ID. \ Command: $PEMT160,0,0*CKSUM \ Response: $PEMT160,0,0,logger_id*CKSUM \ ; Write Data Logger ID. \ Command: $PEMT160,0,1,logger_id*CKSUM \ Response: $PEMT160,0,err_code,logger_id*CKSUM Err_code=0, if parameters accepted. 2.2.2 $PEMT160,1 \ $PEMT160 ,1; Read/Write DGPS setting. \ ; Read DGPS setting. \ Command: $PEMT160,1,0*CKSUM \ Response: $PEMT160,1,0,dgps_src,dgps_mde*CKSUM \ ; Write DGPS setting. \ Command: $PEMT160,0,1,dgps_src,dgps_mde*CKSUM \ Response: $PEMT160,0,err_code,dgps_src,dgps_mde*CKSUM dgps_src: 0:None; 1: SBAS dgps_mde: 0:Auto; 1: Exclusive. 5 Data Logger Instruction Set 2.2.3. $PEMT160,2 \ $PEMT160,2; Read/Write SBAS setting. \ ; Read SBAS setting. \ Command: $PEMT160,2,0*CKSUM \ Response: $PEMT160,2,0,sbas_prn,sbas_mde*CKSUM \ ; Write DGPS setting. \ Command: $PEMT160,2,1,sbas_prn,sbas_mde*CKSUM \ Response: $PEMT160,2,err_code,sbas_prn,sbas_mde*CKSUM sbas_prn: sbas_mde: 0: Auto, 120-138 assigned. 0:Test ; 1:Intergrity. 2.2.4. $PEMT160,3 \ $PEMT160,3 ; Read/Write Data Logger Triger Setting, - GPS positioning condidion. \ ; Read Data Logger Triger Setting: FixChg,DopChg \ Command: $PEMT160,3,0*CKSUM \ Response: $PEMT160,3,0,FixChg,DopChg*CKSUM \ ; Write Data Logger Triger Setting: FixChg,DopChg \ Command: $PEMT160,3,1,FixChg,DopChg*CKSUM \ Response: $PEMT160,3,err_code,FixChg,DopChg*CKSUM FixChg: DopChg 0: Not Set, 1: Set Fix status change trigger. 0: Not Set, 1-255 in unit of 0.1 HDOP change, trigger set. 2.2.5. $PEMT160,4 \ $PEMT160,4 ; Read/Write Data Logger Triger Setting, - Accumulated Value \ ; Read Data Logger Triger Setting: ElapseTime,Movement. \ Command: $PEMT160,4,0*CKSUM \ Response: $PEMT160,4,0,ElpaseTime,Movement*CKSUM \ ; Write Data Logger Triger Setting: ElapseTime,Movement. \ Command: $PEMT160,4,1,ElapseTime,Movement*CKSUM \ Response: $PEMT160,4,err_code,ElpaseTime,Movement*CKSUM ElapseTime: in second. Movement: in Meter. 6 Data Logger Instruction Set 2.2.6. $PEMT160,5 \ $PEMT160,5 ; Read/Write Data Logger Triger Setting, - Changeded Value \ ; Read Data Logger Triger Setting:CogChg,VelChg,AltChg \ Command: $PEMT160,5,0*CKSUM \ Response: $PEMT160,5,0,CogChg,VelChg,AltChg*CKSUM \ ; Write Data Logger Triger Setting: CogChg,VelChg,AltChg \ Command: $PEMT160,5,1,CogChg,VelChg,AltChg*CKSUM \ Response: $PEMT160,5,err_code,CogChg,VelChg,AltChg*CKSUM CogChg: in Degree VelChg: in % AltChg: in Meter 2.2.7. $PEMT160,6 \ $PEMT160,6 ; Read/Write Data Logger Triger Setting, - Threshold Value \ ; Read Data Logger Triger Setting: VelThr,AltThr \ Command: $PEMT160,6,0*CKSUM \ Response: $PEMT160,6,0,VelThr,AltThr*CKSUM \ ; Write Data Logger Triger Setting: VelThr,AltThr \ Command: $PEMT160,6,1,VelThr,AltThr*CKSUM \ Response: $PEMT160,6,err_code,VelThr,AltThr*CKSUM VelThr: in 0.1 Km/Hr AltThr: in Metter 2.2.8. $PEMT160,7 \ $PEMT160,7 ; Read/Write Data Logger Triger Setting, - Stall case. \ ; Read Data Logger Triger Setting: StallThr,StallTime \ Command: $PEMT160,7,0*CKSUM \ Response: $PEMT160,7,0,StallThr,StallTime*CKSUM \ ; Write Data Logger Triger Setting: StallThr,StallTime \ Command: $PEMT160,7,1,StallThr,StallTime*CKSUM \ Response: $PEMT160,7,err_code,StallThr,StallTime*CKSUM StallThr: in 0.1Km/Hr StallTim: in Second. 7 Data Logger Instruction Set 2.2.9. $PEMT160,8 \ $PEMT160,8 ; Turn All Trigger Off, The Log ID and DGPS set remained. \ Command: $PEMT160,8,1*CKSUM \ Response: $PEMT160,8,1*CKSUM 2.2.10. $PEMT160,9 \ $PEMT160,9 ; Reset Data Logger Triger Setting to Factory Default Setting: Logerr ID=0, No Trigger Set. \ Command: $PEMT160,9,1*CKSUM \ Response: $PEMT160,9,1*CKSUM 2.2.11 The parameter ranges. \ *************************************************************************************************** POINTER VARIABLE %RecCtl %CtlFlag \ b31 =Rec type flag: 1:Control; 0:Log Data. \ b30 =Fix Type Change Trigger \ b29 = DGPS Mode: 0:Auto, 1:Exclusive \ b28 = SBAS Mode, 0:Testing, 1:Integrety \ b27|b24=DGPS used \ b23|b16= SBAS PRN \ b15|b0= CtlLogId. \ Movement Distance Trigger in meters 0,1-65535 \ Elapse Time Trigger in secs. 0,1-65535 \ in 0.1 HDOP \ in 1 degree \ in 1 % \ in 1 meter \ Velocity threshold in 0.1 Km/hr \ Alt threshold in 1 meter 0,1-255 0,1-255 0,1-255 0,1-255 0,1-65535 0,1-65535 WVARIABLE WVARIABLE CVARIABLE CVARIABLE CVARIABLE CVARIABLE WVARIABLE WVARIABLE WVARIABLE CVARIABLE CVARIABLE w%CtlMove w%CtlTime b%CtlDopChg b%CtlCogChg b%CtlVelChg b%CtlAltChg w%CtlVelThr w%CtlAltThr w%CtlStallTime b%CtlStallVel b%CtlChk \ Stall Time threshold in sec. 0,1-65535 \ Stall Velocity Threshold in 0.1 Km/Hr 0-255 \ Control Record chksume \ ********************************************************************************************************* 8 Data Logger Instruction Set 2.3 $PEMT161 ; Retrieve Logged Data / Infor ; ASCII Mode. 2.3.1 $PEMT161,0 \ $PEMT161,0 ; Get the Total Data Record Number. \ Command: $PEMT161,0*CKSUM \ Response: $PEMT161,0,total_rec_no*CKSUM 2.3.2 $PEMT161,1 \ $PEMT161,1 ; Get the number of records, Before the date, time given \ Command: $PEMT161,1,yymmdd,hhmmss*CKSUM \ Response: $PEMT161,1,start_rec_no,end_rec_no,total_no_rec*CKSUM 2.3.3 $PEMT161,2 \ $PEMT161,2 ; Get the number of records, After the date, time given \ Command: $PEMT161,2,yymmdd,hhmmss*CKSUM \ Response: $PEMT161,2,start_rec_no,end_rec_no,total_no_rec*CKSUM 2.3.4 $PEMT161,3 \ $PEMT161,3 ; Get the number of records, Between the date, time given \ Command: $PEMT161,3,yymmdd,hhmmss,yymmdd,hhmmss*CKSUM \ Response: $PEMT161,3,start_rec_no,end_rec_no,total_no_rec*CKSUM 2.3.5 $PEMT161,4 \ $PEMT161,4 ; Dump the record data by record sequencial no. \ Command: $PEMT161,4,begin,end*CKSUM \ Response: \ $PEMT161,4,rec_begin,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ $PEMT161,4,rec_begin+1,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ $PEMT161,4,rec_begin+2,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ $PSRF161,5 ; Dump the records befor the date, time setting 2.3.6 $PEMT161,5 \ Command: \ Response: $PEMT161,5,yymmdd,hhmmss*CKSUM \ $PEMT161,5,rec_no,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ $PEMT161,5,rec_no+1,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ $PEMT161,5,rec_no+2,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ . \ . \ . \ . \ $PEMT161,5,re_no+n,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM 9 Data Logger Instruction Set 2.3.7 $PEMT161,6 \ $PSRF161,6 ; Dump the records after the date, time setting \ Command: \ Response: $PEMT161,6,yymmdd,hhmmss*CKSUM \$PEMT161,6,rec_no,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \$PEMT161,6,rec_no+1,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \$PEMT161,6,rec_no+2,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM \ 2.3.8 $PEMT161,7 \ $PEMT161,7 ; Dump the records Between the date, time set \ Command: $PSRF161,7,yymmdd,hhmmss,yymmdd,hhmmss*CKSUM \ Response: \ \ \ \ \ \ \ \ $PEMT161,7,rec_no,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM $PEMT161,7,rec_no+1,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM $PEMT161,7,rec_no+2,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM . . . . $PEMT161,7,re_no+n,yymmdd,hhmmss,fix,dop,DDMM.mmmm,DDDMM.mmmm,MM.m,cog,vel*CKSUM 2.3.9. $PEMT161,8 \ $PEMT161,8 ; Clear All Logged data records. \ Command: $PEMT161,8*CKSUM \ Response: $PEMT161,8*CKSUM 2.4. $PEMT162 : Download Logged Data ; Binary Mode. 2.4.1.$PEMT162,0 \ $PSRF162,0 ; Download all data. \ Command: $PEMT162,0*CKSUM \ Response: $PEMT162,0,0*CKSUM \ Response: $PEMT162,0,1*CKSUM 2.4.2.$PEMT162,1 \ $PSRF162,1 ; Download the record data by record sequencial no. \ Command: $PEMT162,1,begin,end*CKSUM \ Response: $PEMT162,1,0*CKSUM ;No avaliable record for downloading \ Response: $PEMT162,1,1*CKSUM ;Start Xmodem binary transfer after this message. ;No available record for downloading ;Start Xmodem binary transfer after this message. 10 Data Logger Instruction Set 2.4.3.$PEMT162,2 \ $PSRF162,2 ; Download the record data before the date, time setting \ Command: $PEMT162,2,yymmdd,hhmmss*CKSUM \ Response: $PEMT162,2,0*CKSUM ;No available record for downloading \ Response: $PEMT162,2,1*CKSUM ;Start Xmodem binary transfer after this message. 2.4.4.$PEMT162,3 \ $PSRF162,3 ; Download the record data after the date, time setting \ Command: $PEMT162,3,yymmdd,hhmmss*CKSUM \ Response: $PEMT162,3,0*CKSUM ;No available record for downloading \ Response: $PEMT162,3,1*CKSUM ;Start Xmodem binary transfer after this message. 2.4.5.$PEMT162,4 \ $PSRF161,4 ; Download the record data Between the date, time set \ Command: $PEMT161,4,yymmdd,hhmmss,yymmdd,hhmmss*CKSUM \ Response: $PEMT162,4,0*CKSUM ;No available record for downloading \ Response: $PEMT162,4,1*CKSUM ;Start Xmodem binary transfer after this message. 2.4.6 Data Structure of $PEMT binary record data. One `VARIABLE' contains `Little-endian' 4 bytes data. There are totally 20 bytes in a single data record. POINTER VARIABLE %RecData %RecTime \ b31=Rec type flag: 1:Control; 0:Log Data. \ b30|b26=Year(20)nn;nn=0-31, \ b25|b22=Mon(1-12); \ b21|b17=Day(1-31); \ b16|b12=Hour(0-23); \ b11|b6=Min(0-59); \ b5|b0=Sec(0-59); \ -90000000 - +90000000 Unit: DDMMmmmm \ -180000000 - +180000000 Unit: DDDMMmmmm \ b31|b23=HDOP, \ b22= 1:DGPS used; \ b21|b20: 0,2,3 D fix. \ b19|b0=Alt, Unit: 0.1 DOP;0-500 Unit=0.1 Meter,-524288 - +524287 VARIABLE VARIABLE VARIABLE %RecLat %RecLon %RecDopFixAlt VARIABLE %RecChkVCog \ b31|b24: 1 Byte Rec Chksum \ b23|b9: VEL, 0 ­ 32767 Unit: 0.1 Km/Hr \ b8|b0: Cog, 0 ­ 360 Unit: 1 degree 11 Data Logger Instruction Set 2.5. $PEMT163 : System Firmware Command. 2.5.1.$PEMT163,0 \ Get Firmware Versions. \ Command: $PEMT163,0*CKSUM \ Response: $PEMT163,0,GswVer,GswBuild,LoggerVer,BtLogBuild*CKSUM 2.5.2.$PEMT163.1 \ Firmware Update (Binaray Mode). \ Command: $PEMT163,1,start_addr,byte_len,code_crc,GswBuild*CKSUM \ Response: $PEMT163,1,1*CKSUM ; Get into download/update process. \ $PEMT163,1,0*CKSUM ; Not valid input. Remark: Demo application program for BTGPS II Trine will be later on available on the EMTAC web site. 12