mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-29 18:11:05 +00:00
c9cd870600
With the upcoming change to add a new command to get/set/clear host events and masks, it seems to be the right time to bump up the host events and masks to 64-bit. We are already out of available host events. This change opens up at least 32 bits for new host events. Old EC commands to operate on host events/masks will still deal with lower 32-bits of the events/mask. On the other hand, the new command being added will take care of the entire 64-bit events/masks. This ensures that old BIOS and kernel versions can still work with the newer EC versions. BUG=b:69329196 BRANCH=None TEST=make -j buildall. Verified: 1. hostevent set 0x4000 ==> Sets correct bit in host events 2. hostevent clear 0x4000 ==> Clears correct bit in host events 3. Kernel is able to query and read correct host event bits from EC. Verified using evtest. 4. Coreboot is able to read correct wake reason from EC. Verified using mosys eventlog list. Change-Id: Idcb24ea364ac6c491efc2f8dd9e29a9df6149e07 Signed-off-by: Furquan Shaikh <furquan@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/770925 Reviewed-by: Randall Spangler <rspangler@chromium.org>
163 lines
3.7 KiB
C
163 lines
3.7 KiB
C
/* 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"
|
|
#include "host_command.h"
|
|
|
|
/**
|
|
* 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);
|
|
|
|
/**
|
|
* Return true if keyboard data is waiting for the host to read (TOH is still
|
|
* set).
|
|
*/
|
|
int lpc_keyboard_has_char(void);
|
|
|
|
/* Return true if the FRMH is still set */
|
|
int lpc_keyboard_input_pending(void);
|
|
|
|
/**
|
|
* Send a byte to host via keyboard port 0x60.
|
|
*
|
|
* @param chr Byte to send
|
|
* @param send_irq If non-zero, asserts IRQ
|
|
*/
|
|
void lpc_keyboard_put_char(uint8_t chr, int send_irq);
|
|
|
|
/**
|
|
* Clear the keyboard buffer.
|
|
*/
|
|
void lpc_keyboard_clear_buffer(void);
|
|
|
|
/**
|
|
* Send an IRQ to host if there is a byte in buffer already.
|
|
*/
|
|
void lpc_keyboard_resume_irq(void);
|
|
|
|
/**
|
|
* 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);
|
|
|
|
/*
|
|
* Low-level LPC interface for host events.
|
|
*
|
|
* For use by host_event_commands.c. Other modules should use the methods
|
|
* provided in host_command.h.
|
|
*/
|
|
|
|
/* Types of host events */
|
|
enum lpc_host_event_type {
|
|
LPC_HOST_EVENT_SMI = 0,
|
|
LPC_HOST_EVENT_SCI,
|
|
LPC_HOST_EVENT_WAKE,
|
|
LPC_HOST_EVENT_ALWAYS_REPORT,
|
|
LPC_HOST_EVENT_COUNT,
|
|
};
|
|
|
|
/**
|
|
* Get current state of host events.
|
|
*/
|
|
host_event_t lpc_get_host_events(void);
|
|
|
|
/**
|
|
* Get host events that are set based on the type provided.
|
|
*
|
|
* @param type Event type
|
|
*/
|
|
host_event_t lpc_get_host_events_by_type(enum lpc_host_event_type type);
|
|
|
|
/**
|
|
* Set the event mask for the specified event type.
|
|
*
|
|
* @param type Event type
|
|
* @param mask New event mask
|
|
*/
|
|
void lpc_set_host_event_mask(enum lpc_host_event_type type, host_event_t mask);
|
|
|
|
/**
|
|
* Get host event mask based on the type provided.
|
|
*
|
|
* @param type Event type
|
|
*/
|
|
host_event_t lpc_get_host_event_mask(enum lpc_host_event_type type);
|
|
|
|
/**
|
|
* Clear and return the lowest host event.
|
|
*/
|
|
int lpc_get_next_host_event(void);
|
|
|
|
/**
|
|
* Set the EC_LPC_STATUS_* mask for the specified status.
|
|
*/
|
|
void lpc_set_acpi_status_mask(uint8_t mask);
|
|
|
|
/**
|
|
* Clear the EC_LPC_STATUS_* mask for the specified status.
|
|
*/
|
|
void lpc_clear_acpi_status_mask(uint8_t mask);
|
|
|
|
/**
|
|
* Return the state of platform reset.
|
|
*
|
|
* @return non-zero if PLTRST# is asserted (low); 0 if not asserted (high).
|
|
*/
|
|
int lpc_get_pltrst_asserted(void);
|
|
|
|
/**
|
|
* Reset the host with KBRST# or RCIN#
|
|
*/
|
|
void lpc_host_reset(void);
|
|
|
|
/* Disable LPC ACPI interrupts */
|
|
void lpc_disable_acpi_interrupts(void);
|
|
|
|
/* Enable LPC ACPI interrupts */
|
|
void lpc_enable_acpi_interrupts(void);
|
|
|
|
/**
|
|
* Update host event status. This function is called whenever host event bits
|
|
* need to be updated based on initialization complete or host event mask
|
|
* update or when a new host event is set or cleared.
|
|
*/
|
|
void lpc_update_host_event_status(void);
|
|
|
|
/*
|
|
* This is a weak function defined in host_events_commands.c to override the
|
|
* LPC_HOST_EVENT_ALWAYS_REPORT mask. It can be implemented by boards if there
|
|
* is a need to use custom mask.
|
|
*/
|
|
host_event_t lpc_override_always_report_mask(void);
|
|
|
|
/* Initialize LPC masks. */
|
|
void lpc_init_mask(void);
|
|
|
|
/*
|
|
* Clear LPC masks for SMI, SCI and wake upon resume from S3. This is done to
|
|
* mask these events until host unmasks them itself.
|
|
*/
|
|
void lpc_s3_resume_clear_masks(void);
|
|
|
|
#endif /* __CROS_EC_LPC_H */
|