API referenceEmulation APIClasses

hololink::emulation::LII2CExpanderPeripheral

View as Markdown
#include <hololink/emulation/hsb_emulator.hpp>

Inherits from: hololink::emulation::I2CPeripheral (public)

Constructors

LII2CExpanderPeripheral

hololink::emulation::LII2CExpanderPeripheral::LII2CExpanderPeripheral() = default

Methods

i2c_transaction

I2CStatus hololink::emulation::LII2CExpanderPeripheral::i2c_transaction(
    uint16_t peripheral_address,
    const uint8_t *write_bytes,
    uint16_t write_size,
    uint8_t *read_bytes,
    uint16_t read_size
) override

python:

def i2c_transaction(self: hemu.I2CPeripheral, peripheral_address: int, write_bytes: List[int], read_bytes: List[int]) -> hemu.I2CStatus

perform an I2C transaction. This will be called by the I2CController when a transaction is requested.

read request size is the size of the read_bytes vector as initialized by the caller

Returns: I2CStatus The status of the transaction.

Parameters

peripheral_address
uint16_t

The peripheral address to communicate with.

write_bytes
const uint8_t *

The bytes to write to the peripheral.

write_size
uint16_t

The size of the write bytes

read_bytes
uint8_t *

The bytes to read from the peripheral. This shall be filled with 0s to the requested read size and replaced by peripheral. This is to ensure peripheral can get the read count from read_bytes.size() and enough valid data is returned for no-ops.

read_size
uint16_t

The size of the read bytes

attach_to_i2c

void hololink::emulation::LII2CExpanderPeripheral::attach_to_i2c(
    I2CController &i2c_controller,
    uint8_t i2c_bus_address
) override

python:

def attach_to_i2c(self: hemu.I2CPeripheral, i2c_controller: hemu.I2CController, bus_address: int)

attach the peripheral to the I2C controller. This should be called by client code before start() is called

Parameters

i2c_controller
I2CController &

The I2C controller to attach to. Retrieved from HSBEmulator with get_i2c(controller_address)

bus_address
uint8_t

The bus address of the peripheral.

output_state

uint8_t hololink::emulation::LII2CExpanderPeripheral::output_state() const

start

virtual void hololink::emulation::LII2CExpanderPeripheral::start()

start the peripheral.

This will be called when I2CController itself starts and should not be done by the client code

stop

virtual void hololink::emulation::LII2CExpanderPeripheral::stop()

stop the peripheral.

This will be called when the I2CController is stopped and should not be done by the client code

Peripheral should release all resources in case a subsequent start() is called.

Member variables

NameTypeDescription
PERIPHERAL_ADDRESS static constexpruint16_t
output_state_uint8_t