Subversion Repositories HelenOS

Rev

Rev 3022 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1 jermar 1
/*
2071 jermar 2
 * Copyright (c) 2001-2004 Jakub Jermar
1 jermar 3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 *
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
14
 * - The name of the author may not be used to endorse or promote products
15
 *   derived from this software without specific prior written permission.
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
28
 
1888 jermar 29
/** @addtogroup ia32   
1702 cejka 30
 * @{
31
 */
32
/** @file
33
 */
34
 
1888 jermar 35
#ifndef KERN_ia32_APIC_H_
36
#define KERN_ia32_APIC_H_
1 jermar 37
 
38
#include <arch/types.h>
39
#include <cpu.h>
40
 
41
#define FIXED       (0<<0)
42
#define LOPRI       (1<<0)
43
 
515 jermar 44
#define APIC_ID_COUNT   16
45
 
1 jermar 46
/* local APIC macros */
47
#define IPI_INIT    0
48
#define IPI_STARTUP 0
49
 
513 jermar 50
/** Delivery modes. */
51
#define DELMOD_FIXED    0x0
52
#define DELMOD_LOWPRI   0x1
53
#define DELMOD_SMI  0x2
54
/* 0x3 reserved */
55
#define DELMOD_NMI  0x4
56
#define DELMOD_INIT 0x5
57
#define DELMOD_STARTUP  0x6
58
#define DELMOD_EXTINT   0x7
1 jermar 59
 
513 jermar 60
/** Destination modes. */
61
#define DESTMOD_PHYS    0x0
62
#define DESTMOD_LOGIC   0x1
63
 
64
/** Trigger Modes. */
65
#define TRIGMOD_EDGE    0x0
66
#define TRIGMOD_LEVEL   0x1
67
 
68
/** Levels. */
69
#define LEVEL_DEASSERT  0x0
70
#define LEVEL_ASSERT    0x1
71
 
72
/** Destination Shorthands. */
73
#define SHORTHAND_NONE      0x0
74
#define SHORTHAND_SELF      0x1
75
#define SHORTHAND_ALL_INCL  0x2
76
#define SHORTHAND_ALL_EXCL  0x3
77
 
78
/** Interrupt Input Pin Polarities. */
79
#define POLARITY_HIGH   0x0
80
#define POLARITY_LOW    0x1
81
 
514 jermar 82
/** Divide Values. (Bit 2 is always 0) */
83
#define DIVIDE_2    0x0
84
#define DIVIDE_4    0x1
85
#define DIVIDE_8    0x2
86
#define DIVIDE_16   0x3
87
#define DIVIDE_32   0x8
88
#define DIVIDE_64   0x9
89
#define DIVIDE_128  0xa
90
#define DIVIDE_1    0xb
91
 
92
/** Timer Modes. */
93
#define TIMER_ONESHOT   0x0
94
#define TIMER_PERIODIC  0x1
95
 
515 jermar 96
/** Delivery status. */
97
#define DELIVS_IDLE 0x0
98
#define DELIVS_PENDING  0x1
1 jermar 99
 
515 jermar 100
/** Destination masks. */
101
#define DEST_ALL    0xff
102
 
672 jermar 103
/** Dest format models. */
104
#define MODEL_FLAT  0xf
105
#define MODEL_CLUSTER   0x0
106
 
513 jermar 107
/** Interrupt Command Register. */
4055 trochtova 108
#define ICRlo       (0x300 / sizeof(uint32_t))
109
#define ICRhi       (0x310 / sizeof(uint32_t))
2089 decky 110
typedef struct {
513 jermar 111
    union {
1780 jermar 112
        uint32_t lo;
513 jermar 113
        struct {
1780 jermar 114
            uint8_t vector;         /**< Interrupt Vector. */
513 jermar 115
            unsigned delmod : 3;        /**< Delivery Mode. */
116
            unsigned destmod : 1;       /**< Destination Mode. */
117
            unsigned delivs : 1;        /**< Delivery status (RO). */
118
            unsigned : 1;           /**< Reserved. */
119
            unsigned level : 1;     /**< Level. */
120
            unsigned trigger_mode : 1;  /**< Trigger Mode. */
121
            unsigned : 2;           /**< Reserved. */
122
            unsigned shorthand : 2;     /**< Destination Shorthand. */
123
            unsigned : 12;          /**< Reserved. */
124
        } __attribute__ ((packed));
125
    };
126
    union {
1780 jermar 127
        uint32_t hi;
513 jermar 128
        struct {
129
            unsigned : 24;          /**< Reserved. */
1780 jermar 130
            uint8_t dest;           /**< Destination field. */
513 jermar 131
        } __attribute__ ((packed));
132
    };
2089 decky 133
} __attribute__ ((packed)) icr_t;
1 jermar 134
 
1251 jermar 135
/* End Of Interrupt. */
4055 trochtova 136
#define EOI     (0x0b0 / sizeof(uint32_t))
1 jermar 137
 
514 jermar 138
/** Error Status Register. */
4055 trochtova 139
#define ESR     (0x280 / sizeof(uint32_t))
2089 decky 140
typedef union {
1780 jermar 141
    uint32_t value;
142
    uint8_t err_bitmap;
514 jermar 143
    struct {
144
        unsigned send_checksum_error : 1;
145
        unsigned receive_checksum_error : 1;
146
        unsigned send_accept_error : 1;
147
        unsigned receive_accept_error : 1;
148
        unsigned : 1;
149
        unsigned send_illegal_vector : 1;
150
        unsigned received_illegal_vector : 1;
151
        unsigned illegal_register_address : 1;
152
        unsigned : 24;
153
    } __attribute__ ((packed));
2089 decky 154
} esr_t;
1 jermar 155
 
156
/* Task Priority Register */
4055 trochtova 157
#define TPR     (0x080 / sizeof(uint32_t))
2089 decky 158
typedef union {
1780 jermar 159
    uint32_t value;
750 jermar 160
    struct {
161
        unsigned pri_sc : 4;        /**< Task Priority Sub-Class. */
162
        unsigned pri : 4;       /**< Task Priority. */
163
    } __attribute__ ((packed));
2089 decky 164
} tpr_t;
1 jermar 165
 
513 jermar 166
/** Spurious-Interrupt Vector Register. */
4055 trochtova 167
#define SVR     (0x0f0 / sizeof(uint32_t))
2089 decky 168
typedef union {
1780 jermar 169
    uint32_t value;
513 jermar 170
    struct {
1780 jermar 171
        uint8_t vector;         /**< Spurious Vector. */
750 jermar 172
        unsigned lapic_enabled : 1; /**< APIC Software Enable/Disable. */
173
        unsigned focus_checking : 1;    /**< Focus Processor Checking. */
513 jermar 174
        unsigned : 22;          /**< Reserved. */
175
    } __attribute__ ((packed));
2089 decky 176
} svr_t;
1 jermar 177
 
514 jermar 178
/** Time Divide Configuration Register. */
4055 trochtova 179
#define TDCR        (0x3e0 / sizeof(uint32_t))
2089 decky 180
typedef union {
1780 jermar 181
    uint32_t value;
514 jermar 182
    struct {
183
        unsigned div_value : 4;     /**< Divide Value, bit 2 is always 0. */
184
        unsigned : 28;          /**< Reserved. */
185
    } __attribute__ ((packed));
2089 decky 186
} tdcr_t;
1 jermar 187
 
188
/* Initial Count Register for Timer */
4055 trochtova 189
#define ICRT        (0x380 / sizeof(uint32_t))
1 jermar 190
 
191
/* Current Count Register for Timer */
4055 trochtova 192
#define CCRT        (0x390 / sizeof(uint32_t))
1 jermar 193
 
513 jermar 194
/** LVT Timer register. */
4055 trochtova 195
#define LVT_Tm      (0x320 / sizeof(uint32_t))
2089 decky 196
typedef union {
1780 jermar 197
    uint32_t value;
513 jermar 198
    struct {
1780 jermar 199
        uint8_t vector;     /**< Local Timer Interrupt vector. */
513 jermar 200
        unsigned : 4;       /**< Reserved. */
201
        unsigned delivs : 1;    /**< Delivery status (RO). */
202
        unsigned : 3;       /**< Reserved. */
203
        unsigned masked : 1;    /**< Interrupt Mask. */
204
        unsigned mode : 1;  /**< Timer Mode. */
205
        unsigned : 14;      /**< Reserved. */
206
    } __attribute__ ((packed));
2089 decky 207
} lvt_tm_t;
513 jermar 208
 
209
/** LVT LINT registers. */
4055 trochtova 210
#define LVT_LINT0   (0x350 / sizeof(uint32_t))
211
#define LVT_LINT1   (0x360 / sizeof(uint32_t))
2089 decky 212
typedef union {
1780 jermar 213
    uint32_t value;
513 jermar 214
    struct {
1780 jermar 215
        uint8_t vector;         /**< LINT Interrupt vector. */
513 jermar 216
        unsigned delmod : 3;        /**< Delivery Mode. */
217
        unsigned : 1;           /**< Reserved. */
218
        unsigned delivs : 1;        /**< Delivery status (RO). */
219
        unsigned intpol : 1;        /**< Interrupt Input Pin Polarity. */
220
        unsigned irr : 1;       /**< Remote IRR (RO). */
221
        unsigned trigger_mode : 1;  /**< Trigger Mode. */
222
        unsigned masked : 1;        /**< Interrupt Mask. */
223
        unsigned : 15;          /**< Reserved. */
224
    } __attribute__ ((packed));
2089 decky 225
} lvt_lint_t;
513 jermar 226
 
227
/** LVT Error register. */
4055 trochtova 228
#define LVT_Err     (0x370 / sizeof(uint32_t))
2089 decky 229
typedef union {
1780 jermar 230
    uint32_t value;
513 jermar 231
    struct {
1780 jermar 232
        uint8_t vector;     /**< Local Timer Interrupt vector. */
513 jermar 233
        unsigned : 4;       /**< Reserved. */
234
        unsigned delivs : 1;    /**< Delivery status (RO). */
235
        unsigned : 3;       /**< Reserved. */
236
        unsigned masked : 1;    /**< Interrupt Mask. */
237
        unsigned : 15;      /**< Reserved. */
238
    } __attribute__ ((packed));
2089 decky 239
} lvt_error_t;
513 jermar 240
 
514 jermar 241
/** Local APIC ID Register. */
4055 trochtova 242
#define L_APIC_ID   (0x020 / sizeof(uint32_t))
2089 decky 243
typedef union {
1780 jermar 244
    uint32_t value;
514 jermar 245
    struct {
246
        unsigned : 24;      /**< Reserved. */
1780 jermar 247
        uint8_t apic_id;        /**< Local APIC ID. */
514 jermar 248
    } __attribute__ ((packed));
2089 decky 249
} l_apic_id_t;
1 jermar 250
 
1251 jermar 251
/** Local APIC Version Register */
4055 trochtova 252
#define LAVR        (0x030 / sizeof(uint32_t))
27 jermar 253
#define LAVR_Mask   0xff
4055 trochtova 254
#define is_local_apic(x)    (((x) & LAVR_Mask & 0xf0) == 0x1)
255
#define is_82489DX_apic(x)  ((((x) & LAVR_Mask & 0xf0) == 0x0))
256
#define is_local_xapic(x)   (((x) & LAVR_Mask) == 0x14)
27 jermar 257
 
672 jermar 258
/** Logical Destination Register. */
4055 trochtova 259
#define  LDR        (0x0d0 / sizeof(uint32_t))
2089 decky 260
typedef union {
1780 jermar 261
    uint32_t value;
672 jermar 262
    struct {
1251 jermar 263
        unsigned : 24;      /**< Reserved. */
1780 jermar 264
        uint8_t id;     /**< Logical APIC ID. */
672 jermar 265
    } __attribute__ ((packed));
2089 decky 266
} ldr_t;
672 jermar 267
 
268
/** Destination Format Register. */
4055 trochtova 269
#define DFR     (0x0e0 / sizeof(uint32_t))
2089 decky 270
typedef union {
1780 jermar 271
    uint32_t value;
672 jermar 272
    struct {
273
        unsigned : 28;      /**< Reserved, all ones. */
274
        unsigned model : 4; /**< Model. */
275
    } __attribute__ ((packed));
2089 decky 276
} dfr_t;
672 jermar 277
 
1 jermar 278
/* IO APIC */
4055 trochtova 279
#define IOREGSEL    (0x00 / sizeof(uint32_t))
280
#define IOWIN       (0x10 / sizeof(uint32_t))
1 jermar 281
 
282
#define IOAPICID    0x00
283
#define IOAPICVER   0x01
284
#define IOAPICARB   0x02
285
#define IOREDTBL    0x10
286
 
514 jermar 287
/** I/O Register Select Register. */
2089 decky 288
typedef union {
1780 jermar 289
    uint32_t value;
514 jermar 290
    struct {
1780 jermar 291
        uint8_t reg_addr;       /**< APIC Register Address. */
514 jermar 292
        unsigned : 24;      /**< Reserved. */
293
    } __attribute__ ((packed));
2089 decky 294
} io_regsel_t;
514 jermar 295
 
512 jermar 296
/** I/O Redirection Register. */
2089 decky 297
typedef struct io_redirection_reg {
512 jermar 298
    union {
1780 jermar 299
        uint32_t lo;
512 jermar 300
        struct {
1780 jermar 301
            uint8_t intvec;         /**< Interrupt Vector. */
512 jermar 302
            unsigned delmod : 3;        /**< Delivery Mode. */
303
            unsigned destmod : 1;       /**< Destination mode. */
304
            unsigned delivs : 1;        /**< Delivery status (RO). */
305
            unsigned intpol : 1;        /**< Interrupt Input Pin Polarity. */
306
            unsigned irr : 1;       /**< Remote IRR (RO). */
307
            unsigned trigger_mode : 1;  /**< Trigger Mode. */
308
            unsigned masked : 1;        /**< Interrupt Mask. */
309
            unsigned : 15;          /**< Reserved. */
513 jermar 310
        } __attribute__ ((packed));
512 jermar 311
    };
312
    union {
1780 jermar 313
        uint32_t hi;
512 jermar 314
        struct {
315
            unsigned : 24;          /**< Reserved. */
1780 jermar 316
            uint8_t dest : 8;           /**< Destination Field. */
513 jermar 317
        } __attribute__ ((packed));
512 jermar 318
    };
319
 
2089 decky 320
} __attribute__ ((packed)) io_redirection_reg_t;
512 jermar 321
 
515 jermar 322
 
323
/** IO APIC Identification Register. */
2089 decky 324
typedef union {
1780 jermar 325
    uint32_t value;
515 jermar 326
    struct {
327
        unsigned : 24;      /**< Reserved. */
328
        unsigned apic_id : 4;   /**< IO APIC ID. */
329
        unsigned : 4;       /**< Reserved. */
330
    } __attribute__ ((packed));
2089 decky 331
} io_apic_id_t;
515 jermar 332
 
1780 jermar 333
extern volatile uint32_t *l_apic;
334
extern volatile uint32_t *io_apic;
1 jermar 335
 
1780 jermar 336
extern uint32_t apic_id_mask;
1 jermar 337
 
338
extern void apic_init(void);
339
 
340
extern void l_apic_init(void);
341
extern void l_apic_eoi(void);
1780 jermar 342
extern int l_apic_broadcast_custom_ipi(uint8_t vector);
343
extern int l_apic_send_init_ipi(uint8_t apicid);
1 jermar 344
extern void l_apic_debug(void);
1780 jermar 345
extern uint8_t l_apic_id(void);
1 jermar 346
 
1780 jermar 347
extern uint32_t io_apic_read(uint8_t address);
348
extern void io_apic_write(uint8_t address , uint32_t x);
2441 decky 349
extern void io_apic_change_ioredtbl(uint8_t pin, uint8_t dest, uint8_t v, int flags);
1780 jermar 350
extern void io_apic_disable_irqs(uint16_t irqmask);
351
extern void io_apic_enable_irqs(uint16_t irqmask);
1 jermar 352
 
353
#endif
1702 cejka 354
 
1888 jermar 355
/** @}
1702 cejka 356
 */