505
edits
Changes
Ignition detection solution (view source)
Revision as of 11:22, 28 August 2023
, 11:22, 28 August 2023→Action configuration
<p style="color:red">The information in this page is updated in accordance with firmware version '''[https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads 00.07.02.7]'''.
==Introduction==
==Introduction==
* 1st option - the device turns on with the ignition and turns off when the ignition goes off.
* 1st option - the device turns on with the ignition and turns off when the ignition goes off.
* 2nd option - the device turns on with the ignition and stays on for some time, even if the ignition is turned off.
* 2nd option - the device turns on with the ignition and '''stays on for some time''', even if the ignition is turned off.
This example will use the '''4-pin connector''', available on most of the Teltonika networking devices:
[[File:Networking rutos manual input output power socket pinout configurableio 0.png|border|class=tlt-border]]
To access the I/O pins and power the device at the same time you would likely need one of these adaptors from our Accessories list:
* [https://teltonika-networks.com/product/power-cable-4way/ POWER CABLE WITH 4-WAY SCREW TERMINAL]
* [https://teltonika-networks.com/product/power-cable-with-4-way-open-wire/ POWER CABLE WITH 4-WAY OPEN WIRE]
* [https://teltonika-networks.com/product/4-pin-power-adapter-with-io-access/ 4-PIN POWER ADAPTER WITH I/O ACCESS]
==Schematics==
==Schematics==
The first schematic diagram provided gives you the ability to turn the device on and off depending on ignition state.
The first schematic diagram provided gives you the ability to turn the device on and off depending on ignition state.
[[File:Ignitionstateschematic.jpg|700px|border|class=tlt-border]]
To build this schematic, you would need two electrical components:
To build this schematic, you would need two electrical components:
* Diode
* '''Diode'''
1N4001 diode or similar could be used. It is used to protect the control circuit from the sudden voltage spike. If the relay that you are using has a flyback diode built in, this diode is not needed. '''NOTE: if you are using this schematic without the diode, you risk damaging the device'''.
1N4001 diode or similar could be used. It is used to protect the control circuit from the sudden voltage spike. If the relay that you are using has a flyback diode built in, this diode is not needed. '''NOTE: if you are using this schematic without the diode, you risk damaging the device'''.
* Electromagnetic Relay
* '''Electromagnetic Relay'''
Relay choice depends on vehicle's electrical system voltage. If this setup is installed into a Vehicle with 12 V system, then a relay similar to the CM1-12V could be used. Otherwise, if the electrical system is 24 V, a relay similar to the CB1-P-24V could be used. When choosing a relay, the most important aspect is '''Coil Voltage''', therefore I recommend using aforementioned relays based on the voltage.
Relay choice depends on vehicle's electrical system voltage. If this setup is installed into a Vehicle with 12 V system, then a relay with '''12 V Coil Voltage''' should be used. Otherwise, if the electrical system is 24 V, a relay with '''24 V Coil Voltage''' should be used.
When building this schematic, you can ground the device and the relay on the same spot, for example, chassis of the vehicle.
-----
-----
The second schematic diagram provided gives you the ability to turn the device on with the ignition and turn off only when certain preset time expires after the ignition is turned off.
The second schematic diagram provided gives you the ability to turn the device on with the ignition and turn off only when certain preset time expires after the ignition is turned off.
[[File:Schematicdelayoff.jpg|700px|border|class=tlt-border]]
To build this schematic, you would need to use the electrical components as mentioned above, only in this case we will use 2 Relays and 2 Diodes. As mentioned earlier, using this schematic without the diode, raises risk damaging the device.
To build this schematic, you would need to use the same electrical components as mentioned above, only in this case we will use 2 Relays and 2 Diodes. As mentioned earlier, '''using this schematic without the diode, raises risk damaging the device.'''
When building this schematic, make sure to ground only one relay and the device (these can be grounded at the same spot), notice that the secondary relay (on the right) gets ground from the device's output - this allows controlling the relay and delay the turning off time. Also, notice that ignition is connected both to the device input and to the first relay - this can be done from the same ignition source - there is no need to search for separate wires.
==Device configuration==
==Device configuration==
If you chose the first option, no additional device configuration is needed. If you would like a set up based on the second schematic, you would need to do additional configuring in the device. First of all, we need a custom startup script to toggle a second relay to ON position. Follow these steps to configure startup behavior:
If you chose the first option, no additional device configuration is needed. If you would like a set up based on the second schematic, you would need to do additional configuring in the device.
===Setting Output pin state===
----
First of all, we need to set the second relay to ON position by setting the Output pin to High state. Follow these steps to configure default Output pin state:
* Navigate to '''Services -> Input/Output -> Status'''.
* Press on the Output pin state to turn on.
[[File:Outputstate ignitiondetectionsolution.png|950px|border|class=tlt-border]]
Otherwise, the output pin can be set to high using startup script:
* Navigate to '''System -> Custom scripts -> Startup script'''.
* Navigate to '''System -> Custom scripts -> Startup script'''.
* Above the exit 0 text, input command to turn on the output Pin: ''ubus call ioman.gpio.dout1 update '{"value":"1"}'''
* Above the exit 0 text, input command to turn on the output Pin: ''ubus call ioman.gpio.dout1 update '{"value":"1"}'''
* Press '''Save & Apply'''.
[[File:Startupscriptoutput.png|500px|border|class=tlt-border]]
===Input/Output Juggler configuration===
----
Input/Output configuration also needs some changes for this functionality to work as intended.
* Navigate to '''Services -> Input/Output -> IO Juggler'''.
* In the general tab, press enable to turn on I/O Juggler functionality.
[[File:Enableiojuggler.png|border|500px||class=tlt-border]]
===Action configuration===
----
* Navigate to Actions tab.
* In the '''Add new instance''' section, input name ('''delayoff''' in this example) for action and in '''Type''' select '''Output''', press '''Add'''.
[[File:Typeoutputnamedelayoff.png|1100px|border|class=tlt-border]]
In the new window, configure the settings according to the explanations below. Here we are not using '''Maintain''' option in order for the relay to be set to ON position once the ignition is on again.
* Type: Output.
* Execution delay (how long you would like to keep the router on after the ignition turns off): your preferred time in seconds.
* Control: Output (4) (Output pin on which the relay control is connected).
* Maintain: Off
* State copying: On
* Source: Input (3)
Leave everything else as default, press '''Save & Apply'''.
[[File:Actionsettingsrelay.png|border|class=tlt-border]]
===Instance configuration===
----
Switch back to the '''General''' tab. In the '''Add new instance''' section, select '''Role: Input(3)''' and press '''Add''' to add new instance.
[[File:Generaladdnewinstanceinput.png|1100px|border|class=tlt-border]]
In the new window, configure the settings according to the explanations below.
* Press '''Enable''' to enable the instance.
* Trigger interval – 1 (you could input a higher value, for example, if you are connecting to '''ACC''' and input signal goes off for a second when starting the vehicle - it would allow the Output Pin state remain static in the starting moment).
* Trigger – Falling (reacts when Ignition state goes from On to Off).
* Add actions – select the action which you‘ve created previously ('''delayoff''' in this example).
* Press '''Save & Apply'''.
[[File:Jugglerinstance.png|border|class=tlt-border]]
[[File:Startupscriptoutput.png|border|class=tlt-border]]
With that, the configuration is finished. The device will stay on for as long as '''Execution delay''' value is set. If this example is not working as intended, please review the steps once again.
----
'''Disclaimer''': The information contained on this article is meant to provide an example on how to achieve Ignition detection functionality. If you decide to modify, use different components or connect the schematics differently - you are doing so at your own risk.
[[Category:Hardware application]]