summaryrefslogtreecommitdiff
path: root/host_interface/i8042.h
blob: a3b2475785e9d8ef8c30b05afb3a489f88069f7e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
/* Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 *
 * i8042.h -- defines the interface between EC core and the EC lib, which
 * talks to the LPC driver (on the EC side) peering to the keyboard driver
 * (on the host side).
 *
 * The EC lib implements this interface.
 */

#ifndef __HOST_INTERFACE_I8042_H
#define __HOST_INTERFACE_I8042_H

#include "cros_ec/include/ec_common.h"



/*
 * Register the i8042 callback to EC lib.
 *
 * The callback function would return an integer to indicate how many bytes
 * contain in output (max len is MAX_I8042_OUTPUT_LEN defined below).
 * Then the EC lib would output those bytes via port 0x60 one-by-one.
 *
 * Registering a NULL pointer can remove any registered callback.
 */
typedef int (*EcI8042Callback) (
    uint8_t command,
    uint8_t data,
    uint8_t *output);

EcError EcI8042RegisterCallback(EcI8042Callback callback);
#define MAX_I8042_OUTPUT_LEN 4


/* Send the scan code to the host. The EC lib will push the scan code bytes
 * to host via port 0x60 and assert the IBF flag to trigger an interrupt.
 * The EC lib must queue them if the host cannot read the previous byte away
 * in time.
 *
 * Return:
 *   EC_ERROR_BUFFER_FULL -- the queue to host is full. Try again?
 */
EcError EcI8042SendScanCode(int len, uint8_t *scan_code);


#endif  /* __HOST_INTERFACE_I8042_H */