Cisco 809/829 GPS Configuration

This article explains how to use the GPS coordiantes from the internal GPS of the 809/829 platform

Prerequisites

To use the GPS of the 809/829, the following conditions have to be met on the router

  1. The GPS has to be enabled. This means this config has to be added to the router IOS configuration:

    controller Cellular 0
     lte gps mode standalone
     lte gps nmea ip
  2. The SNMP has to be enabled, with at least a read community set:

    snmp-server community public RW
    snmp-server community private RO

Sensor configuration

 

Once the router IOS is configured properly, the sensor configuration has to be added to the site template. The following config has to be added:

<sensors>
	<sensor sensor_id="device_gps_location">
		<sensor_class>gps_coordinates</sensor_class>
		<sensor_gateway sensor_gateway_id="gw_ISR829_gps_coordinates">
			<demux method="normalize_cisco_GPS_coordinates">
				<keys>
					<key>1.3.6.1.4.1.9.9.661.1.4.1.1.1.4.17</key>
					<key>1.3.6.1.4.1.9.9.661.1.4.1.1.1.5.17</key>
				</keys>
			</demux>
		</sensor_gateway>
	</sensor>
</sensors>
<devices>
	<device device_id='dev_ISR829_snmp'>
		<snmp_device>
			<ip_settings>
				<address>192.168.1.1</address>
				<port>161</port>
			</ip_settings>
			<snmp_settings>
				<community>public</community>
				<protocol_version>2c</protocol_version>
			</snmp_settings>
		</snmp_device>
		<sensor_gateways>
			<sensor_gateway sensor_gateway_id="gw_ISR829_gps_coordinates">
				<snmp>
					<OIDs>
						<OID>1.3.6.1.4.1.9.9.661.1.4.1.1.1.4.17</OID>
						<OID>1.3.6.1.4.1.9.9.661.1.4.1.1.1.5.17</OID>
					</OIDs>
					<scheduling>
						<polling_interval>2</polling_interval>
						<error_handling>
							<retry retry_algorithm="linear"  retry_interval_before_alert="15"/>
							<timeout_handling>
								<fixed_timeout>5</fixed_timeout>
							</timeout_handling>
						</error_handling>
					</scheduling>
				</snmp>		        
			</sensor_gateway>
		</sensor_gateways>
	</device>
</devices>

The template can be downloaded from here: Cisco_8x9_GPS.template.xml

A few important points about this:

  • The OIDs are fixed, as they are defined for this platform
  • The sensor name "device_gps_location" has to remain the same for the cloud to automatically use the coordinates. If no automatic update on the cloud is needed, then the name can change.
  • The device IP address is the router IP as set on the virtual switch that connects with the GOS (the GigabitEthernet5 on the 829, the GigabitEthernet2  on the 809)
  • The community has to be set with the same name used on the IOS configuration.

 

For this configuration to work the SNMP module has to be enabled on the SiteController.cfg (or packet_config.ini) file.

 

Cloud configuration


For enabling the automatic coordinates update on the cloud:

  1. Go to My organization
  2. Click on Edit
  3. Go to the Address tab
  4. Enable the update from sensor click box
  5. Click Load last GPS info
  6. Save

 

There is no content with the specified labels