Merge tag 'trace-printf-v6.13' of git://git.kernel.org/pub/scm/linux/kernel/git/trace...
[drm/drm-misc.git] / Documentation / w1 / masters / w1-gpio.rst
blob15236605503bf164080815b68c5163e3f78d3164
1 =====================
2 Kernel driver w1-gpio
3 =====================
5 Author: Ville Syrjala <syrjala@sci.fi>
8 Description
9 -----------
11 GPIO 1-wire bus master driver. The driver uses the GPIO API to control the
12 wire and the GPIO pin can be specified using GPIO machine descriptor tables.
13 It is also possible to define the master using device tree, see
14 Documentation/devicetree/bindings/w1/w1-gpio.yaml
17 Example (mach-at91)
18 -------------------
22   #include <linux/gpio/machine.h>
23   #include <linux/w1-gpio.h>
25   static struct gpiod_lookup_table foo_w1_gpiod_table = {
26         .dev_id = "w1-gpio",
27         .table = {
28                 GPIO_LOOKUP_IDX("at91-gpio", AT91_PIN_PB20, NULL, 0,
29                         GPIO_ACTIVE_HIGH|GPIO_OPEN_DRAIN),
30         },
31   };
33   static struct w1_gpio_platform_data foo_w1_gpio_pdata = {
34         .ext_pullup_enable_pin  = -EINVAL,
35   };
37   static struct platform_device foo_w1_device = {
38         .name                   = "w1-gpio",
39         .id                     = -1,
40         .dev.platform_data      = &foo_w1_gpio_pdata,
41   };
43   ...
44         at91_set_GPIO_periph(foo_w1_gpio_pdata.pin, 1);
45         at91_set_multi_drive(foo_w1_gpio_pdata.pin, 1);
46         gpiod_add_lookup_table(&foo_w1_gpiod_table);
47         platform_device_register(&foo_w1_device);