2007-02-02 04:13:18 +01:00
|
|
|
/*
|
2018-11-14 01:31:27 +01:00
|
|
|
* QEMU SMBus device (slave) API
|
2007-09-16 23:08:06 +02:00
|
|
|
*
|
2007-02-02 04:13:18 +01:00
|
|
|
* Copyright (c) 2007 Arastra, Inc.
|
2007-09-16 23:08:06 +02:00
|
|
|
*
|
2007-02-02 04:13:18 +01:00
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
|
|
* in the Software without restriction, including without limitation the rights
|
|
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice shall be included in
|
|
|
|
* all copies or substantial portions of the Software.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
* THE SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
2018-11-14 01:31:27 +01:00
|
|
|
#ifndef HW_SMBUS_SLAVE_H
|
|
|
|
#define HW_SMBUS_SLAVE_H
|
|
|
|
|
2013-02-05 17:06:20 +01:00
|
|
|
#include "hw/i2c/i2c.h"
|
2020-09-03 22:43:22 +02:00
|
|
|
#include "qom/object.h"
|
2007-02-02 04:13:18 +01:00
|
|
|
|
2011-12-05 03:39:20 +01:00
|
|
|
#define TYPE_SMBUS_DEVICE "smbus-device"
|
2020-08-31 23:07:37 +02:00
|
|
|
OBJECT_DECLARE_TYPE(SMBusDevice, SMBusDeviceClass,
|
qom: Remove module_obj_name parameter from OBJECT_DECLARE* macros
One of the goals of having less boilerplate on QOM declarations
is to avoid human error. Requiring an extra argument that is
never used is an opportunity for mistakes.
Remove the unused argument from OBJECT_DECLARE_TYPE and
OBJECT_DECLARE_SIMPLE_TYPE.
Coccinelle patch used to convert all users of the macros:
@@
declarer name OBJECT_DECLARE_TYPE;
identifier InstanceType, ClassType, lowercase, UPPERCASE;
@@
OBJECT_DECLARE_TYPE(InstanceType, ClassType,
- lowercase,
UPPERCASE);
@@
declarer name OBJECT_DECLARE_SIMPLE_TYPE;
identifier InstanceType, lowercase, UPPERCASE;
@@
OBJECT_DECLARE_SIMPLE_TYPE(InstanceType,
- lowercase,
UPPERCASE);
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
Reviewed-by: Cédric Le Goater <clg@kaod.org>
Acked-by: Cornelia Huck <cohuck@redhat.com>
Acked-by: Igor Mammedov <imammedo@redhat.com>
Acked-by: Paul Durrant <paul@xen.org>
Acked-by: Thomas Huth <thuth@redhat.com>
Message-Id: <20200916182519.415636-4-ehabkost@redhat.com>
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
2020-09-16 20:25:17 +02:00
|
|
|
SMBUS_DEVICE)
|
2009-05-14 23:35:08 +02:00
|
|
|
|
2019-01-11 15:08:48 +01:00
|
|
|
|
2020-09-03 22:43:22 +02:00
|
|
|
struct SMBusDeviceClass {
|
2011-12-05 03:39:20 +01:00
|
|
|
I2CSlaveClass parent_class;
|
2018-11-30 20:20:12 +01:00
|
|
|
|
|
|
|
/*
|
|
|
|
* An operation with no data, special in SMBus.
|
|
|
|
* This may be NULL, quick commands are ignore in that case.
|
|
|
|
*/
|
2007-02-02 04:13:18 +01:00
|
|
|
void (*quick_cmd)(SMBusDevice *dev, uint8_t read);
|
2018-11-30 20:38:21 +01:00
|
|
|
|
|
|
|
/*
|
|
|
|
* We can't distinguish between a word write and a block write with
|
|
|
|
* length 1, so pass the whole data block including the length byte
|
|
|
|
* (if present). The device is responsible figuring out what type of
|
|
|
|
* command this is.
|
|
|
|
* This may be NULL if no data is written to the device. Writes
|
|
|
|
* will be ignore in that case.
|
|
|
|
*/
|
|
|
|
int (*write_data)(SMBusDevice *dev, uint8_t *buf, uint8_t len);
|
|
|
|
|
2018-11-30 20:49:31 +01:00
|
|
|
/*
|
|
|
|
* Likewise we can't distinguish between different reads, or even know
|
|
|
|
* the length of the read until the read is complete, so read data a
|
|
|
|
* byte at a time. The device is responsible for adding the length
|
|
|
|
* byte on block reads. This call cannot fail, it should return
|
|
|
|
* something, preferably 0xff if nothing is available.
|
|
|
|
* This may be NULL if no data is read from the device. Reads will
|
|
|
|
* return 0xff in that case.
|
|
|
|
*/
|
|
|
|
uint8_t (*receive_byte)(SMBusDevice *dev);
|
2020-09-03 22:43:22 +02:00
|
|
|
};
|
2007-05-23 02:03:59 +02:00
|
|
|
|
2017-12-07 16:34:59 +01:00
|
|
|
#define SMBUS_DATA_MAX_LEN 34 /* command + len + 32 bytes of data. */
|
|
|
|
|
2011-12-05 03:39:20 +01:00
|
|
|
struct SMBusDevice {
|
|
|
|
/* The SMBus protocol is implemented on top of I2C. */
|
|
|
|
I2CSlave i2c;
|
|
|
|
|
|
|
|
/* Remaining fields for internal use only. */
|
2017-12-07 16:34:59 +01:00
|
|
|
int32_t mode;
|
|
|
|
int32_t data_len;
|
|
|
|
uint8_t data_buf[SMBUS_DATA_MAX_LEN];
|
2011-12-05 03:39:20 +01:00
|
|
|
};
|
|
|
|
|
2017-12-07 16:34:59 +01:00
|
|
|
extern const VMStateDescription vmstate_smbus_device;
|
|
|
|
|
|
|
|
#define VMSTATE_SMBUS_DEVICE(_field, _state) { \
|
|
|
|
.name = (stringify(_field)), \
|
|
|
|
.size = sizeof(SMBusDevice), \
|
|
|
|
.vmsd = &vmstate_smbus_device, \
|
|
|
|
.flags = VMS_STRUCT, \
|
|
|
|
.offset = vmstate_offset_value(_state, _field, SMBusDevice), \
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Users should call this in their .needed functions to know if the
|
|
|
|
* SMBus slave data needs to be transferred.
|
|
|
|
*/
|
|
|
|
bool smbus_vmstate_needed(SMBusDevice *dev);
|
|
|
|
|
2011-12-05 03:39:20 +01:00
|
|
|
#endif
|