freebsd-skq

History

ian 35b08f2f78 Update owc_gpiobus (one-wire over gpio) to the modern gpio_pin interface. It used to be required that a device be a child of gpiobus(4) to manipulate gpio pins. That requirement didn't work well for FDT-based systems with many cross-hierarchy users of gpio, so a more modern framework was created that removed the old hierarchy requirement. These changes adapt the owc_gpiobus driver to use the newer gpio_pin_* functions to acquire, release, and manipulate gpio pins. This allows a single driver to work for both hinted-attachment and fdt-based systems, and removes the requirement that any one-wire fdt nodes must appear at the root of the devicetree. Differential Revision: https://reviews.freebsd.org/D22710		2019-12-17 15:56:48 +00:00
..
ow_temp.c	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
ow.c	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
ow.h	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
owc_gpiobus.c	Update owc_gpiobus (one-wire over gpio) to the modern gpio_pin interface.	2019-12-17 15:56:48 +00:00
owll_if.m	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
owll.h	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
own_if.m	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
own.h	Regularize my copyright notice	2019-12-04 16:56:11 +00:00
README.txt

README.txt

Quick Design Document for 1-wire bus

In new bus terms, 1-wire devices are attached to 1-wire buses (ow)
which are attached to a one wire bridge (owc).

The implementation follows the terminology used in the Maxim AN927
Application note which defines the 1-wire bus as implemented for the
iButton product. This is considered to be the canonical definition of
the 1-wire bus. This means that the 1-wire bridge will implement the
owll(9) interface. ow is one wire. ll is for Link Level to mirror the ISO
stack terminology used by AN927. The 1-wire bus is implemented in the ow(4)
device, which implements the own(9) interface (n for network, the layer
described in the AN927). The presentation layer and above is the
responsibility of the client device drivers to implement.

Client drivers may only call the own(9) interface. The ow(4) driver
calls the owll(9) interface and implements the own(9).

$FreeBSD$