Ignition Power Management Commands

ignition enable

To enable the ignition module in the Cisco IR1800 routers, use the ignition enable command in global configuration mode.

To disable ignition power management, configure no ignition enable and no ignition sense.

ignition enable

no ignition enable

Syntax Description

Syntax

Description

ignition

Configure ignition power management on the router.

enable

Enable ignition power management on the router.

Command Default

No default behavior or values.

Command Modes

None.

Command History

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None

Example

The following example configures the router to detect whether a vehicle ignition is on or off:

ignition enable
ignition sense

ignition sense

To detect whether the ignition is on/off, use the ignition sense command in global configuration mode.

To disable ignition sense, configure no ignition sense.


Note

The no ignition sense command is applicable only for IR1835 devices.

ignition sense

no ignition sense

Syntax Description

Syntax

Description

ignition sense

Configure the router to monitor the power supply voltage and detect whether ignition is on or off based on the configured thresholds.

Note

 

When ignition sense is disabled (on IR1835 only), it uses the ignition signal pin to detect whether ignition is on or off.

Command Default

No default behavior or values.

Command Modes

None.

Command History

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None.

Example

The following example configures the router to detect whether a vehicle ignition is on or off:

ignition enable
ignition sense

ignition battery-type

To configure the battery type used for input voltage, use the ignition battery-type command in global configuration mode.

ignition battery-type { 12 24 }

Syntax Description

Syntax

Description

battery-type

Configures the battery type as 12 V or 24 V.

Command Default

The default battery type is 12 V.

Command Modes

None.

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None.

Example

The following example shows the battery type being configured as 12 volts:

ignition battery-type 12v

ignition off-timer

To delay router shutdown after the ignition status changes to off, use the ignition off-timer command in global configuration mode.

ignition off-timer seconds

Syntax Description

Syntax

Description

off-timer

Configures a delay (in seconds) before the router shuts down after the ignition is turned off.

Note

The device shutdown process begins approximately 100 seconds before the configured off-timer value.

Command Default

300 seconds.

Command Modes

None.

Command History

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None.

Example

The following example configures a delay of 300 seconds before the router shuts down after the ignition is turned off:

ignition off-timer 300

ignition undervoltage threshold

To configure undervoltage parameter to trigger system shutdown if the voltage drops below a specific threshold, use the ignition undervoltage threshold command in global configuration mode.

ignition undervoltage threshold volts millivolts

Syntax Description

Syntax

Description

undervoltage threshold

Configures the undervoltage parameter to trigger system shutdown if the voltage drops below a specific threshold.

Command Default

9.000 V

Command Modes

None.

Command History

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None

Example

The following example configures an undervoltage of 9 V (shown as 9 V and 0 millivolts):

ignition undervoltage threshold 9 0

ignition sense-voltage threshold

To configure only a single threshold and set the on-threshold to threshold +0.2V and the off-threshold to threshold -0.2V, use the ignition sense-voltage threshold command in global configuration mode.

ignition sense-voltage threshold

Syntax Description

Syntax

Description

sense-voltage threshold

Configures only a single threshold and sets the on-threshold to threshold+0.2V and the off-threshold to threshold-0.2V

Command Default

No default behavior or values.

Command Modes

None.

Command History

Release Modification

Cisco IOS XE Catalyst SD-WAN Release 17.6.1a

This command was introduced.

Usage Guidelines

None

Example

The following example configures an on-threshold voltage of +0.2V, and an off-threshold voltage of -0.2V:

 ignition sense-voltage threshold

ignition sense-voltage on-threshold off-threshold

To configure the on-threshold voltage and off-threshold voltage separately, use the ignition sense-voltage on-threshold off-threshold command in global configuration mode.

ignition sense-voltage on-threshold volts millivolts off-threshold volts millivolts

Syntax Description

Syntax

Description

on-threshold

Configures the voltage above which the router will be powered on if it is currently off.

off-threshold

Configures the voltage below which the router will be powered off if it is currently on.

Command Default

No default behavior or values.

Command Modes

None.

Command History

Release Modification
Cisco IOS XE Catalyst SD-WAN Release 17.18.1a

This command was introduced.

Usage Guidelines

None

Example

The following example configures an on-threshold voltage of 11 volts and 900 millivolts, and an off-threshold voltage of 11 volts and 500 millivolts: 

 ignition sense-voltage on-threshold 11 900 off-threshold 11 500