Re: [PATCH 1/3] IIO: Add iio magn_north ABI documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 05/29/2014 09:46 AM, Jonathan Cameron wrote:
On 28/05/14 22:06, Reyad Attiyat wrote:
Update documentation for HID compass true/magnetic north sensor.

Signed-off-by: Reyad Attiyat <reyad.attiyat@xxxxxxxxx>
---
Documentation/ABI/testing/sysfs-bus-iio | 76 +++++++++++++++++++++++++++++++++
  1 file changed, 76 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
index 6e02c50..0341b2f 100644
--- a/Documentation/ABI/testing/sysfs-bus-iio
+++ b/Documentation/ABI/testing/sysfs-bus-iio
@@ -165,6 +165,10 @@ Description:
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_x_raw
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_y_raw
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_z_raw
Hmm. The question to my mind is whether people would expect a simple north to give
them which direction north is?
Also is it actually relevant whether they find north from a magnetometer or some other method?
I wonder if we want to make these some sort of north referenced rotation?
in_rot_from_true_north_raw
in_rot_from_magnetic_north_raw

Technically it is possible to get some direction information from some GPS receivers or to
to maintain a knowledge of its location with good gyroscopes.

Ultimately userspace doesn't care about it. When we were using the axial magnetic functions we were measuring the field magnitude in that direction. As I understand it here it is just an angle?
Yes, they are angles. Default units are degrees, which we should convert to radians as a standard unit for IIO.
Thanks,
Srinivas

J
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_raw
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_true_raw
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_tilt_comp_raw
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_true_tilt_comp_raw
  KernelVersion:    2.6.35
  Contact:    linux-iio@xxxxxxxxxxxxxxx
  Description:
@@ -249,6 +253,10 @@ What: /sys/bus/iio/devices/iio:deviceX/in_magn_scale
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_x_scale
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_y_scale
  What:        /sys/bus/iio/devices/iio:deviceX/in_magn_z_scale
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_scale
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_true_scale
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_tilt_comp_scale
+What: /sys/bus/iio/devices/iio:deviceX/in_magn_north_true_tilt_comp_scale
  What: /sys/bus/iio/devices/iio:deviceX/in_pressureY_scale
  What: /sys/bus/iio/devices/iio:deviceX/in_pressure_scale
  KernelVersion:    2.6.35
@@ -436,6 +444,14 @@ What: /sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en
  What: /sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en
  What: /sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en
  What: /sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_thresh_rising_en
+What: /sys/.../iio:deviceX/events/in_magn_north_thresh_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_true_thresh_rising_en
+What: /sys/.../iio:deviceX/events/in_magn_north_true_thresh_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_tilt_comp_thresh_rising_en +What: /sys/.../iio:deviceX/events/in_magn_north_tilt_comp_thresh_falling_en +What: /sys/.../iio:deviceX/events/in_magn_north_true_tilt_comp_thresh_rising_en +What: /sys/.../iio:deviceX/events/in_magn_north_true_tilt_comp_thresh_falling_en
  What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en
  What: /sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en
  What: /sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en
@@ -481,6 +497,14 @@ What: /sys/.../iio:deviceX/events/in_magn_y_roc_rising_en
  What: /sys/.../iio:deviceX/events/in_magn_y_roc_falling_en
  What: /sys/.../iio:deviceX/events/in_magn_z_roc_rising_en
  What: /sys/.../iio:deviceX/events/in_magn_z_roc_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_roc_rising_en
+What: /sys/.../iio:deviceX/events/in_magn_north_roc_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_true_roc_rising_en
+What: /sys/.../iio:deviceX/events/in_magn_north_true_roc_falling_en
+What: /sys/.../iio:deviceX/events/in_magn_north_tilt_comp_roc_rising_en
+What: /sys/.../iio:deviceX/events/in_magn_north_tilt_comp_roc_falling_en +What: /sys/.../iio:deviceX/events/in_magn_north_true_tilt_comp_roc_rising_en +What: /sys/.../iio:deviceX/events/in_magn_north_true_tilt_comp_roc_falling_en
  What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en
  What: /sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en
  What: /sys/.../iio:deviceX/events/in_voltageY_roc_rising_en
@@ -527,6 +551,14 @@ What: /sys/.../events/in_magn_y_raw_thresh_rising_value
  What: /sys/.../events/in_magn_y_raw_thresh_falling_value
  What:        /sys/.../events/in_magn_z_raw_thresh_rising_value
  What: /sys/.../events/in_magn_z_raw_thresh_falling_value
+What: /sys/.../events/in_magn_north_raw_thresh_rising_value
+What: /sys/.../events/in_magn_north_raw_thresh_falling_value
+What: /sys/.../events/in_magn_north_true_raw_thresh_rising_value
+What: /sys/.../events/in_magn_north_true_raw_thresh_falling_value
+What: /sys/.../events/in_magn_north_tilt_comp_raw_thresh_rising_value
+What: /sys/.../events/in_magn_north_tilt_comp_raw_thresh_falling_value
+What: /sys/.../events/in_magn_north_true_tilt_comp_raw_thresh_rising_value +What: /sys/.../events/in_magn_north_true_tilt_comp_raw_thresh_falling_value
  What: /sys/.../events/in_voltageY_supply_raw_thresh_rising_value
  What: /sys/.../events/in_voltageY_supply_raw_thresh_falling_value
  What: /sys/.../events/in_voltageY_raw_thresh_rising_value
@@ -577,6 +609,18 @@ What: /sys/.../events/in_magn_y_thresh_either_hysteresis
  What: /sys/.../events/in_magn_z_thresh_rising_hysteresis
  What: /sys/.../events/in_magn_z_thresh_falling_hysteresis
  What: /sys/.../events/in_magn_z_thresh_either_hysteresis
+What: /sys/.../events/in_magn_north_thresh_rising_hysteresis
+What: /sys/.../events/in_magn_north_thresh_falling_hysteresis
+What: /sys/.../events/in_magn_north_thresh_either_hysteresis
+What: /sys/.../events/in_magn_north_true_thresh_rising_hysteresis
+What: /sys/.../events/in_magn_north_true_thresh_falling_hysteresis
+What: /sys/.../events/in_magn_north_true_thresh_either_hysteresis
+What: /sys/.../events/in_magn_north_tilt_comp_thresh_rising_hysteresis
+What: /sys/.../events/in_magn_north_tilt_comp_thresh_falling_hysteresis
+What: /sys/.../events/in_magn_north_tilt_comp_thresh_either_hysteresis
+What: /sys/.../events/in_magn_north_true_tilt_comp_thresh_rising_hysteresis +What: /sys/.../events/in_magn_north_true_tilt_comp_thresh_falling_hysteresis +What: /sys/.../events/in_magn_north_true_tilt_comp_thresh_either_hysteresis
  What: /sys/.../events/in_voltageY_thresh_rising_hysteresis
  What: /sys/.../events/in_voltageY_thresh_falling_hysteresis
  What: /sys/.../events/in_voltageY_thresh_either_hysteresis
@@ -624,6 +668,14 @@ What: /sys/.../events/in_magn_y_raw_roc_rising_value
  What:        /sys/.../events/in_magn_y_raw_roc_falling_value
  What:        /sys/.../events/in_magn_z_raw_roc_rising_value
  What:        /sys/.../events/in_magn_z_raw_roc_falling_value
+What:        /sys/.../events/in_magn_north_raw_roc_rising_value
+What: /sys/.../events/in_magn_north_raw_roc_falling_value
+What: /sys/.../events/in_magn_north_true_raw_roc_rising_value
+What: /sys/.../events/in_magn_north_true_raw_roc_falling_value
+What: /sys/.../events/in_magn_north_tilt_comp_raw_roc_rising_value
+What: /sys/.../events/in_magn_north_tilt_comp_raw_roc_falling_value
+What: /sys/.../events/in_magn_north_true_tilt_comp_raw_roc_rising_value
+What: /sys/.../events/in_magn_north_true_tilt_comp_raw_roc_falling_value
  What: /sys/.../events/in_voltageY_supply_raw_roc_rising_value
  What: /sys/.../events/in_voltageY_supply_raw_roc_falling_value
  What:        /sys/.../events/in_voltageY_raw_roc_rising_value
@@ -679,6 +731,22 @@ What: /sys/.../events/in_magn_z_thresh_rising_period
  What:        /sys/.../events/in_magn_z_thresh_falling_period
  What:        /sys/.../events/in_magn_z_roc_rising_period
  What:        /sys/.../events/in_magn_z_roc_falling_period
+What:        /sys/.../events/in_magn_north_thresh_rising_period
+What: /sys/.../events/in_magn_north_thresh_falling_period
+What:        /sys/.../events/in_magn_north_roc_rising_period
+What:        /sys/.../events/in_magn_north_roc_falling_period
+What: /sys/.../events/in_magn_north_true_thresh_rising_period
+What: /sys/.../events/in_magn_north_true_thresh_falling_period
+What: /sys/.../events/in_magn_north_true_roc_rising_period
+What: /sys/.../events/in_magn_north_true_roc_falling_period
+What: /sys/.../events/in_magn_north_tilt_comp_thresh_rising_period
+What: /sys/.../events/in_magn_north_tilt_comp_thresh_falling_period
+What: /sys/.../events/in_magn_north_tilt_comp_roc_rising_period
+What: /sys/.../events/in_magn_north_tilt_comp_roc_falling_period
+What: /sys/.../events/in_magn_north_true_tilt_comp_thresh_rising_period
+What: /sys/.../events/in_magn_north_true_tilt_comp_thresh_falling_period
+What: /sys/.../events/in_magn_north_true_tilt_comp_roc_rising_period
+What: /sys/.../events/in_magn_north_true_tilt_comp_roc_falling_period
  What: /sys/.../events/in_voltageY_supply_thresh_rising_period
  What: /sys/.../events/in_voltageY_supply_thresh_falling_period
  What: /sys/.../events/in_voltageY_supply_roc_rising_period
@@ -776,6 +844,10 @@ What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_en
  What:        /sys/.../iio:deviceX/scan_elements/in_magn_x_en
  What:        /sys/.../iio:deviceX/scan_elements/in_magn_y_en
  What:        /sys/.../iio:deviceX/scan_elements/in_magn_z_en
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_en
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_true_en
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_tilt_comp_en
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_true_tilt_comp_en
  What: /sys/.../iio:deviceX/scan_elements/in_timestamp_en
  What: /sys/.../iio:deviceX/scan_elements/in_voltageY_supply_en
  What:        /sys/.../iio:deviceX/scan_elements/in_voltageY_en
@@ -840,6 +912,10 @@ What: /sys/.../iio:deviceX/scan_elements/in_anglvel_z_index
  What: /sys/.../iio:deviceX/scan_elements/in_magn_x_index
  What: /sys/.../iio:deviceX/scan_elements/in_magn_y_index
  What: /sys/.../iio:deviceX/scan_elements/in_magn_z_index
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_index
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_true_index
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_tilt_comp_index
+What: /sys/.../iio:deviceX/scan_elements/in_magn_north_true_tilt_comp_index
  What: /sys/.../iio:deviceX/scan_elements/in_incli_x_index
  What: /sys/.../iio:deviceX/scan_elements/in_incli_y_index
  What: /sys/.../iio:deviceX/scan_elements/in_timestamp_index




--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Linux Media Devel]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]     [Linux Wireless Networking]     [Linux Omap]

  Powered by Linux