1.\" $OpenBSD: onewire.4,v 1.12 2021/05/03 07:09:26 jmc Exp $ 2.\" 3.\" Copyright (c) 2006 Alexander Yurchenko <grange@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: May 3 2021 $ 18.Dt ONEWIRE 4 19.Os 20.Sh NAME 21.Nm onewire 22.Nd 1-Wire bus 23.Sh SYNOPSIS 24.Cd "onewire* at gpioow?" 25.Cd "onewire* at uow?" 26.Pp 27.Cd "option ONEWIREVERBOSE" 28.Sh DESCRIPTION 291-Wire bus was originally developed by Dallas Semiconductor for connecting 30integrated circuits. 31It is commonly used for connecting devices such as electronic keys, EEPROMs, 32temperature sensors, real-time clocks, security chips, etc. 33.Pp 34The 35.Nm 36driver provides a uniform programming interface layer between 371-Wire master controllers and various 1-Wire slave devices. 38Each 1-Wire master controller attaches a 39.Nm 40framework; several slave devices can then be attached to the 41.Nm 42bus. 43.Pp 44The driver supports plugging and unplugging slave devices on the fly. 45.Sh SUPPORTED MASTERS 46.Bl -tag -width 11n -offset ind -compact 47.It Xr gpioow 4 481-Wire bus bit-banging through GPIO pin 49.It Xr ioc 4 50IOC3 generic workstation I/O device 51.It Xr uow 4 52Maxim/Dallas DS2490 USB 1-Wire adapter 53.El 54.Sh SUPPORTED SLAVES 55.Bl -tag -width 11n -offset ind -compact 56.It Xr owctr 4 571-Wire counter device 58.It Xr owid 4 591-Wire ID device 60.It Xr owsbm 4 611-Wire smart battery monitor device 62.It Xr owtemp 4 631-Wire temperature device 64.El 65.Sh SEE ALSO 66.Xr intro 4 67.Sh HISTORY 68The 69.Nm 70driver first appeared in 71.Ox 4.0 . 72.Sh AUTHORS 73.An -nosplit 74The 75.Nm 76driver was written by 77.An Alexander Yurchenko Aq Mt grange@openbsd.org . 78