Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 1 | // Variable layouts of bios. |
| 2 | // |
Kevin O'Connor | 0bf9270 | 2009-08-01 11:45:37 -0400 | [diff] [blame] | 3 | // Copyright (C) 2008,2009 Kevin O'Connor <kevin@koconnor.net> |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 4 | // |
Kevin O'Connor | b1b7c2a | 2009-01-15 20:52:58 -0500 | [diff] [blame] | 5 | // This file may be distributed under the terms of the GNU LGPLv3 license. |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 6 | #ifndef __BIOSVAR_H |
| 7 | #define __BIOSVAR_H |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 8 | |
| 9 | #include "types.h" // u8 |
Kevin O'Connor | 9521e26 | 2008-07-04 13:04:29 -0400 | [diff] [blame] | 10 | #include "farptr.h" // GET_FARVAR |
Kevin O'Connor | bdce35f | 2008-02-26 21:33:14 -0500 | [diff] [blame] | 11 | #include "config.h" // CONFIG_* |
Kevin O'Connor | b68ac71 | 2009-08-09 17:25:19 -0400 | [diff] [blame] | 12 | #include "disk.h" // struct chs_s |
| 13 | |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 14 | |
| 15 | /**************************************************************** |
Kevin O'Connor | 8c0e372 | 2009-01-02 14:19:43 -0500 | [diff] [blame] | 16 | * Interupt vector table |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 17 | ****************************************************************/ |
| 18 | |
Kevin O'Connor | 3085376 | 2009-01-17 18:49:20 -0500 | [diff] [blame] | 19 | struct rmode_IVT { |
Kevin O'Connor | b68ac71 | 2009-08-09 17:25:19 -0400 | [diff] [blame] | 20 | struct segoff_s ivec[256]; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 21 | }; |
| 22 | |
Kevin O'Connor | 3d29213 | 2009-05-06 23:20:03 -0400 | [diff] [blame] | 23 | #define GET_IVT(vector) \ |
| 24 | GET_FARVAR(SEG_IVT, ((struct rmode_IVT *)0)->ivec[vector]) |
Kevin O'Connor | 9f98542 | 2009-09-09 11:34:39 -0400 | [diff] [blame] | 25 | #define SET_IVT(vector, segoff) \ |
| 26 | SET_FARVAR(SEG_IVT, ((struct rmode_IVT *)0)->ivec[vector], segoff) |
Kevin O'Connor | 8c0e372 | 2009-01-02 14:19:43 -0500 | [diff] [blame] | 27 | |
| 28 | |
| 29 | /**************************************************************** |
| 30 | * Bios Data Area (BDA) |
| 31 | ****************************************************************/ |
| 32 | |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 33 | struct bios_data_area_s { |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 34 | // 40:00 |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 35 | u16 port_com[4]; |
| 36 | u16 port_lpt[3]; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 37 | u16 ebda_seg; |
| 38 | // 40:10 |
| 39 | u16 equipment_list_flags; |
| 40 | u8 pad1; |
| 41 | u16 mem_size_kb; |
| 42 | u8 pad2; |
| 43 | u8 ps2_ctrl_flag; |
Kevin O'Connor | 4b60c00 | 2008-02-25 22:29:55 -0500 | [diff] [blame] | 44 | u8 kbd_flag0; |
| 45 | u8 kbd_flag1; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 46 | u8 alt_keypad; |
| 47 | u16 kbd_buf_head; |
| 48 | u16 kbd_buf_tail; |
| 49 | // 40:1e |
| 50 | u8 kbd_buf[32]; |
| 51 | u8 floppy_recalibration_status; |
| 52 | u8 floppy_motor_status; |
| 53 | // 40:40 |
| 54 | u8 floppy_motor_counter; |
| 55 | u8 floppy_last_status; |
| 56 | u8 floppy_return_status[7]; |
Kevin O'Connor | 6723d03 | 2008-10-25 14:37:29 -0400 | [diff] [blame] | 57 | u8 video_mode; |
| 58 | u16 video_cols; |
| 59 | u16 video_pagesize; |
| 60 | u16 video_pagestart; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 61 | // 40:50 |
Kevin O'Connor | 6723d03 | 2008-10-25 14:37:29 -0400 | [diff] [blame] | 62 | u16 cursor_pos[8]; |
Kevin O'Connor | d427a3f | 2008-03-01 14:02:41 -0500 | [diff] [blame] | 63 | // 40:60 |
Kevin O'Connor | 6723d03 | 2008-10-25 14:37:29 -0400 | [diff] [blame] | 64 | u16 cursor_type; |
| 65 | u8 video_page; |
| 66 | u16 crtc_address; |
| 67 | u8 video_msr; |
| 68 | u8 video_pal; |
Kevin O'Connor | 9f98542 | 2009-09-09 11:34:39 -0400 | [diff] [blame] | 69 | struct segoff_s jump; |
Kevin O'Connor | 6723d03 | 2008-10-25 14:37:29 -0400 | [diff] [blame] | 70 | u8 other_6b; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 71 | u32 timer_counter; |
| 72 | // 40:70 |
| 73 | u8 timer_rollover; |
Kevin O'Connor | 3491e8b | 2008-02-29 00:22:27 -0500 | [diff] [blame] | 74 | u8 break_flag; |
| 75 | u16 soft_reset_flag; |
| 76 | u8 disk_last_status; |
Kevin O'Connor | 4a16ef6 | 2008-12-31 00:09:28 -0500 | [diff] [blame] | 77 | u8 hdcount; |
Kevin O'Connor | bdce35f | 2008-02-26 21:33:14 -0500 | [diff] [blame] | 78 | u8 disk_control_byte; |
| 79 | u8 port_disk; |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 80 | u8 lpt_timeout[4]; |
| 81 | u8 com_timeout[4]; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 82 | // 40:80 |
| 83 | u16 kbd_buf_start_offset; |
| 84 | u16 kbd_buf_end_offset; |
Kevin O'Connor | 6723d03 | 2008-10-25 14:37:29 -0400 | [diff] [blame] | 85 | u8 video_rows; |
| 86 | u16 char_height; |
| 87 | u8 video_ctl; |
| 88 | u8 video_switches; |
| 89 | u8 modeset_ctl; |
| 90 | u8 dcc_index; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 91 | u8 floppy_last_data_rate; |
Kevin O'Connor | 3491e8b | 2008-02-29 00:22:27 -0500 | [diff] [blame] | 92 | u8 disk_status_controller; |
| 93 | u8 disk_error_controller; |
| 94 | u8 disk_interrupt_flag; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 95 | u8 floppy_harddisk_info; |
| 96 | // 40:90 |
| 97 | u8 floppy_media_state[4]; |
Kevin O'Connor | a3b612e | 2009-02-07 11:25:29 -0500 | [diff] [blame] | 98 | u8 floppy_track[2]; |
Kevin O'Connor | 40c0e48 | 2009-09-11 02:06:02 -0400 | [diff] [blame] | 99 | u8 kbd_flag2; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 100 | u8 kbd_led; |
Kevin O'Connor | 9f98542 | 2009-09-09 11:34:39 -0400 | [diff] [blame] | 101 | struct segoff_s user_wait_complete_flag; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 102 | u32 user_wait_timeout; |
| 103 | // 40:A0 |
| 104 | u8 rtc_wait_flag; |
Kevin O'Connor | 3d29213 | 2009-05-06 23:20:03 -0400 | [diff] [blame] | 105 | u8 other_a1[7]; |
Kevin O'Connor | 9f98542 | 2009-09-09 11:34:39 -0400 | [diff] [blame] | 106 | struct segoff_s video_savetable; |
Kevin O'Connor | 3d29213 | 2009-05-06 23:20:03 -0400 | [diff] [blame] | 107 | u8 other_ac[4]; |
| 108 | // 40:B0 |
| 109 | u8 other_b0[10]; |
| 110 | u16 vbe_mode; |
Kevin O'Connor | bdce35f | 2008-02-26 21:33:14 -0500 | [diff] [blame] | 111 | } PACKED; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 112 | |
| 113 | // BDA floppy_recalibration_status bitdefs |
| 114 | #define FRS_TIMEOUT (1<<7) |
| 115 | |
| 116 | // BDA rtc_wait_flag bitdefs |
| 117 | #define RWS_WAIT_PENDING (1<<0) |
| 118 | #define RWS_WAIT_ELAPSED (1<<7) |
| 119 | |
| 120 | // BDA floppy_media_state bitdefs |
| 121 | #define FMS_DRIVE_STATE_MASK (0x07) |
| 122 | #define FMS_MEDIA_DRIVE_ESTABLISHED (1<<4) |
| 123 | #define FMS_DOUBLE_STEPPING (1<<5) |
| 124 | #define FMS_DATA_RATE_MASK (0xc0) |
| 125 | |
| 126 | // Accessor functions |
Kevin O'Connor | 4b60c00 | 2008-02-25 22:29:55 -0500 | [diff] [blame] | 127 | #define GET_BDA(var) \ |
Kevin O'Connor | 438f635 | 2008-03-30 21:46:53 -0400 | [diff] [blame] | 128 | GET_FARVAR(SEG_BDA, ((struct bios_data_area_s *)0)->var) |
Kevin O'Connor | 4b60c00 | 2008-02-25 22:29:55 -0500 | [diff] [blame] | 129 | #define SET_BDA(var, val) \ |
Kevin O'Connor | 438f635 | 2008-03-30 21:46:53 -0400 | [diff] [blame] | 130 | SET_FARVAR(SEG_BDA, ((struct bios_data_area_s *)0)->var, (val)) |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 131 | #define CLEARBITS_BDA(var, val) do { \ |
| 132 | typeof(((struct bios_data_area_s *)0)->var) __val = GET_BDA(var); \ |
| 133 | SET_BDA(var, (__val & ~(val))); \ |
| 134 | } while (0) |
| 135 | #define SETBITS_BDA(var, val) do { \ |
| 136 | typeof(((struct bios_data_area_s *)0)->var) __val = GET_BDA(var); \ |
| 137 | SET_BDA(var, (__val | (val))); \ |
| 138 | } while (0) |
| 139 | |
| 140 | |
| 141 | /**************************************************************** |
| 142 | * Extended Bios Data Area (EBDA) |
| 143 | ****************************************************************/ |
| 144 | |
Kevin O'Connor | 609da23 | 2008-12-28 23:18:57 -0500 | [diff] [blame] | 145 | // DPTE definition |
| 146 | struct dpte_s { |
| 147 | u16 iobase1; |
| 148 | u16 iobase2; |
| 149 | u8 prefix; |
| 150 | u8 unused; |
| 151 | u8 irq; |
| 152 | u8 blkcount; |
| 153 | u8 dma; |
| 154 | u8 pio; |
| 155 | u16 options; |
| 156 | u16 reserved; |
| 157 | u8 revision; |
| 158 | u8 checksum; |
| 159 | }; |
| 160 | |
Kevin O'Connor | 4a16ef6 | 2008-12-31 00:09:28 -0500 | [diff] [blame] | 161 | // ElTorito Device Emulation data |
| 162 | struct cdemu_s { |
| 163 | u8 active; |
| 164 | u8 media; |
Kevin O'Connor | 669e644 | 2009-08-11 22:36:30 -0400 | [diff] [blame] | 165 | u8 emulated_extdrive; |
| 166 | u8 emulated_driveid; |
Kevin O'Connor | 4a16ef6 | 2008-12-31 00:09:28 -0500 | [diff] [blame] | 167 | u32 ilba; |
| 168 | u16 buffer_segment; |
| 169 | u16 load_segment; |
| 170 | u16 sector_count; |
| 171 | |
| 172 | // Virtual device |
Kevin O'Connor | b68ac71 | 2009-08-09 17:25:19 -0400 | [diff] [blame] | 173 | struct chs_s lchs; |
Kevin O'Connor | 4a16ef6 | 2008-12-31 00:09:28 -0500 | [diff] [blame] | 174 | }; |
| 175 | |
Kevin O'Connor | 56a506d | 2008-03-29 13:15:36 -0400 | [diff] [blame] | 176 | struct fdpt_s { |
| 177 | u16 cylinders; |
| 178 | u8 heads; |
| 179 | u8 a0h_signature; |
| 180 | u8 phys_sectors; |
| 181 | u16 precompensation; |
| 182 | u8 reserved; |
| 183 | u8 drive_control_byte; |
| 184 | u16 phys_cylinders; |
| 185 | u8 phys_heads; |
| 186 | u16 landing_zone; |
| 187 | u8 sectors; |
| 188 | u8 checksum; |
| 189 | } PACKED; |
| 190 | |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 191 | struct extended_bios_data_area_s { |
| 192 | u8 size; |
Kevin O'Connor | 4d6dbc6 | 2008-03-02 08:43:44 -0500 | [diff] [blame] | 193 | u8 reserved1[0x21]; |
Kevin O'Connor | 9f98542 | 2009-09-09 11:34:39 -0400 | [diff] [blame] | 194 | struct segoff_s far_call_pointer; |
Kevin O'Connor | 4d6dbc6 | 2008-03-02 08:43:44 -0500 | [diff] [blame] | 195 | u8 mouse_flag1; |
| 196 | u8 mouse_flag2; |
| 197 | u8 mouse_data[0x08]; |
| 198 | // 0x30 |
| 199 | u8 other1[0x0d]; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 200 | |
Kevin O'Connor | 4d6dbc6 | 2008-03-02 08:43:44 -0500 | [diff] [blame] | 201 | // 0x3d |
Kevin O'Connor | 9f0d94d | 2008-04-13 17:25:30 -0400 | [diff] [blame] | 202 | struct fdpt_s fdpt[2]; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 203 | |
Kevin O'Connor | 56a506d | 2008-03-29 13:15:36 -0400 | [diff] [blame] | 204 | // 0x5d |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 205 | u8 other2[0xC4]; |
| 206 | |
Kevin O'Connor | 18e38b2 | 2008-12-10 20:40:13 -0500 | [diff] [blame] | 207 | // 0x121 - Begin custom storage. |
Kevin O'Connor | 3b89719 | 2008-07-20 10:08:59 -0400 | [diff] [blame] | 208 | u8 ps2ctr; |
| 209 | |
Kevin O'Connor | 4a16ef6 | 2008-12-31 00:09:28 -0500 | [diff] [blame] | 210 | // El Torito Emulation data |
| 211 | struct cdemu_s cdemu; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 212 | |
Kevin O'Connor | 609da23 | 2008-12-28 23:18:57 -0500 | [diff] [blame] | 213 | // Buffer for disk DPTE table |
| 214 | struct dpte_s dpte; |
| 215 | |
| 216 | // Locks for removable devices |
Kevin O'Connor | c892b13 | 2009-08-11 21:59:37 -0400 | [diff] [blame] | 217 | u8 cdrom_locks[CONFIG_MAX_DRIVES]; |
Kevin O'Connor | 56a506d | 2008-03-29 13:15:36 -0400 | [diff] [blame] | 218 | |
Kevin O'Connor | c659fde | 2008-12-28 23:43:20 -0500 | [diff] [blame] | 219 | u16 boot_sequence; |
Kevin O'Connor | 18e38b2 | 2008-12-10 20:40:13 -0500 | [diff] [blame] | 220 | |
Kevin O'Connor | 7f34309 | 2009-01-01 18:31:11 -0500 | [diff] [blame] | 221 | // Stack space available for code that needs it. |
| 222 | u8 extra_stack[512] __aligned(8); |
Kevin O'Connor | b68ac71 | 2009-08-09 17:25:19 -0400 | [diff] [blame] | 223 | |
| 224 | u8 cdemu_buf[2048 * !!CONFIG_CDROM_EMU]; |
Kevin O'Connor | ed12849 | 2008-03-11 11:14:59 -0400 | [diff] [blame] | 225 | } PACKED; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 226 | |
Kevin O'Connor | 49553a4 | 2009-05-17 10:31:34 -0400 | [diff] [blame] | 227 | // The initial size and location of EBDA |
| 228 | #define EBDA_SIZE_START \ |
| 229 | DIV_ROUND_UP(sizeof(struct extended_bios_data_area_s), 1024) |
| 230 | #define EBDA_SEGMENT_START \ |
Kevin O'Connor | f416fe9 | 2009-09-24 20:51:55 -0400 | [diff] [blame] | 231 | FLATPTR_TO_SEG(BUILD_LOWRAM_END - EBDA_SIZE_START*1024) |
Kevin O'Connor | 49553a4 | 2009-05-17 10:31:34 -0400 | [diff] [blame] | 232 | |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 233 | // Accessor functions |
Kevin O'Connor | 0881537 | 2008-12-29 21:16:31 -0500 | [diff] [blame] | 234 | static inline u16 get_ebda_seg() { |
| 235 | return GET_BDA(ebda_seg); |
| 236 | } |
Kevin O'Connor | 4d7c37e | 2008-12-26 23:50:17 -0500 | [diff] [blame] | 237 | static inline struct extended_bios_data_area_s * |
| 238 | get_ebda_ptr() |
| 239 | { |
Kevin O'Connor | 0b60a06 | 2009-06-15 23:03:05 -0400 | [diff] [blame] | 240 | ASSERT32(); |
Kevin O'Connor | 35ae726 | 2009-01-19 15:44:44 -0500 | [diff] [blame] | 241 | return MAKE_FLATPTR(get_ebda_seg(), 0); |
Kevin O'Connor | 4d7c37e | 2008-12-26 23:50:17 -0500 | [diff] [blame] | 242 | } |
Kevin O'Connor | 0881537 | 2008-12-29 21:16:31 -0500 | [diff] [blame] | 243 | #define GET_EBDA2(eseg, var) \ |
| 244 | GET_FARVAR(eseg, ((struct extended_bios_data_area_s *)0)->var) |
| 245 | #define SET_EBDA2(eseg, var, val) \ |
| 246 | SET_FARVAR(eseg, ((struct extended_bios_data_area_s *)0)->var, (val)) |
Kevin O'Connor | 7f34309 | 2009-01-01 18:31:11 -0500 | [diff] [blame] | 247 | #define GET_EBDA(var) \ |
Kevin O'Connor | 0881537 | 2008-12-29 21:16:31 -0500 | [diff] [blame] | 248 | GET_EBDA2(get_ebda_seg(), var) |
Kevin O'Connor | 7f34309 | 2009-01-01 18:31:11 -0500 | [diff] [blame] | 249 | #define SET_EBDA(var, val) \ |
Kevin O'Connor | 0881537 | 2008-12-29 21:16:31 -0500 | [diff] [blame] | 250 | SET_EBDA2(get_ebda_seg(), var, (val)) |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 251 | |
Kevin O'Connor | 7f34309 | 2009-01-01 18:31:11 -0500 | [diff] [blame] | 252 | #define EBDA_OFFSET_TOP_STACK \ |
| 253 | offsetof(struct extended_bios_data_area_s, extra_stack[ \ |
| 254 | FIELD_SIZEOF(struct extended_bios_data_area_s \ |
| 255 | , extra_stack)]) |
| 256 | |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 257 | |
| 258 | /**************************************************************** |
Kevin O'Connor | 15157a3 | 2008-12-13 11:10:37 -0500 | [diff] [blame] | 259 | * Global variables |
| 260 | ****************************************************************/ |
| 261 | |
Kevin O'Connor | 8b267cb | 2009-01-19 19:25:21 -0500 | [diff] [blame] | 262 | #define GLOBAL_SEGREG CS |
| 263 | static inline u16 get_global_seg() { |
| 264 | return GET_SEG(GLOBAL_SEGREG); |
| 265 | } |
| 266 | #define GET_GLOBAL(var) \ |
| 267 | GET_VAR(GLOBAL_SEGREG, (var)) |
Kevin O'Connor | a9e286d | 2009-01-19 15:33:49 -0500 | [diff] [blame] | 268 | #define SET_GLOBAL(var, val) do { \ |
Kevin O'Connor | 0b60a06 | 2009-06-15 23:03:05 -0400 | [diff] [blame] | 269 | ASSERT32(); \ |
Kevin O'Connor | a9e286d | 2009-01-19 15:33:49 -0500 | [diff] [blame] | 270 | (var) = (val); \ |
Kevin O'Connor | 609da23 | 2008-12-28 23:18:57 -0500 | [diff] [blame] | 271 | } while (0) |
Kevin O'Connor | 15157a3 | 2008-12-13 11:10:37 -0500 | [diff] [blame] | 272 | |
| 273 | |
| 274 | /**************************************************************** |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 275 | * Bios Config Table |
| 276 | ****************************************************************/ |
| 277 | |
| 278 | struct bios_config_table_s { |
Kevin O'Connor | 44c631d | 2008-03-02 11:24:36 -0500 | [diff] [blame] | 279 | u16 size; |
| 280 | u8 model; |
| 281 | u8 submodel; |
| 282 | u8 biosrev; |
| 283 | u8 feature1, feature2, feature3, feature4, feature5; |
| 284 | } PACKED; |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 285 | |
Kevin O'Connor | 3085376 | 2009-01-17 18:49:20 -0500 | [diff] [blame] | 286 | extern struct bios_config_table_s BIOS_CONFIG_TABLE __aligned(1); |
Kevin O'Connor | f076a3e | 2008-02-25 22:25:15 -0500 | [diff] [blame] | 287 | |
Kevin O'Connor | 38fcbfe | 2008-02-25 22:30:47 -0500 | [diff] [blame] | 288 | #endif // __BIOSVAR_H |