0001 ACPI Time and Alarm (TAD) device attributes.
0002
0003 What: /sys/bus/platform/devices/ACPI000E:00/caps
0004 Date: March 2018
0005 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0006 Description:
0007 (RO) Hexadecimal bitmask of the TAD attributes are reported by
0008 the platform firmware (see ACPI 6.2, section 9.18.2):
0009
0010 ======= ======================================================
0011 BIT(0): AC wakeup implemented if set
0012 BIT(1): DC wakeup implemented if set
0013 BIT(2): Get/set real time features implemented if set
0014 BIT(3): Real time accuracy in milliseconds if set
0015 BIT(4): Correct status reported for wakeups from S4/S5 if set
0016 BIT(5): The AC timer wakes up from S4 if set
0017 BIT(6): The AC timer wakes up from S5 if set
0018 BIT(7): The DC timer wakes up from S4 if set
0019 BIT(8): The DC timer wakes up from S5 if set
0020 ======= ======================================================
0021
0022 The other bits are reserved.
0023
0024 What: /sys/bus/platform/devices/ACPI000E:00/ac_alarm
0025 Date: March 2018
0026 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0027 Description:
0028 (RW) The AC alarm timer value.
0029
0030 Reads return the current AC alarm timer value in seconds or
0031 "disabled", if the AC alarm is not set to wake up the system.
0032
0033 Write a new AC alarm timer value in seconds or "disabled" to it
0034 to set the AC alarm timer or to disable it, respectively.
0035
0036 If the AC alarm timer is set through this attribute and it
0037 expires, it will immediately wake up the system from the S3
0038 sleep state (and from S4/S5 too if supported) until its status
0039 is explicitly cleared via the ac_status attribute.
0040
0041 What: /sys/bus/platform/devices/ACPI000E:00/ac_policy
0042 Date: March 2018
0043 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0044 Description:
0045 (RW) The AC alarm expired timer wake policy (see ACPI 6.2,
0046 Section 9.18 for details).
0047
0048 Reads return the current expired timer wake delay for the AC
0049 alarm timer or "never", if the policy is to discard AC timer
0050 wakeups if the system is on DC power.
0051
0052 Write a new expired timer wake delay for the AC alarm timer in
0053 seconds or "never" to it to set the expired timer wake delay for
0054 the AC alarm timer or to set its expired wake policy to discard
0055 wakeups if the system is on DC power, respectively.
0056
0057 What: /sys/bus/platform/devices/ACPI000E:00/ac_status
0058 Date: March 2018
0059 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0060 Description:
0061 (RW) The AC alarm status.
0062
0063 Reads return a hexadecimal bitmask representing the AC alarm
0064 timer status with the following meaning of bits (see ACPI 6.2,
0065 Section 9.18.5):
0066
0067 ======= ======================================================
0068 Bit(0): The timer has expired if set.
0069 Bit(1): The timer has woken up the system from a sleep state
0070 (S3 or S4/S5 if supported) if set.
0071 ======= ======================================================
0072
0073 The other bits are reserved.
0074
0075 Reads also cause the AC alarm timer status to be reset.
0076
0077 Another way to reset the status of the AC alarm timer is to
0078 write (the number) 0 to this file.
0079
0080 If the status return value indicates that the timer has expired,
0081 it will immediately wake up the system from the S3 sleep state
0082 (and from S4/S5 too if supported) until its status is explicitly
0083 cleared through this attribute.
0084
0085 What: /sys/bus/platform/devices/ACPI000E:00/dc_alarm
0086 Date: March 2018
0087 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0088 Description:
0089 (RW,optional) The DC alarm timer value.
0090
0091 This attribute is only present if the TAD supports a separate
0092 DC timer.
0093
0094 It is analogous to the ac_alarm attribute.
0095
0096 What: /sys/bus/platform/devices/ACPI000E:00/dc_policy
0097 Date: March 2018
0098 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0099 Description:
0100 (RW,optional) The DC alarm expired timer wake policy.
0101
0102 This attribute is only present if the TAD supports a separate
0103 DC timer.
0104
0105 It is analogous to the ac_policy attribute.
0106
0107 What: /sys/bus/platform/devices/ACPI000E:00/dc_status
0108 Date: March 2018
0109 Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
0110
0111 Description:
0112 (RW,optional) The DC alarm status.
0113
0114 This attribute is only present if the TAD supports a separate
0115 DC timer.
0116
0117 It is analogous to the ac_status attribute.
