summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/gpioths.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/gpioths.4 3.html')
-rw-r--r--static/freebsd/man4/gpioths.4 3.html143
1 files changed, 0 insertions, 143 deletions
diff --git a/static/freebsd/man4/gpioths.4 3.html b/static/freebsd/man4/gpioths.4 3.html
deleted file mode 100644
index 26442c77..00000000
--- a/static/freebsd/man4/gpioths.4 3.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<table class="head">
- <tr>
- <td class="head-ltitle">GPIOTHS(4)</td>
- <td class="head-vol">Device Drivers Manual</td>
- <td class="head-rtitle">GPIOTHS(4)</td>
- </tr>
-</table>
-<div class="manual-text">
-<section class="Sh">
-<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
-<p class="Pp"><code class="Nm">gpioths</code> &#x2014; <span class="Nd">driver
- for DHTxx and AM320x temperature and humidity sensors</span></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
-<p class="Pp">To compile this driver into the kernel, place the following line
- in your kernel configuration file:</p>
-<div class="Bd Pp Bd-indent"><code class="Cd">device gpioths</code></div>
-<p class="Pp">Alternatively, to load the driver as a module at boot time, place
- the following line in <a class="Xr">loader.conf(5)</a>:</p>
-<div class="Bd Pp Bd-indent Li">
-<pre>gpioths_load=&quot;YES&quot;</pre>
-</div>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">The <code class="Nm">gpioths</code> driver supports the DHTxx and
- AM320x family of temperature and humidity sensors. The driver automatically
- reads the values from the sensor once every 5 seconds, and makes the results
- available via <a class="Xr">sysctl(8)</a> variables.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
-<p class="Pp">The <code class="Nm">gpioths</code> driver provides support for
- the following devices:</p>
-<p class="Pp"></p>
-<table class="Bl-column Bd-indent Bl-compact">
- <tr>
- <td>DHT11</td>
- <td>DHT12</td>
- </tr>
- <tr>
- <td>DHT21</td>
- <td>DHT22</td>
- </tr>
- <tr>
- <td>AM3201</td>
- <td>AM3202</td>
- </tr>
-</table>
-<p class="Pp">The supported devices are all similar to each other, varying
- primarily in accuracy and resolution. The devices require a single wire for
- data communications, using a custom protocol which is not compatible with
- Maxim's 1-wire(tm). The AM320x devices also support connection to an i2c
- bus, but this driver supports only the single-wire connection option.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL
- VARIABLES</a></h1>
-<p class="Pp">Sysctl variables are used to access the most recent temperature
- and humidity measurements.</p>
-<dl class="Bl-tag">
- <dt id="dev.gpioths._unit_.temperature"><var class="Va">dev.gpioths.&lt;unit&gt;.temperature</var></dt>
- <dd>The current temperature in integer deciKelvins. Note that
- <a class="Xr">sysctl(8)</a> will convert those units to display in decimal
- degrees Celsius.</dd>
- <dt id="dev.gpioths._unit_.humidity"><var class="Va">dev.gpioths.&lt;unit&gt;.humidity</var></dt>
- <dd>The current relative humidity, as an integer percentage.</dd>
- <dt id="dev.gpioths._unit_.fails"><var class="Va">dev.gpioths.&lt;unit&gt;.fails</var></dt>
- <dd>The number of failed attempts to communicate with the sensor since the
- last good access. Cleared whenever a set of measurements is successfully
- retrieved.</dd>
-</dl>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="FDT_CONFIGURATION"><a class="permalink" href="#FDT_CONFIGURATION">FDT
- CONFIGURATION</a></h1>
-<p class="Pp">On an <a class="Xr">fdt(4)</a> based system, a
- <code class="Nm">gpioths</code> device node is typically defined directly
- under the root node, or under a simplebus node that represents a collection
- of devices on a board.</p>
-<p class="Pp">The following properties are required in the
- <code class="Nm">gpioths</code> device subnode:</p>
-<dl class="Bl-tag">
- <dt id="compatible"><var class="Va">compatible</var></dt>
- <dd>Must be &quot;dht11&quot;.</dd>
- <dt id="gpios"><var class="Va">gpios</var></dt>
- <dd>A reference to the gpio device and pin for data communications.</dd>
-</dl>
-<section class="Ss">
-<h2 class="Ss" id="Example_of_adding_a_sensor_with_an_overlay"><a class="permalink" href="#Example_of_adding_a_sensor_with_an_overlay">Example
- of adding a sensor with an overlay</a></h2>
-<div class="Bd Bd-indent">
-<pre>/dts-v1/;
-/plugin/;
-#include &lt;dt-bindings/gpio/gpio.h&gt;
-
-/ {
- compatible = &quot;wand,imx6q-wandboard&quot;;
-};
-
-&amp;{/} {
- dht0 {
- compatible = &quot;dht11&quot;;
- gpios = &lt;&amp;gpio5 15 GPIO_ACTIVE_HIGH&gt;;
- };
-};</pre>
-</div>
-</section>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="HINTS_CONFIGURATION"><a class="permalink" href="#HINTS_CONFIGURATION">HINTS
- CONFIGURATION</a></h1>
-<p class="Pp">On a <a class="Xr">device.hints(5)</a> based system, such as
- <code class="Li">MIPS</code>, these values are configurable for
- <code class="Nm">gpioths</code>:</p>
-<dl class="Bl-tag">
- <dt id="hint.gpioths._unit_.at"><var class="Va">hint.gpioths.&lt;unit&gt;.at</var></dt>
- <dd>The <a class="Xr">gpiobus(4)</a> instance the
- <code class="Nm">gpioths</code> instance is attached to.</dd>
- <dt id="hint.gpioths.pins"><var class="Va">hint.gpioths.pins</var></dt>
- <dd>A bitmask with a single bit set to indicate which gpio pin on the
- <a class="Xr">gpiobus(4)</a> to use for data communications.</dd>
-</dl>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
- ALSO</a></h1>
-<p class="Pp"><a class="Xr">fdt(4)</a>, <a class="Xr">gpiobus(4)</a>,
- <a class="Xr">sysctl(8)</a></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
-<p class="Pp">The <code class="Nm">gpioths</code> driver first appeared in
- <span class="Ux">FreeBSD 11.1</span>.</p>
-</section>
-</div>
-<table class="foot">
- <tr>
- <td class="foot-date">December 8, 2019</td>
- <td class="foot-os">FreeBSD 15.0</td>
- </tr>
-</table>