User Tools

Site Tools


standards:gps_device_preferences

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
standards:gps_device_preferences [2012/08/14 16:40]
mjallison [Example Format]
standards:gps_device_preferences [2016/01/20 00:07] (current)
mjallison [Example Format]
Line 29: Line 29:
  
  <!-- 1. PPP(Internet) connection parameters -->  <!-- 1. PPP(Internet) connection parameters -->
- <GPRS_DIAL>​*99***1#</​GPRS_DIAL>​ + <GPRS> 
- <GPRS_USER>​ISPDA@CINGULAR.COM</​GPRS_USER>​ + <DIAL>​*99***1#</​GPRS_DIAL>​ 
- <GPRS_PASSWORD>​CINGULAR1</​GPRS_PASSWORD>​ + <USER>​ISPDA@CINGULAR.COM</​GPRS_USER>​ 
- <GPRS_MODEM>​tps</​GPRS_MODEM>​ + <PASSWORD>​CINGULAR1</​GPRS_PASSWORD>​ 
- <GPRS_PIN>​0000</​GPRS_PIN>​ + <MODEM>​tps</​GPRS_MODEM>​ 
- <GPRS_APN>​isp.cingular</​GPRS_APN>​+ <PIN>​0000</​GPRS_PIN>​ 
 + <APN>​isp.cingular</​GPRS_APN
 + </GPRS>
  
  <!-- 2. NTRIP caster (server) parameters -->  <!-- 2. NTRIP caster (server) parameters -->
  <!-- Port: dev/​ser/<​x>​ or dev/​tcp/<​x>,​ <​x>​=a,​b,​c,​ or d -->  <!-- Port: dev/​ser/<​x>​ or dev/​tcp/<​x>,​ <​x>​=a,​b,​c,​ or d -->
- <NTRIP_DATA_PORT>​dev/​tcp/​a</​NTRIP_DATA_PORT>​ + <NTRIP> 
- <NTRIP_ADDRESS>​12.107.178.211</​NTRIP_ADDRESS>​ + <​DATA_PORT>​dev/​tcp/​a</​NTRIP_DATA_PORT>​ 
- <NTRIP_PORT>​8008</​NTRIP_PORT>​ + <ADDRESS>​12.107.178.211</​NTRIP_ADDRESS>​ 
- <NTRIP_USER>​EricI</​NTRIP_USER>​ + <PORT>​8008</​NTRIP_PORT>​ 
- <NTRIP_PASSWORD>​EricI</​NTRIP_PASSWORD>​+ <USER>​EricI</​NTRIP_USER>​ 
 + <PASSWORD>​EricI</​NTRIP_PASSWORD>​
  
- <!-- 3. Mount Point or ref station, i.e. 8008_RTCM,​.. --> + <!-- 3. Mount Point or ref station, i.e. 8008_RTCM,​.. --> 
- <NTRIP_MOUNTPOINT>​NETWORK_RTK_CMR+_GG</​NTRIP_MOUNTPOINT>​+ <MOUNTPOINT>​NETWORK_RTK_CMR+_GG</​NTRIP_MOUNTPOINT>​
  
- <!-- 4. Period to send NMEA in seconds --> + <!-- 4. Period to send NMEA in seconds --> 
- <NTRIP_NMEA_PERIOD>​10</​NTRIP_NMEA_PERIOD>​+ <NMEA_PERIOD>​10</​NTRIP_NMEA_PERIOD
 + </​NTRIP>
  
  <!-- 5. cmd|echo|rtcm|rtcm3|cmr|jps|omni|dtp|term|none -->  <!-- 5. cmd|echo|rtcm|rtcm3|cmr|jps|omni|dtp|term|none -->
- <RX_INPUT_MODE>​cmr</​RX_INPUT_MODE>+                ​<!-- NB: This parameter is also applied to base stations for sending. --> 
 + <​correction>​ 
 +                   <​mode>cmr<​mode>​ 
 +                ​</correction>
  </​TOPCON>​  </​TOPCON>​
 </​CONFIG_INFO>​ </​CONFIG_INFO>​
Line 60: Line 67:
  
 Valid provider names are: Valid provider names are:
-  * Altus +  * AltusAPS3 
-  * AltusCell+  * AltusAPS3Cell
   * Leica   * Leica
   * LeicaCell   * LeicaCell
Line 69: Line 76:
   * Builtin (functionally equivalent to an NMEA device, not RTK quality, supplied natively on some mobile platforms).   * Builtin (functionally equivalent to an NMEA device, not RTK quality, supplied natively on some mobile platforms).
   * Playback - AKA Simulation for playing back GPX files. ​   * Playback - AKA Simulation for playing back GPX files. ​
 +  * Unknown - Placeholder type allowing unconfigured devices to be remembered. Applications are free to ignore these, or present them to the user so they can be configured. ​
  
 ===== Device Entries ===== ===== Device Entries =====
Line 83: Line 91:
 Each of the following exception lists the device parameters, if any.  Each of the following exception lists the device parameters, if any. 
  
-==== Altus ==== +==== AltusAPS3 ​==== 
-TBD +  * RADIO 
-==== AltusCell ​==== +    * <​CONFIG>​ - Boolean, if true configure the UHF radio, otherwise do not configure the radio 
-TBD+    * <​CHANNEL>​ - The radio channel to use (if the radio is configured) 
 +  * USE 
 +    * <​GLONASS>​ - Boolean, if true use GLONASS satellites for solutions, otherwise only use GPS 
 +==== AltusAPS3Cell ​==== 
 +  * GPRS - PPP/​Internet connection parameters 
 +    * <​USER>​ - User id to establish connection 
 +    * <​PASSWORD>​ - User password to establish connection 
 +    * <APN> - E.g. isp.congular 
 +  * NTRIP Caster parameters 
 +    * <​ADDRESS>​ - IP Address of NTRIP server, e.g. 12.107.178.211,​ or [[FQDN]] 
 +    * <​PORT>​ - TCP port, e.g. 8008 
 +    * <​USER>​ - NTRIP user ID for authentication 
 +    * <​PASSWORD>​ - NTRIP password for authentication 
 +    * <​MOUNTPOINT>​ - NTRIP defined mount point 
 +    * <​MOUNTLIST>​ - List of mount points. Each MP is a pair of "​display string"/"​mount name"​ 
 +       * E.G: RTCM3_MAX/​RTCM3_MAX,​RTCM3_IMAX/​RTCM3_IMAX,​RTCM3_NEAR/​RTCM3_NEAR,​RTCM3_ViRS/​RTCM3_ViRS 
 ==== Topcon ==== ==== Topcon ====
 Reference "GRIL Reference Manual",​ December 2009, Topcon Reference "GRIL Reference Manual",​ December 2009, Topcon
Line 96: Line 120:
  
   * <​ELEVATION_MASK>​ - Numeric value   * <​ELEVATION_MASK>​ - Numeric value
-  * PPP/​Internet connection parameters 
-    * <​GPRS_DIAL>​ - Phone number to dial 
-    * <​GPRS_USER>​ - User id to establish connection 
-    * <​GPRS_PASSWORD>​ - User password to establish connection 
-    * <​GPRS_MODEM>​ - Which modem to use 
-    * <​GPRS_PIN>​ - PIN number 
-    * <​GPRS_APN>​ - APN identifier 
-  * NTRIP Caster credentials 
-    * <​NTRIP_DATA_PORT>​ - Dataport to use, e.g. dev/tcp/a 
-    * <​NTRIP_ADDRESS>​ - IP Address of NTRIP server, e.g. 12.107.178.211 
-    * <​NTRIP_PORT>​ - TCP port, e.g. 8008 
-    * <​NTRIP_USER>​ - NTRIP user ID for authentication 
-    * <​NTRIP_PASSWORD>​ - NTRIP password for authentication 
-  * <​NTRIP_MOUNTPOINT>​ - NTRIP defined mount point 
-    * NB: May add to this for a list of NTRIP mount points. 
-  * <​NTRIP_NMEA_PERIOD>​ - Integer period of NTRIP NMEA updates 
   * <​RX_INPUT_MODE>​ - e.g. cmr   * <​RX_INPUT_MODE>​ - e.g. cmr
 +  * GPRS - PPP/​Internet connection parameters
 +    * <​DIAL>​ - Phone number to dial
 +    * <​USER>​ - User id to establish connection
 +    * <​PASSWORD>​ - User password to establish connection
 +    * <​MODEM>​ - Which modem to use
 +    * <PIN> - PIN number
 +    * <APN> - APN identifier
 +  * NTRIP Caster parameters
 +    * <​DATA_PORT>​ - Dataport to use, e.g. dev/tcp/a
 +    * <​ADDRESS>​ - IP Address of NTRIP server, e.g. 12.107.178.211,​ or [[FQDN]]
 +    * <​PORT>​ - TCP port, e.g. 8008
 +    * <​USER>​ - NTRIP user ID for authentication
 +    * <​PASSWORD>​ - NTRIP password for authentication
 +    * <​MOUNTPOINT>​ - NTRIP defined mount point
 +    * <​MOUNTLIST>​ - List of mount points. Each MP is a pair of "​display string"/"​mount name"
 +       * E.G: RTCM3_MAX/​RTCM3_MAX,​RTCM3_IMAX/​RTCM3_IMAX,​RTCM3_NEAR/​RTCM3_NEAR,​RTCM3_ViRS/​RTCM3_ViRS
 +    * <​NMEA_PERIOD>​ - Integer period of NTRIP NMEA updates
  
  
Line 158: Line 183:
  
 ===== Application ===== ===== Application =====
-The application tag allows each application to save the last known device. ​+The application tag allows each application to save the last known device. ​The Application tag has one required attribuite, "​name",​ which is the applications unique name.  
 + 
 +The only tag currently supported is: 
 +  * <​Last_Device>​ - The unique ID (macAddress|Builtin|Playback) of the last used device. 
 ===== Changes from pre-existing version ===== ===== Changes from pre-existing version =====
-Changes between ​George'​s ​XML format ​and this spec:+Changes between ​the previous ​XML examples ​and this spec:
   * TOPCON_GPS is named TOPCON   * TOPCON_GPS is named TOPCON
   * LEICA_GPS is named LEICA   * LEICA_GPS is named LEICA
Line 166: Line 195:
   * There may be more than one instance of any type of device in the file, but they must be unique by "​id"​ value   * There may be more than one instance of any type of device in the file, but they must be unique by "​id"​ value
   * Some parameter names are changed to be consistent between types, e.g. NTRIP parameters. More work needed here.    * Some parameter names are changed to be consistent between types, e.g. NTRIP parameters. More work needed here. 
 +  * Parameter groups for things like GPRS and NTRIP are now set aside in their own tag groups instead of partitioning based on individual parameter names. For instance:
 +     * <​GPRS_USER>​ becomes\\
 +       <​code>​
 +          <​GPRS>​
 +             <​USER>​blagh</​USER>​
 +          </​GPRS>​
 +       </​code>​
 +       Other GPRS parameters are also in the GPRS block. Similar for NTRIP.
  
standards/gps_device_preferences.1344962445.txt.gz · Last modified: 2012/10/10 06:50 (external edit)