1 files changed, 48 insertions, 0 deletions
diff --git a/host_interface/i8042.h b/host_interface/i8042.h
new file mode 100644
index 0000000000..a3b2475785
--- /dev/null
+++ b/host_interface/i8042.h
@@ -0,0 +1,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 */