summaryrefslogtreecommitdiff
path: root/include/lpc.h
blob: 295522ad1f03fe971da632b09424582cc02fb82c (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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
/* Copyright (c) 2012 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.
 */

/* LPC module for Chrome EC */

#ifndef __CROS_EC_LPC_H
#define __CROS_EC_LPC_H

#include "common.h"

/* Manually generate an IRQ to host.
 * Note that the irq_num == 0 would set the AH bit (Active High).
 */
void lpc_manual_irq(int irq_num);

/* Return a pointer to the host command data buffer.  This buffer must
 * only be accessed between a notification to host_command_received()
 * and a subsequent call to lpc_SendHostResponse().  <slot> is 0 for
 * kernel-originated commands, 1 for usermode-originated commands. */
uint8_t *lpc_get_host_range(int slot);

/* Return a pointer to the memory-mapped buffer.  This buffer is writable at
 * any time, and the host can read it at any time. */
uint8_t *lpc_get_memmap_range(void);

/* Send a result code to a host command.  <slot> is 0 for kernel-originated
 * commands, 1 for usermode-originated commands. */
void lpc_send_host_response(int slot, int result);

/* Return true if the TOH is still set */
int lpc_keyboard_has_char(void);

/* Send a byte to host via port 0x60 and asserts IRQ if specified. */
void lpc_keyboard_put_char(uint8_t chr, int send_irq);

/* Return non-zero if the COMx interface has received a character. */
int lpc_comx_has_char(void);

/* Return the next character pending on the COMx interface. */
int lpc_comx_get_char(void);

/* Put a character to the COMx LPC interface. */
void lpc_comx_put_char(int c);

/* Types of host events */
enum lpc_host_event_type {
	LPC_HOST_EVENT_SMI = 0,
	LPC_HOST_EVENT_SCI,
	LPC_HOST_EVENT_WAKE,
};

/* Set one or more SCI/SMI event bits. */
void lpc_set_host_events(uint32_t mask);

/* Clear one or more SCI/SMI event bits.  Write 1 to a bit to clear it. */
void lpc_clear_host_events(uint32_t mask);

/* Return the raw SCI/SMI event state. */
uint32_t lpc_get_host_events(void);

/* Set the event mask for the specified event type. */
void lpc_set_host_event_mask(enum lpc_host_event_type type, uint32_t mask);

/* Return the event mask for the specified event type. */
uint32_t lpc_get_host_event_mask(enum lpc_host_event_type type);

#endif  /* __CROS_EC_LPC_H */