Ignition Power Management

This chapter provides a description and instructions for configuration of the Ignition Power Management feature of the IR829 router. It also keeps the IR829 up and running while the vehicle is stopped. Therefore, users do not have to wait for routers to reload each time the vehicle is stopped. Ignition Power Management prevents the router from draining the charge of the battery on automotive applications.

When the engine is running, it generates energy and recharges the battery. When the ignition is turned off, the IR829 can remain operational for a pre-determined period of time. This time period is programmable between 60 to 7200 seconds (2 hours) using the IOS ignition off-timer command.

Features of Ignition Power Management

The system software (IOS) tries to prevent the discharge of the battery with the following:

  • Turning the router off if the vehicle has the ignition off for a period of time (programmable).

  • Turning the router off if the battery voltage drops to a certain level (programmable).

  • Attempting to protect the router by turning the router off if the battery voltage rises above a certain level (fixed amount of time).

The system software (IOS) logs the following events to the system log:

  • When the user turns on or off the ignition management feature with CLI

  • When the ignition is turned on or off

  • When the ignition-off timer expires and the system goes off

  • When the user enables or disables the feature through the CLI

  • Tentatively logs the under-voltage and over-voltage events

For additional information on connecting to a vehicle, see the Plugs and Pinouts section of the Hardware Installation Guide.

Command Line Interface (CLI)

The Ignition Power Management feature of the IR800 series uses a command line interface.

Configuration CLI

The following commands are used to configure the feature.

Enable ignition power management:

IR800#configure terminal
IR800(config)#ignition enable

Disable ignition power management:

IR800#configure terminal
IR800(config)#no ignition enable

Ignition off timer value. After the ignition is turned off the router will stay operational for this amount of time, then it shuts down if the ignition is still off: 

ignition off-timer <value>

Under-voltage threshold. If the input voltage drops to levels below this threshold, it will cause the router to shut down.

ignition undervoltage threshold <value>

Show the status of the feature:

IR800#show ignition

Configuring 12 Volt and 24 Volt Systems

Starting with release 15.8(3)M, the Ignition Undervoltage Threshold will display in in double decimal. There is a new cli that can be used ignition undervoltage threshold <Volt> <mV if any> .


Important
please note the following requirements.

If using a 12 volt system, it is required to set Undervoltage to 11V at a minimum.

If using a 24 volt system, it is required to set Undervoltage to 22V at a minimum.

The following example sets the Undervoltage to 11.200V for 12V input system:

IR800#configure terminal 
IR800(config)#ignition enable
IR800(config)#ignition undervoltage threshold 11 200
IR800(config)#end
IR800#write memory

The following command is used to show the status of the feature:

IR800#show ignition
Status:
  Ignition management: Enabled
  Input voltage:       12.0 V
  Ignition status:     Power on
  Shutdown timer:      0.0 s to off [will begin power down at ~100 sec
Thresholds:
  Undervoltage:        11.200 V
  Overvoltage:         32.0 V
  Undervoltage timer:  120.0 s
  Overvoltage timer:   1.0 s
  Ignition-Off timer:  900.0 s

The following example sets the Undervoltage to 22.200V for 24V input system:

IR800#configure terminal 
IR800(config)#ignition enable
IR800(config)#ignition undervoltage threshold 22 200
IR800(config)#end
IR800#write memory

The following command is used to show the status of the feature:


IR800#show ignition
Status:
  Ignition management: Enabled
  Input voltage:       24.0 V
  Ignition status:     Power on
  Shutdown timer:      0.0 s to off [will begin power down at ~100 sec
Thresholds:
  Undervoltage:        22.200 V
  Overvoltage:         32.0 V
  Undervoltage timer:  120.0 s
  Overvoltage timer:   1.0 s
  Ignition-Off timer:  900.0 s

Troubleshooting CLI

A set of CLIs are available for debugging purposes.


Note
To turn the debug off, prepend a no prefix to the CLI command.

The commands are:

Enable debugging error conditions in the ignition management:

debug ignition errors

Enable debugging operating events in the ignition management:

debug ignition events

Enable debugging state transitions in the ignition management software: 


IR800#debug ignition states
 
IR800#
*Mar 11 18:59:20.001: %IGNITION-5-IGN_DEBUG_SET: Ignition Management debugging states is turned on
*Mar 11 18:59:37.217: %IGNITION: Ignition mgmt FSM: IGNITION_MGMT_STATE_IGN_OFF
*Mar 11 18:59:39.679: %IGNITION-5-IGN_TURNED_ON_OFF: The ignition is turned OFF
*Mar 11 18:59:47.065: %IGNITION: Ignition mgmt FSM: IGNITION_MGMT_STATE_PWR_ON
*Mar 11 18:59:49.527: %IGNITION-5-IGN_TURNED_ON_OFF: The ignition is turned ON

Enable all debugging conditions at once: 


IR800#debug ignition all
IR800#conf t
*Mar 11 19:01:06.737: %IGNITION-5-IGN_DEBUG_SET: Ignition Management debugging all is turned on
Enter configuration commands, one per line.  End with CNTL/Z.
IR800(config)#igni
IR800(config)#ignition tim
IR800(config)#ignition of 
IR800(config)#ignition off-timer 800
IR800(config)#
*Mar 11 19:01:20.357: %IGNITION: handling off-time CLI
*Mar 11 19:01:23.115: %IGNITION: event set off timerdo show ignition
Status:
  Ignition management: Enabled
  Input voltage:       12.2 V
  Ignition status:     Power on
  Shutdown timer:      0.0 s to off
Thresholds:
  Undervoltage:        11.0 V
  Overvoltage:         32.0 V
  Undervoltage timer:  60.0 s
  Overvoltage timer:   0.5 s
  Ignition-Off timer:  800.0 s

Turn off debugging: 


IR800(config)#no ignition off-timer ?
  <cr>

Note
All debugging commands are cleared through a reboot of the device.
Another troubleshooting command is show ignition register. This displays existing register information:
IR800#show ignition register
*Nov 13 20:59:32.525: %SYS-5-CONFIG_I: Configured from console by consolereg
Load for five secs: 0%/0%; one minute: 0%; five minutes: 0%
Time source is hardware calendar, *20:59:35.081 UTC Mon Nov 13 2017
MCU Registers Dump:
===================
IR800_MCU_DEV_ID = 0x2F
IR800_MCU_IGNITION_STATE = 0x1
IR800_MCU_IGN_VOLTAGE_HI = 0x1
IR800_MCU_IGN_VOLTAGE_LO = 0x1B
IR800_MCU_IGN_CURRENT_TIMER_HI = 0x0
IR800_MCU_IGN_CURRENT_TIMER_LO = 0x0
IR800_MCU_IGN_HI_VOLTAGE_THRESHOLD_HI = 0x3
IR800_MCU_IGN_HI_VOLTAGE_THRESHOLD_LO = 0x7
IR800_MCU_IGN_LOW_VOLTAGE_THRESHOLD_HI = 0x0
IR800_MCU_IGN_LOW_VOLTAGE_THRESHOLD_LO = 0xFA
IR800_MCU_IGN_SENSE_OFF_TIMER_HI = 0x0
IR800_MCU_IGN_SENSE_OFF_TIMER_LO = 0xF0
IR800_MCU_IGN_HI_VOLTAGE_TIMER_HI = 0x0
IR800_MCU_IGN_HI_VOLTAGE_TIMER_LO = 0x1
IR800_MCU_IGN_LOW_VOLTAGE_TIMER_HI = 0x0
IR800_MCU_IGN_LOW_VOLTAGE_TIMER_LO = 0x78
IR800_MCU_IGN_SYS_FLAGS_2 = 0xF
IR800_MCU_IGN_SYS_FLAGS_1 = 0x8
IR800_MCU_IGN_ENABLE = 0x5A

Ignition Under-Voltage Characteristics

Under-voltage threshold: If the input voltage drops to levels below this threshold, it will cause the router to shut down.

ignition undervoltage threshold <value>

When the input voltage drops below the under-voltage threshold value, the IR829 initiates a shutdown process and will shutdown within 120 seconds. As part of the shutdown process, the IR829 initiates the under-voltage timer to count down from 120 seconds to 0 seconds.

If the input voltage is below the the under-voltage threshold for 20 seconds or more, the IR829 initiates a graceful shutdown. However, if there is a momentary flap of the input voltage for 2 to 10 seconds (for example, the router input voltage drops below the under-voltage threshold of 2 seconds and recovers back), the under-voltage timer is reset and the shutdown process is canceled.

For the router to cancel the shutdown process due to the recovery of the input voltage, the input voltage has be above the under-voltage threshold by 0.8V. This hysteresis is implemented to prevent the router from toggling between shutdown and recovery when the input voltage is very close to the under-voltage threshold.

Command Examples

The following examples illustrate the CLI commands and the associated output expected.

Out of box configuration with no ignition management configured.


IR800#show ignition
 
Status:
  Ignition management: Disabled
  Input voltage:       11.8 V
  Ignition status:     Power on
  Shutdown timer:      0.0 s to off [will begin power down at ~100 sec]
Thresholds:
  Undervoltage:        11.0 V
  Overvoltage:         32.0 V
  Undervoltage timer:  60.0 s
  Overvoltage timer:   0.5 s
  Ignition-Off timer:  900.0 s

Configure the device for ignition off timer of 60, and ignition under-voltage threshold of 11.

  1. Turn vehicle ignition switch off.

  2. ignition off-timer 60

  3. ignition undervoltage threshold 11

  4. ignition enable 


IR800#show ignition
 
Status:
  Ignition management: Enabled
  Input voltage:       11.8 V
  Ignition status:     Power on
  Shut down timer:     53.0 s to off
Thresholds:
  Undervoltage:        11.0 V
  Overvoltage:         32.0 V
  Undervoltage timer:  60.0 s
  Overvoltage timer:   0.5 s
  Ignition-Off timer:  60.0 s

Default Values

The following default settings apply to Ignition Power Management:

Setting

Default Value

User Modifiable?

Ignition Power Management Feature

Disabled

Yes

Ignition off timer

720 seconds

Yes

Under-Voltage threshold

9 Volts (up to IOS15.7(3)M)

11 Volts (IOS15.7(3)M1 and beyond)

Yes

Under-Voltage timer

60 seconds

(up to IOS15.7(3)M)

120 seconds

(IOS15.7(3)M1 and beyond)

No

Over-Voltage threshold

Defines the max input voltage that IR829 can handle.

32 Volts

No

Over-Voltage timer

Defines the duration of the input voltage above the over-voltage threshold.

1.0 seconds

 No

Note
If the device is upgraded from an IOS version below 15.7(3)M to 15.7(3)M1 or above, the threshold will not automatically change. You must manually configure “ignition under-voltage” to 11V for a 12 Volt system, or 22V for a 24 Volt system.