Subversion Repositories HelenOS

Rev

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

Rev Author Line No. Line
1 jermar 1
/*
2
 * Copyright (C) 2001-2004 Jakub 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
 
1754 jermar 29
/** @addtogroup genarch
1702 cejka 30
 * @{
31
 */
1754 jermar 32
/**
1757 jermar 33
 * @file
1754 jermar 34
 * @brief   i8042 processor driver.
35
 *
36
 * It takes care of low-level keyboard functions.
1702 cejka 37
 */
38
 
1842 jermar 39
#include <genarch/kbd/i8042.h>
1843 jermar 40
#include <genarch/kbd/key.h>
1842 jermar 41
#include <genarch/kbd/scanc.h>
42
#include <genarch/kbd/scanc_pc.h>
894 jermar 43
#include <arch/drivers/i8042.h>
1 jermar 44
#include <arch/interrupt.h>
45
#include <cpu.h>
46
#include <arch/asm.h>
47
#include <arch.h>
508 jermar 48
#include <typedefs.h>
511 jermar 49
#include <console/chardev.h>
50
#include <console/console.h>
576 palkovsky 51
#include <interrupt.h>
1 jermar 52
 
1754 jermar 53
/* Keyboard commands. */
512 jermar 54
#define KBD_ENABLE  0xf4
55
#define KBD_DISABLE 0xf5
56
#define KBD_ACK     0xfa
57
 
670 vana 58
/*
893 jermar 59
 * 60  Write 8042 Command Byte: next data byte written to port 60h is
895 jermar 60
 *     placed in 8042 command register. Format:
893 jermar 61
 *
62
 *    |7|6|5|4|3|2|1|0|8042 Command Byte
63
 *     | | | | | | | `---- 1=enable output register full interrupt
64
 *     | | | | | | `----- should be 0
65
 *     | | | | | `------ 1=set status register system, 0=clear
66
 *     | | | | `------- 1=override keyboard inhibit, 0=allow inhibit
67
 *     | | | `-------- disable keyboard I/O by driving clock line low
68
 *     | | `--------- disable auxiliary device, drives clock line low
69
 *     | `---------- IBM scancode translation 0=AT, 1=PC/XT
70
 *     `----------- reserved, should be 0
71
 */
670 vana 72
 
893 jermar 73
#define i8042_SET_COMMAND   0x60
1759 palkovsky 74
#define i8042_COMMAND       0x69
894 jermar 75
 
76
#define i8042_BUFFER_FULL_MASK  0x01
893 jermar 77
#define i8042_WAIT_MASK     0x02
1759 palkovsky 78
#define i8042_MOUSE_DATA        0x20
670 vana 79
 
575 palkovsky 80
static void i8042_suspend(chardev_t *);
81
static void i8042_resume(chardev_t *);
511 jermar 82
 
83
static chardev_operations_t ops = {
84
    .suspend = i8042_suspend,
878 vana 85
    .resume = i8042_resume,
1896 jermar 86
    .read = i8042_key_read
511 jermar 87
};
88
 
958 jermar 89
static void i8042_interrupt(int n, istate_t *istate);
895 jermar 90
static void i8042_wait(void);
576 palkovsky 91
 
1474 palkovsky 92
static iroutine oldvector;
93
/** Initialize keyboard and service interrupts using kernel routine */
94
void i8042_grab(void)
1 jermar 95
{
1474 palkovsky 96
    oldvector = exc_register(VECTOR_KBD, "i8042_interrupt", (iroutine) i8042_interrupt);
895 jermar 97
    i8042_wait();
894 jermar 98
    i8042_command_write(i8042_SET_COMMAND);
895 jermar 99
    i8042_wait();
894 jermar 100
    i8042_data_write(i8042_COMMAND);
895 jermar 101
    i8042_wait();
1474 palkovsky 102
}
103
/** Resume the former interrupt vector */
104
void i8042_release(void)
105
{
106
    if (oldvector)
107
        exc_register(VECTOR_KBD, "user_interrupt", oldvector);
108
}
670 vana 109
 
1474 palkovsky 110
/** Initialize i8042. */
111
void i8042_init(void)
112
{
113
    int i;
114
 
115
    i8042_grab();
116
        /* Prevent user from accidentaly releasing calling i8042_resume
117
     * and disabling keyboard
118
     */
119
    oldvector = NULL;
120
 
512 jermar 121
    trap_virtual_enable_irqs(1<<IRQ_KBD);
575 palkovsky 122
    chardev_initialize("i8042_kbd", &kbrd, &ops);
511 jermar 123
    stdin = &kbrd;
1195 jermar 124
 
1194 vana 125
    /*
1195 jermar 126
     * Clear input buffer.
127
     * Number of iterations is limited to prevent infinite looping.
128
     */
129
    for (i = 0; (i8042_status_read() & i8042_BUFFER_FULL_MASK) && i < 100; i++) {
1194 vana 130
        i8042_data_read();
1195 jermar 131
    }  
1 jermar 132
}
133
 
508 jermar 134
/** Process i8042 interrupt.
135
 *
136
 * @param n Interrupt vector.
1708 jermar 137
 * @param istate Interrupted state.
508 jermar 138
 */
958 jermar 139
void i8042_interrupt(int n, istate_t *istate)
1 jermar 140
{
1780 jermar 141
    uint8_t x;
142
    uint8_t status;
1 jermar 143
 
1759 palkovsky 144
    while (((status=i8042_status_read()) & i8042_BUFFER_FULL_MASK)) {
1753 palkovsky 145
        x = i8042_data_read();
1759 palkovsky 146
 
147
        if ((status & i8042_MOUSE_DATA))
148
            continue;
149
 
1753 palkovsky 150
        if (x & KEY_RELEASE)
151
            key_released(x ^ KEY_RELEASE);
152
        else
153
            key_pressed(x);
154
    }
1 jermar 155
    trap_virtual_eoi();
156
}
508 jermar 157
 
895 jermar 158
/** Wait until the controller reads its data. */
159
void i8042_wait(void) {
160
    while (i8042_status_read() & i8042_WAIT_MASK) {
161
        /* wait */
162
    }
163
}
164
 
511 jermar 165
/* Called from getc(). */
575 palkovsky 166
void i8042_resume(chardev_t *d)
511 jermar 167
{
168
}
169
 
170
/* Called from getc(). */
575 palkovsky 171
void i8042_suspend(chardev_t *d)
511 jermar 172
{
173
}
878 vana 174
 
1896 jermar 175
char i8042_key_read(chardev_t *d)
878 vana 176
{
177
    char ch;   
178
 
894 jermar 179
    while(!(ch = active_read_buff_read())) {
1780 jermar 180
        uint8_t x;
1753 palkovsky 181
        while (!(i8042_status_read() & i8042_BUFFER_FULL_MASK))
894 jermar 182
            ;
183
        x = i8042_data_read();
1842 jermar 184
        if (x & KEY_RELEASE)
185
            key_released(x ^ KEY_RELEASE);
186
        else
187
            active_read_key_pressed(x);
878 vana 188
    }
189
    return ch;
190
}
895 jermar 191
 
192
/** Poll for key press and release events.
193
 *
194
 * This function can be used to implement keyboard polling.
195
 */
196
void i8042_poll(void)
197
{
1780 jermar 198
    uint8_t x;
895 jermar 199
 
200
    while (((x = i8042_status_read() & i8042_BUFFER_FULL_MASK))) {
201
        x = i8042_data_read();
1842 jermar 202
        if (x & KEY_RELEASE)
203
            key_released(x ^ KEY_RELEASE);
204
        else
205
            key_pressed(x);
895 jermar 206
    }
207
}
1702 cejka 208
 
1754 jermar 209
/** @}
1702 cejka 210
 */