Jump to content
  • EN

Template:1-Wire Accessory: Difference between revisions

From Teltonika Telematics Wiki
← Older edit
VisualWikitext
No edit summary
mNo edit summary
 
(5 intermediate revisions by the same user not shown)
Line 7: Line 7:
| iButton = iButtons.
| iButton = iButtons.
| RFID = RFID tags (by emulating them using iButton protocols).
| RFID = RFID tags (by emulating them using iButton protocols).
}}<br>
}}
1-Wire {{{accessory}}} readers are a convenient way to implement driver authorization and other functionalities.<br>
 
'''1-Wire {{{accessory}}} readers''' are a convenient way to implement driver authorization and other functionalities.
 
'''Use cases:'''
'''Use cases:'''
* Immobilizer - prevent the starting of a vehicle without first scanning an {{#switch: {{{accessory}}}
* Immobilizer - prevent the starting of a vehicle without first scanning an {{#switch: {{{accessory}}}
Line 18: Line 20:
| RFID = RFID tag
| RFID = RFID tag
}} they use to authenticate themselves.
}} they use to authenticate themselves.
* Auto Geofencing - get notified when a vehicle leaves a pre-defined area without authorization.
* Auto Geofencing - get notified when a vehicle leaves a pre-defined area without authorization.<br><br><br><br><br><br><br><br><br><br>
==Specifications==
==Specifications==
{{#switch: {{{accessory}}}
{{#switch: {{{accessory}}}
Line 73: Line 75:
</table>
</table>
| RFID =  
| RFID =  
{| class="wikitable"
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
|+
<tr>
! style="width:30%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |NAME
<th style="width:30%; vertical-align: middle; text-align: left;">NAME</th>
! style="border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |DESCRIPTION
<th style="width:30%; vertical-align: middle; text-align: left;">DESCRIPTION</th>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Interface
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |1-Wire Interface
<td style="vertical-align: middle; text-align: left;">Interface</td>
|-
<td style="vertical-align: middle; text-align: left;">1-Wire</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Wiring
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |White wire – 1-wire data, Brown wire – power supply, Green - ground.
<tr>
|-
<td style="vertical-align: middle; text-align: left;">Wiring</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Power Supply
<td style="vertical-align: middle; text-align: left;">White = 1-wire data, Brown = Power supply, Green = Ground.</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |6,5-30 V DC
</tr>
|-
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Frequency standard
<td style="vertical-align: middle; text-align: left;">Power Supply</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |125 kHz
<td style="vertical-align: middle; text-align: left;">6.5-30 VDC</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Type of transponder
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Manchester, 64 cycles per bit
<td style="vertical-align: middle; text-align: left;">Frequency standard</td>
|-
<td style="vertical-align: middle; text-align: left;">125 kHz</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Antenna surface area
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |6,8 cm²
<tr>
|-
<td style="vertical-align: middle; text-align: left;">Type of transponder</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Reading range
<td style="vertical-align: middle; text-align: left;">Manchester, 64 cycles per bit</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |4 cm
</tr>
|-
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Reading frequency
<td style="vertical-align: middle; text-align: left;">Antenna surface area</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |6 times per second for identification, 2 times per second when transponder is in range of reader
<td style="vertical-align: middle; text-align: left;">6,8 cm²</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Supported 1-Wire commands
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |0x33 (0x0F) - Read ROM, 0xF0 - Search ROM
<td style="vertical-align: middle; text-align: left;">Reading range</td>
|-
<td style="vertical-align: middle; text-align: left;">4 cm</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Fastening method
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |M12 thread
<tr>
|-
<td style="vertical-align: middle; text-align: left;">Reading frequency</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Cable length
<td style="vertical-align: middle; text-align: left;">6 times per second for identification, 2 times per second when transponder is in range of reader</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |40 cm
</tr>
|-
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Operating temperature
<td style="vertical-align: middle; text-align: left;">Supported 1-Wire commands</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |-20 ºC to +55 ºC
<td style="vertical-align: middle; text-align: left;">0x33 (0x0F) - Read ROM, 0xF0 - Search ROM</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Operating humidity
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Up to 70%
<td style="vertical-align: middle; text-align: left;">Fastening method</td>
|-
<td style="vertical-align: middle; text-align: left;">M12 thread</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Supported by
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span class="mw-collapsible mw-collapsed"> [https://wiki.teltonika-gps.com/view/FMB110 FMB110], [https://wiki.teltonika-gps.com/view/FMB120 FMB120], [https://wiki.teltonika-gps.com/view/FMB122 FMB122], [https://wiki.teltonika-gps.com/view/FMB125 FMB125], [https://wiki.teltonika-gps.com/view/FMU125 FMU125], [https://wiki.teltonika-gps.com/view/FMM125 FMM125], [https://wiki.teltonika-gps.com/view/FMC125 FMC125], [https://wiki.teltonika-gps.com/view/FMB130 FMB130], [https://wiki.teltonika-gps.com/view/FMU130 FMU130], [https://wiki.teltonika-gps.com/view/FMC130 FMC130], [https://wiki.teltonika-gps.com/view/FMM130 FMM130], [https://wiki.teltonika-gps.com/view/FMB140 FMB140], [https://wiki.teltonika-gps.com/view/FMB202 FMB202], [https://wiki.teltonika-gps.com/view/FMB204 FMB204], [https://wiki.teltonika-gps.com/view/FMB640 FMB640], [https://wiki.teltonika-gps.com/view/FMC640 FMC640], [https://wiki.teltonika-gps.com/view/FMM640 FMM640] </span>
<tr>
|-
<td style="vertical-align: middle; text-align: left;">Cable length</td>
|}
<td style="vertical-align: middle; text-align: left;">40 cm</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">Operating temperature</td>
<td style="vertical-align: middle; text-align: left;">-20 ºC to +55 ºC</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">Operating humidity</td>
<td style="vertical-align: middle; text-align: left;">Up to 70%</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">Supported by</td>
<td style="vertical-align: middle; text-align: left;"><span class="mw-collapsible mw-collapsed"> [https://wiki.teltonika-gps.com/view/FMB110 FMB110], [https://wiki.teltonika-gps.com/view/FMB120 FMB120], [https://wiki.teltonika-gps.com/view/FMB122 FMB122], [https://wiki.teltonika-gps.com/view/FMB125 FMB125], [https://wiki.teltonika-gps.com/view/FMU125 FMU125], [https://wiki.teltonika-gps.com/view/FMM125 FMM125], [https://wiki.teltonika-gps.com/view/FMC125 FMC125], [https://wiki.teltonika-gps.com/view/FMB130 FMB130], [https://wiki.teltonika-gps.com/view/FMU130 FMU130], [https://wiki.teltonika-gps.com/view/FMC130 FMC130], [https://wiki.teltonika-gps.com/view/FMM130 FMM130], [https://wiki.teltonika-gps.com/view/FMB140 FMB140], [https://wiki.teltonika-gps.com/view/FMB202 FMB202], [https://wiki.teltonika-gps.com/view/FMB204 FMB204], [https://wiki.teltonika-gps.com/view/FMB640 FMB640], [https://wiki.teltonika-gps.com/view/FMC640 FMC640], [https://wiki.teltonika-gps.com/view/FMM640 FMM640] </span></td>
</tr>
</table>
}}
}}
==Installation==
==Installation==
Line 134: Line 150:
| iButton =  
| iButton =  
[[File:IButton RFID connection2.png|frameless|682x682px]]  
[[File:IButton RFID connection2.png|frameless|682x682px]]  
{| class="wikitable"
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
|+
<tr>
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |PIN NUMBER
<th style="width:10%; vertical-align: middle; text-align: left;">PIN</th>
! style="width:15%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |PIN NAME
<th style="width:45%; vertical-align: middle; text-align: left;">NAME</th>
! style="width:25%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |
<th style="width:45%; vertical-align: middle; text-align: left;">DESCRIPTION</th>
DESCRIPTION
</tr>
|-
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |1
<td style="vertical-align: middle; text-align: left;">1</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:#00B000">'''1-wire Data (Dallas Data)'''</span>
<td style="vertical-align: middle; text-align: left;">1-wire Data (Dallas Data)</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Sends iButton ID
<td style="vertical-align: middle; text-align: left;">Sends iButton ID</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |2
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:#000000">'''GND''' </span>(-)
<td style="vertical-align: middle; text-align: left;">2</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Ground.
<td style="vertical-align: middle; text-align: left;">GND (-)</td>
|}
<td style="vertical-align: middle; text-align: left;">Ground</td>
</tr>
</table>
| RFID =
| RFID =
[[File:RFID connection2.png|alt=|center|thumb|682x682px|Relay is optional, driver authentication can work only with RFID]]
[[File:RFID connection2.png|alt=|center|thumb|682x682px|Relay is optional, driver authentication can work only with RFID]]
{| class="wikitable"
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
|+
<tr>
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |PIN NUMBER
<th style="width:10%; vertical-align: middle; text-align: left;">PIN</th>
! style="width:15%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |PIN NAME
<th style="width:45%; vertical-align: middle; text-align: left;">NAME</th>
! style="width:25%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |
<th style="width:45%; vertical-align: middle; text-align: left;">DESCRIPTION</th>
DESCRIPTION
</tr>
|-
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |1
<td style="vertical-align: middle; text-align: left;">1</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:#00B000">'''1-wire Data (Data Dallas)'''</span>
<td style="vertical-align: middle; text-align: left;">1-wire Data (Dallas Data)</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Outputs identification data via 1-Wire interface
<td style="vertical-align: middle; text-align: left;">Sends iButton ID</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |2
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:#FF0000">'''VCC''' (+)</span>
<td style="vertical-align: middle; text-align: left;">2</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Power supply for the sensor (6,5-30 V DC)
<td style="vertical-align: middle; text-align: left;">VCC (+)</td>
|-
<td style="vertical-align: middle; text-align: left;">Power supply for the sensor (6.5-30 VDC)</td>
|-
</tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |3
<tr>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:#000000">'''GND''' </span>(-)
<td style="vertical-align: middle; text-align: left;">3</td>
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Ground
<td style="vertical-align: middle; text-align: left;">GND (-)</td>
|}
<td style="vertical-align: middle; text-align: left;">Ground</td>
</tr>
</table>
}}
}}
==Tracker Configuration==
==Tracker Configuration==
Line 176: Line 196:
| RFID = Because this RFID reader emulates the received RFID values as iButton values, in configuration software it has identical functionality as the iButton reader.
| RFID = Because this RFID reader emulates the received RFID values as iButton values, in configuration software it has identical functionality as the iButton reader.
}}
}}
The reader works as soon as it is connected, but the iButton isn't used anywhere other than displayed in the iButton I/O element. In order to use it for the Immobilizer scenario, the device must have the scenario enabled. Then, iButton check can be enabled to only accept iButtons specified in the iButton list under the 1-Wire tab.<br>
The reader works as soon as it is connected, but the iButton isn't used anywhere other than displayed in the iButton I/O element. In order to use it for the Immobilizer scenario, the device must have the scenario enabled. Then, iButton check can be enabled to only accept iButtons specified in the iButton list under the 1-Wire tab.<br>
[[File:IButtonReaderConfig.png|border|frameless|682x682px]]<br>
[[File:IButtonReaderConfig.png|border|frameless|682x682px]]<br>
Line 181: Line 202:
==Converting IO values to IDs==
==Converting IO values to IDs==
This short guide explains how to convert the iButton value in "I/O" menu to an ID usable in the iButton list in "1-Wire" menu.
This short guide explains how to convert the iButton value in "I/O" menu to an ID usable in the iButton list in "1-Wire" menu.
''Note! For FMx6 trackers, you do not need to convert these values.''
''Note! For FMx6 trackers, you do not need to convert these values.''
# Connect your 1-Wire accessory to the tracker according to the wiring scheme.
# Connect your 1-Wire accessory to the tracker according to the wiring scheme.
Line 188: Line 210:
# Take the value (here: 01437829000700CF) and convert it using the method shown below - then you will be able to use it in the iButton List.
# Take the value (here: 01437829000700CF) and convert it using the method shown below - then you will be able to use it in the iButton List.
[[File:iButton_ID_decoding.png|center|600px]]
[[File:iButton_ID_decoding.png|center|600px]]
'''Excel algorithm (copy-paste to a sheet):'''
# Column names:
## A1-iButton I/O
## B1-Removed Ox string
## C1-Final ID
#Column values:
## A2=<code>0x01437829000700CF</code>
## B2=<code>=MID(A2; 3; LEN(A2) - 2)</code>
## C2=<code>=MID(B2; 15; 2) & MID(B2; 13; 2) & MID(B2; 11; 2) & MID(B2; 9; 2) & MID(B2; 7; 2) & MID(B2; 5; 2) & MID(B2; 3; 2) & MID(B2; 1; 2)</code>

Latest revision as of 13:50, 30 January 2026

Introduction

1-Wire data protocol, implemented in many Teltonika devices, can be used to read

1-Wire {{{accessory}}} readers are a convenient way to implement driver authorization and other functionalities.

Use cases:

  • Immobilizer - prevent the starting of a vehicle without first scanning an
  • Authorized driving - keep track of who is driving the vehicle according to the they use to authenticate themselves.
  • Auto Geofencing - get notified when a vehicle leaves a pre-defined area without authorization.









Specifications

Installation

Note! This chapter describes the installation of an accessory supplied by Teltonika. Accessories from other manufacturers may require different steps.
 To connect the accessory to your system:

  1. Connect the ground wire to the same grounding used for the device.
  2. Connect the 1-Wire Signal wire from the reader to the 1-Wire Data pin on the device.


Tracker Configuration

The reader works as soon as it is connected, but the iButton isn't used anywhere other than displayed in the iButton I/O element. In order to use it for the Immobilizer scenario, the device must have the scenario enabled. Then, iButton check can be enabled to only accept iButtons specified in the iButton list under the 1-Wire tab.

Converting IO values to IDs

This short guide explains how to convert the iButton value in "I/O" menu to an ID usable in the iButton list in "1-Wire" menu.

Note! For FMx6 trackers, you do not need to convert these values.

  1. Connect your 1-Wire accessory to the tracker according to the wiring scheme.
  2. Connect the tracker to a PC, run Teltonika Configurator.
  3. Open the "I/O" menu and find the "iButton" parameter.
  4. Scan the 1-Wire accessory on the reader. The value in Configurator will shortly change.
  5. Take the value (here: 01437829000700CF) and convert it using the method shown below - then you will be able to use it in the iButton List.

Excel algorithm (copy-paste to a sheet):

  1. Column names:
    1. A1-iButton I/O
    2. B1-Removed Ox string
    3. C1-Final ID
  2. Column values:
    1. A2=0x01437829000700CF
    2. B2==MID(A2; 3; LEN(A2) - 2)
    3. C2==MID(B2; 15; 2) & MID(B2; 13; 2) & MID(B2; 11; 2) & MID(B2; 9; 2) & MID(B2; 7; 2) & MID(B2; 5; 2) & MID(B2; 3; 2) & MID(B2; 1; 2)
Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Template:1-Wire_Accessory&oldid=110995"