This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
standards:gps_device_preferences [2012/08/14 16:39] mjallison [Playback] |
standards:gps_device_preferences [2016/01/20 00:07] (current) mjallison [Example Format] |
||
---|---|---|---|
Line 17: | Line 17: | ||
<CONFIG_INFO> | <CONFIG_INFO> | ||
<Application name="SmartDirt"> | <Application name="SmartDirt"> | ||
- | <Last_Device>DFJKDFJKDFJKL</Last_Device> | + | <Last_Device>00:10:C6:2F:07</Last_Device> |
</Application> | </Application> | ||
<Application name="CoolApp7"> | <Application name="CoolApp7"> | ||
- | <Last_Device>DFJKDFJKDFJKL</Last_Device> | + | <Last_Device>00:03:7A:69:43:4C</Last_Device> |
</Application> | </Application> | ||
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. | ||