Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
793c2388 | 3 | * Name: actbl.h - Basic ACPI Table Definitions |
1da177e4 LT |
4 | * |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
75a44ce0 | 8 | * Copyright (C) 2000 - 2008, Intel Corp. |
1da177e4 LT |
9 | * All rights reserved. |
10 | * | |
11 | * Redistribution and use in source and binary forms, with or without | |
12 | * modification, are permitted provided that the following conditions | |
13 | * are met: | |
14 | * 1. Redistributions of source code must retain the above copyright | |
15 | * notice, this list of conditions, and the following disclaimer, | |
16 | * without modification. | |
17 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer | |
18 | * substantially similar to the "NO WARRANTY" disclaimer below | |
19 | * ("Disclaimer") and any redistribution must be conditioned upon | |
20 | * including a substantially similar Disclaimer requirement for further | |
21 | * binary redistribution. | |
22 | * 3. Neither the names of the above-listed copyright holders nor the names | |
23 | * of any contributors may be used to endorse or promote products derived | |
24 | * from this software without specific prior written permission. | |
25 | * | |
26 | * Alternatively, this software may be distributed under the terms of the | |
27 | * GNU General Public License ("GPL") version 2 as published by the Free | |
28 | * Software Foundation. | |
29 | * | |
30 | * NO WARRANTY | |
31 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
32 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
33 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR | |
34 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
35 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
36 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
37 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
38 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
39 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING | |
40 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |
41 | * POSSIBILITY OF SUCH DAMAGES. | |
42 | */ | |
43 | ||
44 | #ifndef __ACTBL_H__ | |
45 | #define __ACTBL_H__ | |
46 | ||
b24aad44 BM |
47 | /******************************************************************************* |
48 | * | |
49 | * Fundamental ACPI tables | |
50 | * | |
51 | * This file contains definitions for the ACPI tables that are directly consumed | |
52 | * by ACPICA. All other tables are consumed by the OS-dependent ACPI-related | |
53 | * device drivers and other OS support code. | |
54 | * | |
55 | * The RSDP and FACS do not use the common ACPI table header. All other ACPI | |
56 | * tables use the header. | |
57 | * | |
58 | ******************************************************************************/ | |
59 | ||
defba1d8 | 60 | /* |
6e2d5ebd BM |
61 | * Values for description table header signatures for tables defined in this |
62 | * file. Useful because they make it more difficult to inadvertently type in | |
63 | * the wrong signature. | |
1da177e4 | 64 | */ |
f3d2e786 BM |
65 | #define ACPI_SIG_DSDT "DSDT" /* Differentiated System Description Table */ |
66 | #define ACPI_SIG_FADT "FACP" /* Fixed ACPI Description Table */ | |
67 | #define ACPI_SIG_FACS "FACS" /* Firmware ACPI Control Structure */ | |
68 | #define ACPI_SIG_PSDT "PSDT" /* Persistent System Description Table */ | |
69 | #define ACPI_SIG_RSDP "RSD PTR " /* Root System Description Pointer */ | |
70 | #define ACPI_SIG_RSDT "RSDT" /* Root System Description Table */ | |
71 | #define ACPI_SIG_XSDT "XSDT" /* Extended System Description Table */ | |
72 | #define ACPI_SIG_SSDT "SSDT" /* Secondary System Description Table */ | |
8f34890d | 73 | #define ACPI_RSDP_NAME "RSDP" /* Short name for RSDP, not signature */ |
1da177e4 LT |
74 | |
75 | /* | |
793c2388 BM |
76 | * All tables and structures must be byte-packed to match the ACPI |
77 | * specification, since the tables are provided by the system BIOS | |
1da177e4 | 78 | */ |
1da177e4 LT |
79 | #pragma pack(1) |
80 | ||
81 | /* | |
793c2388 BM |
82 | * Note about bitfields: The u8 type is used for bitfields in ACPI tables. |
83 | * This is the only type that is even remotely portable. Anything else is not | |
84 | * portable, so do not use any other bitfield types. | |
1da177e4 | 85 | */ |
1da177e4 | 86 | |
793c2388 BM |
87 | /******************************************************************************* |
88 | * | |
b24aad44 BM |
89 | * Master ACPI Table Header. This common header is used by all ACPI tables |
90 | * except the RSDP and FACS. | |
793c2388 BM |
91 | * |
92 | ******************************************************************************/ | |
1da177e4 | 93 | |
793c2388 | 94 | struct acpi_table_header { |
f3d2e786 BM |
95 | char signature[ACPI_NAME_SIZE]; /* ASCII table signature */ |
96 | u32 length; /* Length of table in bytes, including this header */ | |
97 | u8 revision; /* ACPI Specification minor version # */ | |
98 | u8 checksum; /* To make sum of entire table == 0 */ | |
99 | char oem_id[ACPI_OEM_ID_SIZE]; /* ASCII OEM identification */ | |
100 | char oem_table_id[ACPI_OEM_TABLE_ID_SIZE]; /* ASCII OEM table identification */ | |
101 | u32 oem_revision; /* OEM revision number */ | |
102 | char asl_compiler_id[ACPI_NAME_SIZE]; /* ASCII ASL compiler vendor ID */ | |
103 | u32 asl_compiler_revision; /* ASL compiler version */ | |
104 | }; | |
1da177e4 | 105 | |
b24aad44 BM |
106 | /******************************************************************************* |
107 | * | |
793c2388 | 108 | * GAS - Generic Address Structure (ACPI 2.0+) |
f3d2e786 BM |
109 | * |
110 | * Note: Since this structure is used in the ACPI tables, it is byte aligned. | |
b24aad44 BM |
111 | * If misaliged access is not supported by the hardware, accesses to the |
112 | * 64-bit Address field must be performed with care. | |
113 | * | |
114 | ******************************************************************************/ | |
115 | ||
793c2388 | 116 | struct acpi_generic_address { |
f3d2e786 BM |
117 | u8 space_id; /* Address space where struct or register exists */ |
118 | u8 bit_width; /* Size in bits of given register */ | |
119 | u8 bit_offset; /* Bit offset within the register */ | |
793c2388 BM |
120 | u8 access_width; /* Minimum Access size (ACPI 3.0) */ |
121 | u64 address; /* 64-bit address of struct or register */ | |
122 | }; | |
1da177e4 | 123 | |
793c2388 BM |
124 | /******************************************************************************* |
125 | * | |
126 | * RSDP - Root System Description Pointer (Signature is "RSD PTR ") | |
6e2d5ebd | 127 | * Version 2 |
793c2388 BM |
128 | * |
129 | ******************************************************************************/ | |
130 | ||
f3d2e786 | 131 | struct acpi_table_rsdp { |
793c2388 BM |
132 | char signature[8]; /* ACPI signature, contains "RSD PTR " */ |
133 | u8 checksum; /* ACPI 1.0 checksum */ | |
f3d2e786 | 134 | char oem_id[ACPI_OEM_ID_SIZE]; /* OEM identification */ |
793c2388 BM |
135 | u8 revision; /* Must be (0) for ACPI 1.0 or (2) for ACPI 2.0+ */ |
136 | u32 rsdt_physical_address; /* 32-bit physical address of the RSDT */ | |
137 | u32 length; /* Table length in bytes, including header (ACPI 2.0+) */ | |
138 | u64 xsdt_physical_address; /* 64-bit physical address of the XSDT (ACPI 2.0+) */ | |
139 | u8 extended_checksum; /* Checksum of entire table (ACPI 2.0+) */ | |
140 | u8 reserved[3]; /* Reserved, must be zero */ | |
141 | }; | |
1da177e4 | 142 | |
793c2388 | 143 | #define ACPI_RSDP_REV0_SIZE 20 /* Size of original ACPI 1.0 RSDP */ |
1da177e4 | 144 | |
793c2388 BM |
145 | /******************************************************************************* |
146 | * | |
147 | * RSDT/XSDT - Root System Description Tables | |
6e2d5ebd | 148 | * Version 1 (both) |
793c2388 BM |
149 | * |
150 | ******************************************************************************/ | |
1da177e4 | 151 | |
f3d2e786 BM |
152 | struct acpi_table_rsdt { |
153 | struct acpi_table_header header; /* Common ACPI table header */ | |
154 | u32 table_offset_entry[1]; /* Array of pointers to ACPI tables */ | |
793c2388 BM |
155 | }; |
156 | ||
f3d2e786 BM |
157 | struct acpi_table_xsdt { |
158 | struct acpi_table_header header; /* Common ACPI table header */ | |
159 | u64 table_offset_entry[1]; /* Array of pointers to ACPI tables */ | |
793c2388 BM |
160 | }; |
161 | ||
162 | /******************************************************************************* | |
163 | * | |
164 | * FACS - Firmware ACPI Control Structure (FACS) | |
165 | * | |
166 | ******************************************************************************/ | |
167 | ||
f3d2e786 | 168 | struct acpi_table_facs { |
793c2388 BM |
169 | char signature[4]; /* ASCII table signature */ |
170 | u32 length; /* Length of structure, in bytes */ | |
171 | u32 hardware_signature; /* Hardware configuration signature */ | |
172 | u32 firmware_waking_vector; /* 32-bit physical address of the Firmware Waking Vector */ | |
173 | u32 global_lock; /* Global Lock for shared hardware resources */ | |
f3d2e786 | 174 | u32 flags; |
793c2388 BM |
175 | u64 xfirmware_waking_vector; /* 64-bit version of the Firmware Waking Vector (ACPI 2.0+) */ |
176 | u8 version; /* Version of this table (ACPI 2.0+) */ | |
eb2289ba BM |
177 | u8 reserved[3]; /* Reserved, must be zero */ |
178 | u32 ospm_flags; /* Flags to be set by OSPM (ACPI 4.0) */ | |
179 | u8 reserved1[24]; /* Reserved, must be zero */ | |
793c2388 | 180 | }; |
1da177e4 | 181 | |
6e2d5ebd | 182 | /* Masks for global_lock flag field above */ |
eb2289ba BM |
183 | |
184 | #define ACPI_GLOCK_PENDING (1) /* 00: Pending global lock ownership */ | |
185 | #define ACPI_GLOCK_OWNED (1<<1) /* 01: Global lock is owned */ | |
186 | ||
6e2d5ebd | 187 | /* Masks for Flags field above */ |
f3d2e786 | 188 | |
eb2289ba BM |
189 | #define ACPI_FACS_S4_BIOS_PRESENT (1) /* 00: S4BIOS support is present */ |
190 | #define ACPI_FACS_64BIT_WAKE (1<<1) /* 01: 64-bit wake vector supported (ACPI 4.0) */ | |
f3d2e786 | 191 | |
6e2d5ebd | 192 | /* Masks for ospm_flags field above */ |
f3d2e786 | 193 | |
eb2289ba | 194 | #define ACPI_FACS_64BIT_ENVIRONMENT (1) /* 00: 64-bit wake environment is required (ACPI 4.0) */ |
1da177e4 | 195 | |
793c2388 BM |
196 | /******************************************************************************* |
197 | * | |
198 | * FADT - Fixed ACPI Description Table (Signature "FACP") | |
6e2d5ebd | 199 | * Version 4 |
793c2388 BM |
200 | * |
201 | ******************************************************************************/ | |
202 | ||
203 | /* Fields common to all versions of the FADT */ | |
204 | ||
f3d2e786 BM |
205 | struct acpi_table_fadt { |
206 | struct acpi_table_header header; /* Common ACPI table header */ | |
207 | u32 facs; /* 32-bit physical address of FACS */ | |
208 | u32 dsdt; /* 32-bit physical address of DSDT */ | |
8f34890d | 209 | u8 model; /* System Interrupt Model (ACPI 1.0) - not used in ACPI 2.0+ */ |
f3d2e786 BM |
210 | u8 preferred_profile; /* Conveys preferred power management profile to OSPM. */ |
211 | u16 sci_interrupt; /* System vector of SCI interrupt */ | |
8f34890d | 212 | u32 smi_command; /* 32-bit Port address of SMI command port */ |
f3d2e786 BM |
213 | u8 acpi_enable; /* Value to write to smi_cmd to enable ACPI */ |
214 | u8 acpi_disable; /* Value to write to smi_cmd to disable ACPI */ | |
215 | u8 S4bios_request; /* Value to write to SMI CMD to enter S4BIOS state */ | |
216 | u8 pstate_control; /* Processor performance state control */ | |
8f34890d BM |
217 | u32 pm1a_event_block; /* 32-bit Port address of Power Mgt 1a Event Reg Blk */ |
218 | u32 pm1b_event_block; /* 32-bit Port address of Power Mgt 1b Event Reg Blk */ | |
219 | u32 pm1a_control_block; /* 32-bit Port address of Power Mgt 1a Control Reg Blk */ | |
220 | u32 pm1b_control_block; /* 32-bit Port address of Power Mgt 1b Control Reg Blk */ | |
221 | u32 pm2_control_block; /* 32-bit Port address of Power Mgt 2 Control Reg Blk */ | |
222 | u32 pm_timer_block; /* 32-bit Port address of Power Mgt Timer Ctrl Reg Blk */ | |
223 | u32 gpe0_block; /* 32-bit Port address of General Purpose Event 0 Reg Blk */ | |
224 | u32 gpe1_block; /* 32-bit Port address of General Purpose Event 1 Reg Blk */ | |
225 | u8 pm1_event_length; /* Byte Length of ports at pm1x_event_block */ | |
226 | u8 pm1_control_length; /* Byte Length of ports at pm1x_control_block */ | |
227 | u8 pm2_control_length; /* Byte Length of ports at pm2_control_block */ | |
228 | u8 pm_timer_length; /* Byte Length of ports at pm_timer_block */ | |
229 | u8 gpe0_block_length; /* Byte Length of ports at gpe0_block */ | |
230 | u8 gpe1_block_length; /* Byte Length of ports at gpe1_block */ | |
231 | u8 gpe1_base; /* Offset in GPE number space where GPE1 events start */ | |
232 | u8 cst_control; /* Support for the _CST object and C States change notification */ | |
f3d2e786 BM |
233 | u16 C2latency; /* Worst case HW latency to enter/exit C2 state */ |
234 | u16 C3latency; /* Worst case HW latency to enter/exit C3 state */ | |
235 | u16 flush_size; /* Processor's memory cache line width, in bytes */ | |
236 | u16 flush_stride; /* Number of flush strides that need to be read */ | |
8f34890d | 237 | u8 duty_offset; /* Processor duty cycle index in processor's P_CNT reg */ |
993958fe | 238 | u8 duty_width; /* Processor duty cycle value bit width in P_CNT register */ |
f3d2e786 BM |
239 | u8 day_alarm; /* Index to day-of-month alarm in RTC CMOS RAM */ |
240 | u8 month_alarm; /* Index to month-of-year alarm in RTC CMOS RAM */ | |
241 | u8 century; /* Index to century in RTC CMOS RAM */ | |
993958fe | 242 | u16 boot_flags; /* IA-PC Boot Architecture Flags (see below for individual flags) */ |
f3d2e786 | 243 | u8 reserved; /* Reserved, must be zero */ |
8f34890d BM |
244 | u32 flags; /* Miscellaneous flag bits (see below for individual flags) */ |
245 | struct acpi_generic_address reset_register; /* 64-bit address of the Reset register */ | |
793c2388 | 246 | u8 reset_value; /* Value to write to the reset_register port to reset the system */ |
8f34890d | 247 | u8 reserved4[3]; /* Reserved, must be zero */ |
f3d2e786 | 248 | u64 Xfacs; /* 64-bit physical address of FACS */ |
793c2388 | 249 | u64 Xdsdt; /* 64-bit physical address of DSDT */ |
8f34890d BM |
250 | struct acpi_generic_address xpm1a_event_block; /* 64-bit Extended Power Mgt 1a Event Reg Blk address */ |
251 | struct acpi_generic_address xpm1b_event_block; /* 64-bit Extended Power Mgt 1b Event Reg Blk address */ | |
252 | struct acpi_generic_address xpm1a_control_block; /* 64-bit Extended Power Mgt 1a Control Reg Blk address */ | |
253 | struct acpi_generic_address xpm1b_control_block; /* 64-bit Extended Power Mgt 1b Control Reg Blk address */ | |
254 | struct acpi_generic_address xpm2_control_block; /* 64-bit Extended Power Mgt 2 Control Reg Blk address */ | |
255 | struct acpi_generic_address xpm_timer_block; /* 64-bit Extended Power Mgt Timer Ctrl Reg Blk address */ | |
256 | struct acpi_generic_address xgpe0_block; /* 64-bit Extended General Purpose Event 0 Reg Blk address */ | |
257 | struct acpi_generic_address xgpe1_block; /* 64-bit Extended General Purpose Event 1 Reg Blk address */ | |
1da177e4 LT |
258 | }; |
259 | ||
6e2d5ebd | 260 | /* Masks for FADT Boot Architecture Flags (boot_flags) */ |
993958fe BM |
261 | |
262 | #define ACPI_FADT_LEGACY_DEVICES (1) /* 00: [V2] System has LPC or ISA bus devices */ | |
263 | #define ACPI_FADT_8042 (1<<1) /* 01: [V3] System has an 8042 controller on port 60/64 */ | |
264 | #define ACPI_FADT_NO_VGA (1<<2) /* 02: [V4] It is not safe to probe for VGA hardware */ | |
265 | #define ACPI_FADT_NO_MSI (1<<3) /* 03: [V4] Message Signaled Interrupts (MSI) must not be enabled */ | |
266 | #define ACPI_FADT_NO_ASPM (1<<4) /* 04: [V4] PCIe ASPM control must not be enabled */ | |
267 | ||
268 | #define FADT2_REVISION_ID 3 | |
269 | ||
6e2d5ebd | 270 | /* Masks for FADT flags */ |
f3d2e786 | 271 | |
993958fe BM |
272 | #define ACPI_FADT_WBINVD (1) /* 00: [V1] The wbinvd instruction works properly */ |
273 | #define ACPI_FADT_WBINVD_FLUSH (1<<1) /* 01: [V1] wbinvd flushes but does not invalidate caches */ | |
274 | #define ACPI_FADT_C1_SUPPORTED (1<<2) /* 02: [V1] All processors support C1 state */ | |
275 | #define ACPI_FADT_C2_MP_SUPPORTED (1<<3) /* 03: [V1] C2 state works on MP system */ | |
276 | #define ACPI_FADT_POWER_BUTTON (1<<4) /* 04: [V1] Power button is handled as a control method device */ | |
277 | #define ACPI_FADT_SLEEP_BUTTON (1<<5) /* 05: [V1] Sleep button is handled as a control method device */ | |
278 | #define ACPI_FADT_FIXED_RTC (1<<6) /* 06: [V1] RTC wakeup status not in fixed register space */ | |
279 | #define ACPI_FADT_S4_RTC_WAKE (1<<7) /* 07: [V1] RTC alarm can wake system from S4 */ | |
280 | #define ACPI_FADT_32BIT_TIMER (1<<8) /* 08: [V1] ACPI timer width is 32-bit (0=24-bit) */ | |
281 | #define ACPI_FADT_DOCKING_SUPPORTED (1<<9) /* 09: [V1] Docking supported */ | |
282 | #define ACPI_FADT_RESET_REGISTER (1<<10) /* 10: [V2] System reset via the FADT RESET_REG supported */ | |
283 | #define ACPI_FADT_SEALED_CASE (1<<11) /* 11: [V3] No internal expansion capabilities and case is sealed */ | |
284 | #define ACPI_FADT_HEADLESS (1<<12) /* 12: [V3] No local video capabilities or local input devices */ | |
285 | #define ACPI_FADT_SLEEP_TYPE (1<<13) /* 13: [V3] Must execute native instruction after writing SLP_TYPx register */ | |
286 | #define ACPI_FADT_PCI_EXPRESS_WAKE (1<<14) /* 14: [V4] System supports PCIEXP_WAKE (STS/EN) bits (ACPI 3.0) */ | |
287 | #define ACPI_FADT_PLATFORM_CLOCK (1<<15) /* 15: [V4] OSPM should use platform-provided timer (ACPI 3.0) */ | |
288 | #define ACPI_FADT_S4_RTC_VALID (1<<16) /* 16: [V4] Contents of RTC_STS valid after S4 wake (ACPI 3.0) */ | |
289 | #define ACPI_FADT_REMOTE_POWER_ON (1<<17) /* 17: [V4] System is compatible with remote power on (ACPI 3.0) */ | |
290 | #define ACPI_FADT_APIC_CLUSTER (1<<18) /* 18: [V4] All local APICs must use cluster model (ACPI 3.0) */ | |
291 | #define ACPI_FADT_APIC_PHYSICAL (1<<19) /* 19: [V4] All local x_aPICs must use physical dest mode (ACPI 3.0) */ | |
292 | ||
6e2d5ebd | 293 | /* Values for preferred_profile (Prefered Power Management Profiles) */ |
1da177e4 | 294 | |
f3d2e786 BM |
295 | enum acpi_prefered_pm_profiles { |
296 | PM_UNSPECIFIED = 0, | |
297 | PM_DESKTOP = 1, | |
298 | PM_MOBILE = 2, | |
299 | PM_WORKSTATION = 3, | |
300 | PM_ENTERPRISE_SERVER = 4, | |
301 | PM_SOHO_SERVER = 5, | |
302 | PM_APPLIANCE_PC = 6 | |
1da177e4 LT |
303 | }; |
304 | ||
793c2388 | 305 | /* Reset to default packing */ |
1da177e4 | 306 | |
1da177e4 LT |
307 | #pragma pack() |
308 | ||
f3d2e786 | 309 | #define ACPI_FADT_OFFSET(f) (u8) ACPI_OFFSET (struct acpi_table_fadt, f) |
793c2388 | 310 | |
6e2d5ebd BM |
311 | /* |
312 | * Internal table-related structures | |
313 | */ | |
50df4d8b BM |
314 | union acpi_name_union { |
315 | u32 integer; | |
316 | char ascii[4]; | |
317 | }; | |
318 | ||
6e2d5ebd BM |
319 | /* Internal ACPI Table Descriptor. One per ACPI table. */ |
320 | ||
50df4d8b BM |
321 | struct acpi_table_desc { |
322 | acpi_physical_address address; | |
323 | struct acpi_table_header *pointer; | |
324 | u32 length; /* Length fixed at 32 bits */ | |
325 | union acpi_name_union signature; | |
326 | acpi_owner_id owner_id; | |
327 | u8 flags; | |
328 | }; | |
329 | ||
6e2d5ebd | 330 | /* Masks for Flags field above */ |
50df4d8b BM |
331 | |
332 | #define ACPI_TABLE_ORIGIN_UNKNOWN (0) | |
333 | #define ACPI_TABLE_ORIGIN_MAPPED (1) | |
334 | #define ACPI_TABLE_ORIGIN_ALLOCATED (2) | |
ac5f98db BM |
335 | #define ACPI_TABLE_ORIGIN_OVERRIDE (4) |
336 | #define ACPI_TABLE_ORIGIN_MASK (7) | |
337 | #define ACPI_TABLE_IS_LOADED (8) | |
50df4d8b | 338 | |
1da177e4 | 339 | /* |
f3d2e786 | 340 | * Get the remaining ACPI tables |
1da177e4 | 341 | */ |
ad363f80 | 342 | |
f3d2e786 | 343 | #include <acpi/actbl1.h> |
b24aad44 | 344 | #include <acpi/actbl2.h> |
ad363f80 | 345 | |
4be44fcd | 346 | #endif /* __ACTBL_H__ */ |