mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-26 01:37:24 +00:00
581738642f
Do not use the global platform_i2c_transfer() function that can only be implemented by a single driver. Instead, make a `struct device` aware transfer() function the only interface function for I2C controller dri- vers to implement. To not force the slave device drivers to be implemented either above generic I2C or specialized SMBus operations, we support SMBus control- lers in the slave device interface too. We start with four simple slave functions: i2c_readb(), i2c_writeb(), i2c_readb_at() and i2c_writeb_at(). They are all compatible to respec- tive SMBus functions. But we keep aliases because it would be weird to force e.g. an I2C EEPROM driver to call smbus_read_byte(). Change-Id: I98386f91bf4799ba3df84ec8bc0f64edd4142818 Signed-off-by: Nico Huber <nico.huber@secunet.com> Reviewed-on: https://review.coreboot.org/20846 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Aaron Durbin <adurbin@chromium.org> Reviewed-by: Kyösti Mälkki <kyosti.malkki@gmail.com>
61 lines
2.0 KiB
C
61 lines
2.0 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright (C) 2009 coresystems GmbH
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
|
|
#ifndef __TYPES_H
|
|
#define __TYPES_H
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
/*
|
|
* This may mean something else on architectures where the bits are numbered
|
|
* from the MSB (e.g. PowerPC), but until we cross that bridge, this macro is
|
|
* perfectly fine.
|
|
*/
|
|
#define BIT(x) (1ul << (x))
|
|
|
|
/**
|
|
* coreboot error codes
|
|
*
|
|
* When building functions that return a status or an error code, use cb_err as
|
|
* the return type. When failure reason needs to be communicated by the return
|
|
* value, define a it here. Start new enum groups with values in decrements of
|
|
* 100.
|
|
*/
|
|
enum cb_err {
|
|
CB_SUCCESS = 0, /**< Call completed succesfully */
|
|
CB_ERR = -1, /**< Generic error code */
|
|
CB_ERR_ARG = -2, /**< Invalid argument */
|
|
|
|
/* NVRAM/CMOS errors */
|
|
CB_CMOS_OTABLE_DISABLED = -100, /**< Option table disabled */
|
|
CB_CMOS_LAYOUT_NOT_FOUND = -101, /**< Layout file not found */
|
|
CB_CMOS_OPTION_NOT_FOUND = -102, /**< Option string not found */
|
|
CB_CMOS_ACCESS_ERROR = -103, /**< CMOS access error */
|
|
CB_CMOS_CHECKSUM_INVALID = -104, /**< CMOS checksum is invalid */
|
|
|
|
/* Keyboard test failures */
|
|
CB_KBD_CONTROLLER_FAILURE = -200,
|
|
CB_KBD_INTERFACE_FAILURE = -201,
|
|
|
|
/* I2C controller failures */
|
|
CB_I2C_NO_DEVICE = -300, /**< Device is not responding */
|
|
CB_I2C_BUSY = -301, /**< Device tells it's busy */
|
|
CB_I2C_PROTOCOL_ERROR = -302, /**< Data lost or spurious slave
|
|
device response, try again? */
|
|
CB_I2C_TIMEOUT = -303, /**< Transmission timed out */
|
|
};
|
|
|
|
#endif /* __TYPES_H */
|