mirror of
https://github.com/torvalds/linux.git
synced 2026-04-24 17:42:27 -04:00
bef7b2a7be
Pull devicetree updates from Rob Herring: - Unit test for overlays with GPIO hogs - Improve dma-ranges parsing to handle dma-ranges with multiple entries - Update dtc to upstream version v1.6.0-2-g87a656ae5ff9 - Improve overlay error reporting - Device link support for power-domains and hwlocks bindings - Add vendor prefixes for Beacon, Topwise, ENE, Dell, SG Micro, Elida, PocketBook, Xiaomi, Linutronix, OzzMaker, Waveshare Electronics, and ITE Tech - Add deprecated Marvell vendor prefix 'mrvl' - A bunch of binding conversions to DT schema continues. Of note, the common serial and USB connector bindings are converted. - Add more Arm CPU compatibles - Drop Mark Rutland as DT maintainer :( * tag 'devicetree-for-5.7' of git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux: (106 commits) MAINTAINERS: drop an old reference to stm32 pwm timers doc MAINTAINERS: dt: update etnaviv file reference dt-bindings: usb: dwc2: fix bindings for amlogic, meson-gxbb-usb dt-bindings: uniphier-system-bus: fix warning in the example dt-bindings: display: meson-vpu: fix indentation of reg-names' "items" dt-bindings: iio: Fix adi, ltc2983 uint64-matrix schema constraints dt-bindings: power: Fix example for power-domain dt-bindings: arm: Add some constraints for PSCI nodes of: some unittest overlays not untracked of: gpio unittest kfree() wrong object dt-bindings: phy: convert phy-rockchip-inno-usb2 bindings to yaml dt-bindings: serial: sh-sci: Convert to json-schema dt-bindings: serial: Document serialN aliases dt-bindings: thermal: tsens: Set 'additionalProperties: false' dt-bindings: thermal: tsens: Fix nvmem-cell-names schema dt-bindings: vendor-prefixes: Add Beacon vendor prefix dt-bindings: vendor-prefixes: Add Topwise of: of_private.h: Replace zero-length array with flexible-array member docs: dt: fix a broken reference to input.yaml docs: dt: fix references to ap806-system-controller.txt ...
87 lines
2.5 KiB
YAML
87 lines
2.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/iio/proximity/devantech-srf04.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Devantech SRF04 and Maxbotix mb1000 ultrasonic range finder
|
|
|
|
maintainers:
|
|
- Andreas Klinger <ak@it-klinger.de>
|
|
|
|
description: |
|
|
Bit-banging driver using two GPIOs:
|
|
- trigger-gpio is raised by the driver to start sending out an ultrasonic
|
|
burst
|
|
- echo-gpio is held high by the sensor after sending ultrasonic burst
|
|
until it is received once again
|
|
|
|
Specifications about the devices can be found at:
|
|
http://www.robot-electronics.co.uk/htm/srf04tech.htm
|
|
|
|
http://www.maxbotix.com/documents/LV-MaxSonar-EZ_Datasheet.pdf
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- devantech,srf04
|
|
- maxbotix,mb1000
|
|
- maxbotix,mb1010
|
|
- maxbotix,mb1020
|
|
- maxbotix,mb1030
|
|
- maxbotix,mb1040
|
|
|
|
trig-gpios:
|
|
description:
|
|
Definition of the GPIO for the triggering (output)
|
|
This GPIO is set for about 10 us by the driver to tell the device it
|
|
should initiate the measurement cycle.
|
|
See Documentation/devicetree/bindings/gpio/gpio.txt for information
|
|
on how to specify a consumer gpio.
|
|
maxItems: 1
|
|
|
|
echo-gpios:
|
|
description:
|
|
Definition of the GPIO for the echo (input)
|
|
This GPIO is set by the device as soon as an ultrasonic burst is sent
|
|
out and reset when the first echo is received.
|
|
Thus this GPIO is set while the ultrasonic waves are doing one round
|
|
trip.
|
|
It needs to be an GPIO which is able to deliver an interrupt because
|
|
the time between two interrupts is measured in the driver.
|
|
maxItems: 1
|
|
|
|
power-gpios:
|
|
description:
|
|
Definition of the GPIO for power management of connected peripheral
|
|
(output).
|
|
This GPIO can be used by the external hardware for power management.
|
|
When the device gets suspended it's switched off and when it resumes
|
|
it's switched on again. After some period of inactivity the driver
|
|
get suspended automatically (autosuspend feature).
|
|
maxItems: 1
|
|
|
|
startup-time-ms:
|
|
description:
|
|
This is the startup time the device needs after a resume to be up and
|
|
running.
|
|
minimum: 0
|
|
maximum: 1000
|
|
default: 100
|
|
|
|
required:
|
|
- compatible
|
|
- trig-gpios
|
|
- echo-gpios
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/gpio/gpio.h>
|
|
proximity {
|
|
compatible = "devantech,srf04";
|
|
trig-gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>;
|
|
echo-gpios = <&gpio2 6 GPIO_ACTIVE_HIGH>;
|
|
};
|