-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
dt-bindings: add parallax ping sensors
Add dt-bindings for parallax PING))) and LaserPING iio sensors, which are used for measuring distances. Signed-off-by: Andreas Klinger <ak@it-klinger.de> Reviewed-by: Rob Herring <robh@kernel.org> Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
- Loading branch information
Andreas Klinger
authored and
Jonathan Cameron
committed
Nov 23, 2019
1 parent
3e97696
commit b7f35e7
Showing
1 changed file
with
51 additions
and
0 deletions.
There are no files selected for viewing
51 changes: 51 additions & 0 deletions
51
Documentation/devicetree/bindings/iio/proximity/parallax-ping.yaml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
# SPDX-License-Identifier: (GPL-2.0-or-later OR BSD-2-Clause) | ||
%YAML 1.2 | ||
--- | ||
$id: http://devicetree.org/schemas/iio/proximity/parallax-ping.yaml# | ||
$schema: http://devicetree.org/meta-schemas/core.yaml# | ||
|
||
title: Parallax PING))) and LaserPING range finder | ||
|
||
maintainers: | ||
- Andreas Klinger <ak@it-klinger.de> | ||
|
||
description: | | ||
Bit-banging driver using one GPIO: | ||
- ping-gpios is raised by the driver to start measurement | ||
- direction of ping-gpio is then switched into input with an interrupt | ||
for receiving distance value as PWM signal | ||
Specifications about the devices can be found at: | ||
http://parallax.com/sites/default/files/downloads/28041-LaserPING-2m-Rangefinder-Guide.pdf | ||
http://parallax.com/sites/default/files/downloads/28015-PING-Documentation-v1.6.pdf | ||
properties: | ||
compatible: | ||
enum: | ||
- parallax,ping | ||
- parallax,laserping | ||
|
||
ping-gpios: | ||
description: | ||
Definition of the GPIO for the triggering and echo (output and input) | ||
This GPIO is set for about 5 us by the driver to tell the device it | ||
should initiate the measurement cycle. Afterwards the GPIO is switched | ||
to input direction with an interrupt. The device sets it and the | ||
length of the input signal corresponds to the measured distance. | ||
It needs to be an GPIO which is able to deliver an interrupt because | ||
the time between two interrupts is measured in the driver. | ||
See Documentation/devicetree/bindings/gpio/gpio.txt for information | ||
on how to specify a consumer gpio. | ||
maxItems: 1 | ||
|
||
required: | ||
- compatible | ||
- ping-gpios | ||
|
||
examples: | ||
- | | ||
#include <dt-bindings/gpio/gpio.h> | ||
proximity { | ||
compatible = "parallax,laserping"; | ||
ping-gpios = <&gpio0 26 GPIO_ACTIVE_HIGH>; | ||
}; |