^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ACPI Time and Alarm (TAD) device attributes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) What: /sys/bus/platform/devices/ACPI000E:00/caps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) (RO) Hexadecimal bitmask of the TAD attributes are reported by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) the platform firmware (see ACPI 6.2, section 9.18.2):
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) ======= ======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) BIT(0): AC wakeup implemented if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) BIT(1): DC wakeup implemented if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) BIT(2): Get/set real time features implemented if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) BIT(3): Real time accuracy in milliseconds if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) BIT(4): Correct status reported for wakeups from S4/S5 if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) BIT(5): The AC timer wakes up from S4 if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) BIT(6): The AC timer wakes up from S5 if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) BIT(7): The DC timer wakes up from S4 if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) BIT(8): The DC timer wakes up from S5 if set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) ======= ======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) The other bits are reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) What: /sys/bus/platform/devices/ACPI000E:00/ac_alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) (RW) The AC alarm timer value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Reads return the current AC alarm timer value in seconds or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) "disabled", if the AC alarm is not set to wake up the system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Write a new AC alarm timer value in seconds or "disabled" to it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) to set the AC alarm timer or to disable it, respectively.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) If the AC alarm timer is set through this attribute and it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) expires, it will immediately wake up the system from the S3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) sleep state (and from S4/S5 too if supported) until its status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) is explicitly cleared via the ac_status attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) What: /sys/bus/platform/devices/ACPI000E:00/ac_policy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) (RW) The AC alarm expired timer wake policy (see ACPI 6.2,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) Section 9.18 for details).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Reads return the current expired timer wake delay for the AC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) alarm timer or "never", if the policy is to discard AC timer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) wakeups if the system is on DC power.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Write a new expired timer wake delay for the AC alarm timer in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) seconds or "never" to it to set the expired timer wake delay for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) the AC alarm timer or to set its expired wake policy to discard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) wakeups if the system is on DC power, respectively.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) What: /sys/bus/platform/devices/ACPI000E:00/ac_status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) (RW) The AC alarm status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) Reads return a hexadecimal bitmask representing the AC alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) timer status with the following meaning of bits (see ACPI 6.2,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) Section 9.18.5):
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) ======= ======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Bit(0): The timer has expired if set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Bit(1): The timer has woken up the system from a sleep state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) (S3 or S4/S5 if supported) if set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) ======= ======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) The other bits are reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) Reads also cause the AC alarm timer status to be reset.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Another way to reset the the status of the AC alarm timer is to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) write (the number) 0 to this file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) If the status return value indicates that the timer has expired,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) it will immediately wake up the system from the S3 sleep state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) (and from S4/S5 too if supported) until its status is explicitly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) cleared through this attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) What: /sys/bus/platform/devices/ACPI000E:00/dc_alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) (RW,optional) The DC alarm timer value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) This attribute is only present if the TAD supports a separate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) DC timer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) It is analogous to the ac_alarm attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) What: /sys/bus/platform/devices/ACPI000E:00/dc_policy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) (RW,optional) The DC alarm expired timer wake policy.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) This attribute is only present if the TAD supports a separate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) DC timer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) It is analogous to the ac_policy attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) What: /sys/bus/platform/devices/ACPI000E:00/dc_status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) (RW,optional) The DC alarm status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) This attribute is only present if the TAD supports a separate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) DC timer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) It is analogous to the ac_status attribute.