117 lines
4.4 KiB
Plaintext
117 lines
4.4 KiB
Plaintext
What: /sys/bus/w1/devices/.../alarms
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RW) read or write TH and TL (Temperature High an Low) alarms.
|
|
Values shall be space separated and in the device range
|
|
(typical -55 degC to 125 degC), if not values will be trimmed
|
|
to device min/max capabilities. Values are integer as they are
|
|
stored in a 8bit register in the device. Lowest value is
|
|
automatically put to TL. Once set, alarms could be search at
|
|
master level, refer to Documentation/w1/w1-generic.rst for
|
|
detailed information
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/.../eeprom
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(WO) writing that file will either trigger a save of the
|
|
device data to its embedded EEPROM, either restore data
|
|
embedded in device EEPROM. Be aware that devices support
|
|
limited EEPROM writing cycles (typical 50k)
|
|
* 'save': save device RAM to EEPROM
|
|
* 'restore': restore EEPROM data in device RAM
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/.../ext_power
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RO) return the power status by asking the device
|
|
* '0': device parasite powered
|
|
* '1': device externally powered
|
|
* '-xx': xx is kernel error when reading power status
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/.../resolution
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RW) get or set the device resolution (on supported devices,
|
|
if not, this entry is not present). Note that the resolution
|
|
will be changed only in device RAM, so it will be cleared when
|
|
power is lost. Trigger a 'save' to EEPROM command to keep
|
|
values after power-on. Read or write are :
|
|
* '9..12': device resolution in bit
|
|
or resolution to set in bit
|
|
* '-xx': xx is kernel error when reading the resolution
|
|
* Anything else: do nothing
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/.../temperature
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RO) return the temperature in 1/1000 degC.
|
|
* If a bulk read has been triggered, it will directly
|
|
return the temperature computed when the bulk read
|
|
occurred, if available. If not yet available, nothing
|
|
is returned (a debug kernel message is sent), you
|
|
should retry later on.
|
|
* If no bulk read has been triggered, it will trigger
|
|
a conversion and send the result. Note that the
|
|
conversion duration depend on the resolution (if
|
|
device support this feature). It takes 94ms in 9bits
|
|
resolution, 750ms for 12bits.
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/.../w1_slave
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RW) return the temperature in 1/1000 degC.
|
|
*read*: return 2 lines with the hexa output data sent on the
|
|
bus, return the CRC check and temperature in 1/1000 degC
|
|
*write* :
|
|
* '0' : save the 2 or 3 bytes to the device EEPROM
|
|
(i.e. TH, TL and config register)
|
|
* '9..12' : set the device resolution in RAM
|
|
(if supported)
|
|
* Anything else: do nothing
|
|
refer to Documentation/w1/slaves/w1_therm.rst for detailed
|
|
information.
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|
|
|
|
|
|
What: /sys/bus/w1/devices/w1_bus_masterXX/therm_bulk_read
|
|
Date: May 2020
|
|
Contact: Akira Shimahara <akira215corp@gmail.com>
|
|
Description:
|
|
(RW) trigger a bulk read conversion. read the status
|
|
*read*:
|
|
* '-1': conversion in progress on at least 1 sensor
|
|
* '1' : conversion complete but at least one sensor
|
|
value has not been read yet
|
|
* '0' : no bulk operation. Reading temperature will
|
|
trigger a conversion on each device
|
|
*write*: 'trigger': trigger a bulk read on all supporting
|
|
devices on the bus
|
|
Note that if a bulk read is sent but one sensor is not read
|
|
immediately, the next access to temperature on this device
|
|
will return the temperature measured at the time of issue
|
|
of the bulk read command (not the current temperature).
|
|
Users: any user space application which wants to communicate with
|
|
w1_term device
|