Add remote I2C device to support external I2C device
v4 cover Add remote I2C device to support external I2C device
This patch implements the remote I2C device. The remote I2C device allows an external I2C device to communicate with the I2C controller in QEMU through the remote I2C protocol. Users no longer have to directly modify QEMU to add new I2C devices and can instead implement the emulated device externally and connect it to the remote I2C device.
Previous work by Wolfram Sang
(https://git.kernel.org/pub/scm/virt/qemu/wsa/qemu.git/commit/?h=i2c-passthrough)
was referenced. It shares the similar idea of redirecting the actual I2C device functionalities, but Sang focuses on physical devices, and we focus on emulated devices. The work by Sang mainly utilizes file descriptors while ours utilizes character devices, which offers better support for emulated devices. The work by Sang is not meant to offer full I2C device support; it only implements the receive functionality. Our work implements full support for I2C devices: send, recv, and event (match_and_add is not applicable for external devices).
v1 -> v2
fixed terminology errors in the description comments.
v2 -> v3
corrected patch set emailing errors.
v3 -> v4
added remote I2C protocol description in docs/specs
Shengtan Mao (2):
hw/i2c: add remote I2C device
docs/specs: add remote i2c docs
docs/specs/index.rst | 1 + docs/specs/remote-i2c.rst | 51 ++++++++ hw/arm/Kconfig | 1 + hw/i2c/Kconfig | 4 + hw/i2c/meson.build | 1 + hw/i2c/remote-i2c.c | 117 ++++++++++++++++++ tests/qtest/meson.build | 1 + tests/qtest/remote-i2c-test.c | 216 ++++++++++++++++++++++++++++++++++ 8 files changed, 392 insertions(+) create mode 100644 docs/specs/remote-i2c.rst create mode 100644 hw/i2c/remote-i2c.c create mode 100644 tests/qtest/remote-i2c-test.c
Signature · 1 line
2.32.0.605.g8dce9f2422-goog
PATCH v4 1/2 hw/i2c: add remote I2C device
This patch adds the remote I2C device, which supports the usage of external I2C devices.
--- hw/arm/Kconfig | 1 + hw/i2c/Kconfig | 4 + hw/i2c/meson.build | 1 + hw/i2c/remote-i2c.c | 117 ++++++++++++++++++ tests/qtest/meson.build | 1 + tests/qtest/remote-i2c-test.c | 216 ++++++++++++++++++++++++++++++++++ 6 files changed, 340 insertions(+) create mode 100644 hw/i2c/remote-i2c.c create mode 100644 tests/qtest/remote-i2c-test.c
hw/arm/Kconfig +1 -0
@@ -393,6 +393,7 @@ config NPCM7XX select MAX34451 select PL310 # cache controller select PMBUS + select REMOTE_I2C select SERIAL select SSI select UNIMP
hw/i2c/Kconfig +4 -0
@@ -1,6 +1,10 @@ config I2C bool +config REMOTE_I2C + bool + select I2C + config SMBUS bool select I2C
hw/i2c/meson.build +1 -0
@@ -6,6 +6,7 @@ i2c_ss.add(when: 'CONFIG_ACPI_X86_ICH', if_true: files('smbus_ich9.c')) i2c_ss.add(when: 'CONFIG_ASPEED_SOC', if_true: files('aspeed_i2c.c')) i2c_ss.add(when: 'CONFIG_BITBANG_I2C', if_true: files('bitbang_i2c.c')) i2c_ss.add(when: 'CONFIG_EXYNOS4', if_true: files('exynos4210_i2c.c')) +i2c_ss.add(when: 'CONFIG_REMOTE_I2C', if_true: files('remote-i2c.c')) i2c_ss.add(when: 'CONFIG_IMX_I2C', if_true: files('imx_i2c.c')) i2c_ss.add(when: 'CONFIG_MPC_I2C', if_true: files('mpc_i2c.c')) i2c_ss.add(when: 'CONFIG_NRF51_SOC', if_true: files('microbit_i2c.c'))
hw/i2c/remote-i2c.c new file +117 -0
117 lines not on this page · raw message
tests/qtest/meson.build +1 -0
@@ -218,6 +218,7 @@ qos_test_ss.add( 'pca9552-test.c', 'pci-test.c', 'pcnet-test.c', + 'remote-i2c-test.c', 'sdhci-test.c', 'spapr-phb-test.c', 'tmp105-test.c',
tests/qtest/remote-i2c-test.c new file +216 -0
216 lines not on this page · raw message
Signature · 1 line
2.32.0.605.g8dce9f2422-goog
PATCH v4 2/2 docs/specs: add remote i2c docs
In reply to Shengtan MaoChange-Id: I4ef1e31c326dbb4f741bf65d9212ff10fc3c98c3
--- docs/specs/index.rst | 1 + docs/specs/remote-i2c.rst | 51 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 docs/specs/remote-i2c.rst
docs/specs/index.rst +1 -0
@@ -13,3 +13,4 @@ guest hardware that is specific to QEMU. acpi_hw_reduced_hotplug tpm acpi_hest_ghes + remote-i2c
docs/specs/remote-i2c.rst new file +51 -0
51 lines not on this page · raw message
Signature · 1 line
2.32.0.605.g8dce9f2422-goog
Quoted 5 lines · Shengtan Mao
This patch implements the remote I2C device. The remote I2C device allows an external I2C device to communicate with the I2C controller in QEMU through the remote I2C protocol. Users no longer have to directly modify QEMU to add new I2C devices and can instead implement the emulated device externally and connect it to the remote I2C device.
I got to spend some time on this today, and I like the concept, but there is one major issue. When you do a read, you are blocking the entire qemu I/O system until the read returns, which may result in issues. At least that's may understanding of how the qemu I/O system works, which may be dated or wrong.
If you look at the IPMI code, it as an external BMC that can handle async I/O from the chardev. But the IPMI subsystem is designed to handle this sort of thing.
Unfortunately, the I2C code really isn't set up to handle async operations. I'm not sure how hard it would be to modify the I2C core to handle this, but it doesn't look trivial. Well, the changes to the core wouldn't be terrible, but all the host devices are set up for synchronous operation. You could add a separate asynchronous interface, and only host devices that were modified could use it, and your device would only work on those host devices.
Another issue is that you aren't handling errors from the chr read/write calls. If the remote connection dies, this isn't going to be good. You have to do error handling.
There is also no way for the remote end to return a NACK. That's pretty important, I think. It will, unfortunately, complicate your nice simple protocol.
Sorry to be the bearer of bad news. Maybe I'm wrong about the blocking thing, I'd be happy to be wrong.
-corey
Quoted 38 lines
Previous work by Wolfram Sang
(https://git.kernel.org/pub/scm/virt/qemu/wsa/qemu.git/commit/?h=i2c-passthrough)
was referenced. It shares the similar idea of redirecting the actual I2C device functionalities, but Sang focuses on physical devices, and we focus on emulated devices. The work by Sang mainly utilizes file descriptors while ours utilizes character devices, which offers better support for emulated devices. The work by Sang is not meant to offer full I2C device support; it only implements the receive functionality. Our work implements full support for I2C devices: send, recv, and event (match_and_addis not applicable for external devices).v1 -> v2
fixed terminology errors in the description comments.
v2 -> v3
corrected patch set emailing errors.
v3 -> v4
added remote I2C protocol description in docs/specsShengtan Mao (2):
hw/i2c: add remote I2C device
docs/specs: add remote i2c docsdocs/specs/index.rst | 1 + docs/specs/remote-i2c.rst | 51 ++++++++ hw/arm/Kconfig | 1 + hw/i2c/Kconfig | 4 + hw/i2c/meson.build | 1 + hw/i2c/remote-i2c.c | 117 ++++++++++++++++++ tests/qtest/meson.build | 1 + tests/qtest/remote-i2c-test.c | 216 ++++++++++++++++++++++++++++++++++ 8 files changed, 392 insertions(+) create mode 100644 docs/specs/remote-i2c.rst create mode 100644 hw/i2c/remote-i2c.c create mode 100644 tests/qtest/remote-i2c-test.cSignature · 1 line
2.32.0.605.g8dce9f2422-goog
Hi Corey,
Thank you so much for your feedback. I took some time to discuss these points with my team.
1. Blocking QEMU I/O
Thanks for bringing this to our attention. We acknowledge it as a drawback, but we hope that by indicating this clearly in an updated docs, the user will accept these drawbacks when they use it. In short, we hope that you will consider merging this patch despite this drawback.
2. Error Handling
We will add them for the next version.
3. Remote end NACK
It would be helpful to have a bit more information on this. The remote I2C in QEMU redirects the return value (which can indicate NACK / ACK) from the external device, so the remote end should be able to NACK if prompted by the external device. If you are saying that the remote I2C should be able to NACK independently, then no, it doesn't support that, but we can take steps to add it.
I am leaving google, so I will be passing this project to my team. Thank you again for your feedback.
best,
Shengtan
Quoted 88 lines · Corey Minyard
Quoted 1 line · Shengtan Mao
This patch implements the remote I2C device. The remote I2C device
allows an
Quoted 1 line
external I2C device to communicate with the I2C controller in QEMU
through the
Quoted 1 line
remote I2C protocol. Users no longer have to directly modify QEMU to
add new
Quoted 2 lines
I2C devices and can instead implement the emulated device externally and connect it to the remote I2C device.
I got to spend some time on this today, and I like the concept, but there is one major issue. When you do a read, you are blocking the entire qemu I/O system until the read returns, which may result in issues. At least that's may understanding of how the qemu I/O system works, which may be dated or wrong.
If you look at the IPMI code, it as an external BMC that can handle async I/O from the chardev. But the IPMI subsystem is designed to handle this sort of thing.
Unfortunately, the I2C code really isn't set up to handle async operations. I'm not sure how hard it would be to modify the I2C core to handle this, but it doesn't look trivial. Well, the changes to the core wouldn't be terrible, but all the host devices are set up for synchronous operation. You could add a separate asynchronous interface, and only host devices that were modified could use it, and your device would only work on those host devices.
Another issue is that you aren't handling errors from the chr read/write calls. If the remote connection dies, this isn't going to be good. You have to do error handling.
There is also no way for the remote end to return a NACK. That's pretty important, I think. It will, unfortunately, complicate your nice simple protocol.
Sorry to be the bearer of bad news. Maybe I'm wrong about the blocking thing, I'd be happy to be wrong.
-corey
Quoted 3 lines
Previous work by Wolfram Sang
(https://git.kernel.org/pub/scm/virt/qemu/wsa/qemu.git/commit/?h=i2c-passthrough
)Quoted 1 line
was referenced. It shares the similar idea of redirecting the actual
I2C device
Quoted 1 line
functionalities, but Sang focuses on physical devices, and we focus on
emulated devices.
Quoted 1 line
The work by Sang mainly utilizes file descriptors while ours utilizes
character
Quoted 1 line
devices, which offers better support for emulated devices. The work by
Sang is
Quoted 1 line
not meant to offer full I2C device support; it only implements the
receive
Quoted 1 line
functionality. Our work implements full support for I2C devices: send,
recv,
Quoted 29 lines
and event (
match_and_addis not applicable for external devices).v1 -> v2
fixed terminology errors in the description comments.
v2 -> v3
corrected patch set emailing errors.
v3 -> v4
added remote I2C protocol description in docs/specsShengtan Mao (2):
hw/i2c: add remote I2C device
docs/specs: add remote i2c docsdocs/specs/index.rst | 1 + docs/specs/remote-i2c.rst | 51 ++++++++ hw/arm/Kconfig | 1 + hw/i2c/Kconfig | 4 + hw/i2c/meson.build | 1 + hw/i2c/remote-i2c.c | 117 ++++++++++++++++++ tests/qtest/meson.build | 1 + tests/qtest/remote-i2c-test.c | 216 ++++++++++++++++++++++++++++++++++ 8 files changed, 392 insertions(+) create mode 100644 docs/specs/remote-i2c.rst create mode 100644 hw/i2c/remote-i2c.c create mode 100644 tests/qtest/remote-i2c-test.c--
2.32.0.605.g8dce9f2422-goog
Quoted 9 lines · Shengtan Mao
Hi Corey,
Thank you so much for your feedback. I took some time to discuss these points with my team.1. Blocking QEMU I/O
Thanks for bringing this to our attention. We acknowledge it as a drawback, but we hope that by indicating this clearly in an updated docs, the user will accept these drawbacks when they use it. In short, we hope that you will consider merging this patch despite this drawback.
I understand the complexity this will add. I'm not sure of the general QEMU policy on this. Everything that I know of that relies on remote responses is done with async I/O. The way you have proposed it would be ok for testing, I suppose, but I don't think it would be ok in a production system. Things like this have a way of sneaking in to more uses than you imagined. (Hey, we can use this to tie in to a real TPM!).
So I don't know. I'll add Peter to the To: and see if he can speak to this.
Quoted 11 lines
2. Error Handling
We will add them for the next version.3. Remote end NACK
It would be helpful to have a bit more information on this. The remote I2C in QEMU redirects the return value (which can indicate NACK / ACK) from the external device, so the remote end should be able to NACK if prompted by the external device. If you are saying that the remote I2C should be able to NACK independently, then no, it doesn't support that, but we can take steps to add it.
I believe you will eventually need the ability to get a remote NACK. You may also need the ability to signal an interrupt from the remote device (though that will require async input). The information back from the remote needs some sort of tag to make it extensible.
Quoted 3 lines
I am leaving google, so I will be passing this project to my team. Thank you again for your feedback.
Well, bummer. This is a good idea hopefully we can see it through.
Thanks,
-corey
Quoted 94 lines
best,
ShengtanQuoted 88 lines · Corey Minyard
Quoted 1 line · Shengtan Mao
This patch implements the remote I2C device. The remote I2C device
allows an
Quoted 1 line
external I2C device to communicate with the I2C controller in QEMU
through the
Quoted 1 line
remote I2C protocol. Users no longer have to directly modify QEMU to
add new
Quoted 2 lines
I2C devices and can instead implement the emulated device externally and connect it to the remote I2C device.
I got to spend some time on this today, and I like the concept, but there is one major issue. When you do a read, you are blocking the entire qemu I/O system until the read returns, which may result in issues. At least that's may understanding of how the qemu I/O system works, which may be dated or wrong.
If you look at the IPMI code, it as an external BMC that can handle async I/O from the chardev. But the IPMI subsystem is designed to handle this sort of thing.
Unfortunately, the I2C code really isn't set up to handle async operations. I'm not sure how hard it would be to modify the I2C core to handle this, but it doesn't look trivial. Well, the changes to the core wouldn't be terrible, but all the host devices are set up for synchronous operation. You could add a separate asynchronous interface, and only host devices that were modified could use it, and your device would only work on those host devices.
Another issue is that you aren't handling errors from the chr read/write calls. If the remote connection dies, this isn't going to be good. You have to do error handling.
There is also no way for the remote end to return a NACK. That's pretty important, I think. It will, unfortunately, complicate your nice simple protocol.
Sorry to be the bearer of bad news. Maybe I'm wrong about the blocking thing, I'd be happy to be wrong.
-corey
Quoted 3 lines
Previous work by Wolfram Sang
(https://git.kernel.org/pub/scm/virt/qemu/wsa/qemu.git/commit/?h=i2c-passthrough
)Quoted 1 line
was referenced. It shares the similar idea of redirecting the actual
I2C device
Quoted 1 line
functionalities, but Sang focuses on physical devices, and we focus on
emulated devices.
Quoted 1 line
The work by Sang mainly utilizes file descriptors while ours utilizes
character
Quoted 1 line
devices, which offers better support for emulated devices. The work by
Sang is
Quoted 1 line
not meant to offer full I2C device support; it only implements the
receive
Quoted 1 line
functionality. Our work implements full support for I2C devices: send,
recv,
Quoted 29 lines
and event (
match_and_addis not applicable for external devices).v1 -> v2
fixed terminology errors in the description comments.
v2 -> v3
corrected patch set emailing errors.
v3 -> v4
added remote I2C protocol description in docs/specsShengtan Mao (2):
hw/i2c: add remote I2C device
docs/specs: add remote i2c docsdocs/specs/index.rst | 1 + docs/specs/remote-i2c.rst | 51 ++++++++ hw/arm/Kconfig | 1 + hw/i2c/Kconfig | 4 + hw/i2c/meson.build | 1 + hw/i2c/remote-i2c.c | 117 ++++++++++++++++++ tests/qtest/meson.build | 1 + tests/qtest/remote-i2c-test.c | 216 ++++++++++++++++++++++++++++++++++ 8 files changed, 392 insertions(+) create mode 100644 docs/specs/remote-i2c.rst create mode 100644 hw/i2c/remote-i2c.c create mode 100644 tests/qtest/remote-i2c-test.c--
2.32.0.605.g8dce9f2422-goog