axi: Add AXI sandbox driver and simple emulator
Add test infrastructure and tests for the AXI uclass. Reviewed-by: Simon Glass <sjg@chromium.org> Signed-off-by: Mario Six <mario.six@gdsys.cc>
This commit is contained in:
committed by
Anatolij Gustschin
parent
9fc8706d65
commit
9a8bcabd8a
@@ -1,48 +1,47 @@
|
||||
/* SPDX-License-Identifier: GPL-2.0+ */
|
||||
/*
|
||||
* (C) Copyright 2017
|
||||
* Mario Six, Guntermann & Drunck GmbH, mario.six@gdsys.cc
|
||||
* (C) Copyright 2017, 2018
|
||||
* Mario Six, Guntermann & Drunck GmbH, mario.six@gdsys.cc
|
||||
*/
|
||||
|
||||
#ifndef _AXI_H_
|
||||
#define _AXI_H_
|
||||
|
||||
/**
|
||||
* enum axi_size_t - Determine size of AXI transfer
|
||||
* @AXI_SIZE_8: AXI sransfer is 8-bit wide
|
||||
* @AXI_SIZE_16: AXI sransfer is 16-bit wide
|
||||
* @AXI_SIZE_32: AXI sransfer is 32-bit wide
|
||||
*/
|
||||
enum axi_size_t {
|
||||
AXI_SIZE_8,
|
||||
AXI_SIZE_16,
|
||||
AXI_SIZE_32,
|
||||
};
|
||||
|
||||
/**
|
||||
* struct axi_ops - driver operations for AXI uclass
|
||||
*
|
||||
* Drivers should support these operations unless otherwise noted. These
|
||||
* operations are intended to be used by uclass code, not directly from
|
||||
* other code.
|
||||
*/
|
||||
struct axi_ops {
|
||||
/**
|
||||
* read() - Read a single value from a specified address on a AXI bus
|
||||
*
|
||||
* @dev: AXI bus to read from.
|
||||
* @address: The address to read from.
|
||||
* @data: Pointer to a variable that takes the data value read
|
||||
* from the address on the AXI bus.
|
||||
* @size: The size of the data to be read.
|
||||
* @return 0 if OK, -ve on error.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int (*read)(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
|
||||
/**
|
||||
* write() - Write a single value to a specified address on a AXI bus
|
||||
*
|
||||
* @dev: AXI bus to write to.
|
||||
* @address: The address to write to.
|
||||
* @data: Pointer to the data value to be written to the address
|
||||
* on the AXI bus.
|
||||
* @size: The size of the data to write.
|
||||
* @return 0 if OK, -ve on error.
|
||||
*
|
||||
* Return 0 if OK, -ve on error.
|
||||
*/
|
||||
int (*write)(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
@@ -52,27 +51,68 @@ struct axi_ops {
|
||||
|
||||
/**
|
||||
* axi_read() - Read a single value from a specified address on a AXI bus
|
||||
*
|
||||
* @dev: AXI bus to read from.
|
||||
* @address: The address to read from.
|
||||
* @data: Pointer to a variable that takes the data value read from the
|
||||
* address on the AXI bus.
|
||||
* @size: The size of the data to write.
|
||||
* @return 0 if OK, -ve on error.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int axi_read(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
|
||||
/**
|
||||
* axi_write() - Write a single value to a specified address on a AXI bus
|
||||
*
|
||||
* @dev: AXI bus to write to.
|
||||
* @address: The address to write to.
|
||||
* @data: Pointer to the data value to be written to the address on the
|
||||
* AXI bus.
|
||||
* @size: The size of the data to write.
|
||||
* @return 0 if OK, -ve on error.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int axi_write(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
|
||||
struct axi_emul_ops {
|
||||
/**
|
||||
* read() - Read a single value from a specified address on a AXI bus
|
||||
* @dev: AXI bus to read from.
|
||||
* @address: The address to read from.
|
||||
* @data: Pointer to a variable that takes the data value read
|
||||
* from the address on the AXI bus.
|
||||
* @size: The size of the data to be read.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int (*read)(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
|
||||
/**
|
||||
* write() - Write a single value to a specified address on a AXI bus
|
||||
* @dev: AXI bus to write to.
|
||||
* @address: The address to write to.
|
||||
* @data: Pointer to the data value to be written to the address
|
||||
* on the AXI bus.
|
||||
* @size: The size of the data to write.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int (*write)(struct udevice *dev, ulong address, void *data,
|
||||
enum axi_size_t size);
|
||||
|
||||
/**
|
||||
* get_store() - Get address of internal storage of a emulated AXI
|
||||
* device
|
||||
* @dev: Emulated AXI device to get the pointer of the internal
|
||||
* storage for.
|
||||
* @storep: Pointer to the internal storage of the emulated AXI
|
||||
* device.
|
||||
*
|
||||
* Return: 0 if OK, -ve on error.
|
||||
*/
|
||||
int (*get_store)(struct udevice *dev, u8 **storep);
|
||||
};
|
||||
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user