aboutsummaryrefslogtreecommitdiff
path: root/share/man/man4/ads111x.4
diff options
context:
space:
mode:
authorIan Lepore <ian@FreeBSD.org>2019-08-13 03:49:53 +0000
committerIan Lepore <ian@FreeBSD.org>2019-08-13 03:49:53 +0000
commit649e76276270c06d563125205902b50cbd6caf27 (patch)
tree43369396be9b7d603b9907b5993ad3e637cb2296 /share/man/man4/ads111x.4
parent98a43f9e22a6fee8d779edf98df31d0cc48e2f91 (diff)
downloadsrc-649e76276270c06d563125205902b50cbd6caf27.tar.gz
src-649e76276270c06d563125205902b50cbd6caf27.zip
Fix the driver name in ads111x.4, and hook the manpage up to the build.
The driver was originally written with the name ads1115, but at the last minute it got renamed to ads111x to reflect its support for many related chips, but I forgot to update the manpage to match the renaming before committing it all.
Notes
Notes: svn path=/head/; revision=350971
Diffstat (limited to 'share/man/man4/ads111x.4')
-rw-r--r--share/man/man4/ads111x.434
1 files changed, 17 insertions, 17 deletions
diff --git a/share/man/man4/ads111x.4 b/share/man/man4/ads111x.4
index 01f1351235c9..76c0093bea06 100644
--- a/share/man/man4/ads111x.4
+++ b/share/man/man4/ads111x.4
@@ -24,25 +24,25 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 5, 2019
-.Dt ADS1115 4
+.Dd August 12, 2019
+.Dt ADS111x 4
.Os
.Sh NAME
-.Nm ads1115
+.Nm ads111x
.Nd driver for ADS101x and ADS111x i2c analog to digital converters
.Sh SYNOPSIS
To compile this driver into the kernel,
place the following line in your
kernel configuration file:
.Bd -ragged -offset indent
-.Cd "device ads1115"
+.Cd "device ads111x"
.Ed
.Pp
Alternatively, to load the driver as a
module at boot time, place the following line in
.Xr loader.conf 5 :
.Bd -literal -offset indent
-ads1115_load="YES"
+ads111x_load="YES"
.Ed
.Sh DESCRIPTION
The
@@ -58,7 +58,7 @@ set via hints, FDT data, and
.Xr Sysctl 8
provides access to the voltage measurements made by the device.
Each time the
-.Va dev.ads1115.<unit>.<channel>.voltage
+.Va dev.ads111x.<unit>.<channel>.voltage
variable is accessed for a given channel, the driver switches the
chip's internal mux to choose the right input pins for that channel,
directs it to make a single measurement, and returns the measured value
@@ -106,16 +106,16 @@ All writeable variables may also be set as
tunables.
Channel numbers in these sysctl variables range from 0 through 7.
.Bl -tag -width indent
-.It Va dev.ads1115.<unit>.config
+.It Va dev.ads111x.<unit>.config
Provides access to the configuration register bits that control the
alert pin configuration.
Other bits which are controlled by the driver are masked out, and
cannot be viewed or changed using this variable.
-.It Va dev.ads1115.<unit>.lo_thresh
+.It Va dev.ads111x.<unit>.lo_thresh
Sets the low threshold for activating the alert pin.
-.It Va dev.ads1115.<unit>.hi_thresh
+.It Va dev.ads111x.<unit>.hi_thresh
Sets the high threshold for activating the alert pin.
-.It Va dev.ads1115.<unit>.<channel>.rate_index
+.It Va dev.ads111x.<unit>.<channel>.rate_index
Sets the sample rate for the channel.
The device datasheet documents eight available sample rates, chosen
by setting a value of 0 through 7 into the corresponding control
@@ -126,7 +126,7 @@ measurement on the given channel.
Because measurements are always made in single-shot mode, think of
this variable as controlling the averaging time for a single sample;
the time to make a measurement is 1 / samplerate.
-.It Va dev.ads1115.<unit>.<channel>.gain_index
+.It Va dev.ads111x.<unit>.<channel>.gain_index
Sets the programmable gain amplifier for the channel on devices
which have an internal amplifier.
The device datasheet documents eight available gain values, chosen
@@ -134,7 +134,7 @@ by setting a value of 0 through 7 into the corresponding control
register bits.
This variable sets the value used for those bits when making a
measurement on the given channel.
-.It Va dev.ads1115.<unit>.<channel>.voltage
+.It Va dev.ads111x.<unit>.<channel>.voltage
Reading this variable causes the device to make a measurement on
the corresponding input pin(s) and return the voltage in microvolts.
.Pp
@@ -215,16 +215,16 @@ based system, such as
these values are configurable for
.Nm :
.Bl -tag -width indent
-.It Va hint.ads1115.<unit>.at
+.It Va hint.ads111x.<unit>.at
The iicbus instance the
.Nm
instance is attached to.
-.It Va hint.ads1115.<unit>.<channel>.gain_index
+.It Va hint.ads111x.<unit>.<channel>.gain_index
The amplifier gain, as described above for the sysctl variable
-.Va dev.ads1115.<unit>.<channel>.gain_index .
-.It Va hint.ads1115.<unit>.<channel>.rate_index
+.Va dev.ads111x.<unit>.<channel>.gain_index .
+.It Va hint.ads111x.<unit>.<channel>.rate_index
The sample rate, as described above for the sysctl variable
-.Va dev.ads1115.<unit>.<channel>.rate_index .
+.Va dev.ads111x.<unit>.<channel>.rate_index .
.El
.Pp
If no channels are configured, sysctl variables will be created