2019-07-26 06:51:16 -06:00
|
|
|
========
|
|
|
|
i2c-stub
|
|
|
|
========
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2019-07-26 06:51:16 -06:00
|
|
|
Description
|
|
|
|
===========
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2014-07-17 10:56:03 -06:00
|
|
|
This module is a very simple fake I2C/SMBus driver. It implements six
|
2009-12-06 09:06:28 -07:00
|
|
|
types of SMBus commands: write quick, (r/w) byte, (r/w) byte data, (r/w)
|
2014-07-17 10:56:03 -06:00
|
|
|
word data, (r/w) I2C block data, and (r/w) SMBus block data.
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-10-13 15:56:31 -06:00
|
|
|
You need to provide chip addresses as a module parameter when loading this
|
|
|
|
driver, which will then only react to SMBus commands to these addresses.
|
2006-08-13 15:46:44 -06:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
No hardware is needed nor associated with this module. It will accept write
|
2007-10-13 15:56:31 -06:00
|
|
|
quick commands to the specified addresses; it will respond to the other
|
|
|
|
commands (also to the specified addresses) by reading from or writing to
|
|
|
|
arrays in memory. It will also spam the kernel logs for every command it
|
|
|
|
handles.
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
A pointer register with auto-increment is implemented for all byte
|
|
|
|
operations. This allows for continuous byte reads like those supported by
|
|
|
|
EEPROMs, among others.
|
|
|
|
|
2014-07-17 10:56:03 -06:00
|
|
|
SMBus block command support is disabled by default, and must be enabled
|
|
|
|
explicitly by setting the respective bits (0x03000000) in the functionality
|
|
|
|
module parameter.
|
|
|
|
|
|
|
|
SMBus block commands must be written to configure an SMBus command for
|
|
|
|
SMBus block operations. Writes can be partial. Block read commands always
|
|
|
|
return the number of bytes selected with the largest write so far.
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
The typical use-case is like this:
|
2019-07-26 06:51:16 -06:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
1. load this module
|
2009-12-06 09:06:30 -07:00
|
|
|
2. use i2cset (from the i2c-tools project) to pre-load some data
|
|
|
|
3. load the target chip driver module
|
2005-04-16 16:20:36 -06:00
|
|
|
4. observe its behavior in the kernel log
|
|
|
|
|
2008-01-27 10:14:45 -07:00
|
|
|
There's a script named i2c-stub-from-dump in the i2c-tools package which
|
|
|
|
can load register values automatically from a chip dump.
|
|
|
|
|
2019-07-26 06:51:16 -06:00
|
|
|
Parameters
|
|
|
|
==========
|
2006-08-13 15:46:44 -06:00
|
|
|
|
2007-10-13 15:56:31 -06:00
|
|
|
int chip_addr[10]:
|
|
|
|
The SMBus addresses to emulate chips at.
|
2006-08-13 15:46:44 -06:00
|
|
|
|
2009-12-06 09:06:29 -07:00
|
|
|
unsigned long functionality:
|
|
|
|
Functionality override, to disable some commands. See I2C_FUNC_*
|
|
|
|
constants in <linux/i2c.h> for the suitable values. For example,
|
|
|
|
value 0x1f0000 would only enable the quick, byte and byte data
|
|
|
|
commands.
|
|
|
|
|
2019-07-26 06:51:16 -06:00
|
|
|
u8 bank_reg[10], u8 bank_mask[10], u8 bank_start[10], u8 bank_end[10]:
|
2014-07-10 04:56:59 -06:00
|
|
|
Optional bank settings. They tell which bits in which register
|
|
|
|
select the active bank, as well as the range of banked registers.
|
|
|
|
|
2019-07-26 06:51:16 -06:00
|
|
|
Caveats
|
|
|
|
=======
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
If your target driver polls some byte or word waiting for it to change, the
|
|
|
|
stub could lock it up. Use i2cset to unlock it.
|
|
|
|
|
|
|
|
If you spam it hard enough, printk can be lossy. This module really wants
|
|
|
|
something like relayfs.
|