chipcap2.rst 2.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. .. SPDX-License-Identifier: GPL-2.0-or-later
  2. Kernel driver ChipCap2
  3. ======================
  4. Supported chips:
  5. * Amphenol CC2D23, CC2D23S, CC2D25, CC2D25S, CC2D33, CC2D33S, CC2D35, CC2D35S
  6. Prefix: 'chipcap2'
  7. Addresses scanned: -
  8. Datasheet: https://www.amphenol-sensors.com/en/telaire/humidity/527-humidity-sensors/3095-chipcap-2
  9. Author:
  10. - Javier Carrasco <javier.carrasco.cruz@gmail.com>
  11. Description
  12. -----------
  13. This driver implements support for the Amphenol ChipCap 2, a humidity and
  14. temperature chip family. Temperature is measured in milli degrees celsius,
  15. relative humidity is expressed as a per cent mille. The measurement ranges
  16. are the following:
  17. - Relative humidity: 0 to 100000 pcm (14-bit resolution)
  18. - Temperature: -40000 to +125000 m°C (14-bit resolution)
  19. The device communicates with the I2C protocol and uses the I2C address 0x28
  20. by default.
  21. Depending on the hardware configuration, up to two humidity alarms to control
  22. minimum and maximum values are provided. Their thresholds and hystersis can be
  23. configured via sysfs.
  24. Thresholds and hysteris must be provided as a per cent mille. These values
  25. might be truncated to match the 14-bit device resolution (6.1 pcm/LSB)
  26. Known Issues
  27. ------------
  28. The driver does not support I2C address and command window length modification.
  29. sysfs-Interface
  30. ---------------
  31. The following list includes the sysfs attributes that the driver always provides,
  32. their permissions and a short description:
  33. =============================== ======= ========================================
  34. Name Perm Description
  35. =============================== ======= ========================================
  36. temp1_input: RO temperature input
  37. humidity1_input: RO humidity input
  38. =============================== ======= ========================================
  39. The following list includes the sysfs attributes that the driver may provide
  40. depending on the hardware configuration:
  41. =============================== ======= ========================================
  42. Name Perm Description
  43. =============================== ======= ========================================
  44. humidity1_min: RW humidity low limit. Measurements under
  45. this limit trigger a humidity low alarm
  46. humidity1_max: RW humidity high limit. Measurements above
  47. this limit trigger a humidity high alarm
  48. humidity1_min_hyst: RW humidity low hystersis
  49. humidity1_max_hyst: RW humidity high hystersis
  50. humidity1_min_alarm: RO humidity low alarm indicator
  51. humidity1_max_alarm: RO humidity high alarm indicator
  52. =============================== ======= ========================================