Skip to content

Commit 5cc1902

Browse files
aescolardleach02
authored andcommitted
docs: Bus emulators: Misc fixes
* Convert png figures to svg * Remove app.png and the paragraph which elaborated on it. (It was very specific to some particular user case, and having it did not improve understanding) * Correct all references to "native_posix drivers" to the be just "emulated drivers" (they are not native_sim specific) * Correct path for a file which was moved Signed-off-by: Alberto Escolar Piedras <[email protected]>
1 parent 4f41a34 commit 5cc1902

File tree

6 files changed

+13
-13
lines changed

6 files changed

+13
-13
lines changed

doc/hardware/emulator/bus_emulators.rst

Lines changed: 5 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,12 @@ Concept
2727
The diagram below shows application code / high-level tests at the top.
2828
This is the ultimate application we want to run.
2929

30-
.. figure:: img/arch.png
30+
.. figure:: img/arch.svg
3131
:align: center
3232
:alt: Emulator architecture showing tests, emulators and drivers
3333

3434
Below that are peripheral drivers, such as the AT24 EEPROM driver. We can test
35-
peripheral drivers using an emulation driver connected via a native_sim I2C
35+
peripheral drivers using an emulation driver connected via a emulated I2C
3636
controller/emulator which passes I2C traffic from the AT24 driver to the AT24
3737
simulator.
3838

@@ -46,15 +46,7 @@ works, we should expect the application and peripheral drivers to work on the
4646
real hardware also.
4747

4848
Using the above framework we can test an entire application (e.g. Embedded
49-
Controller) on native_sim using emulators for all non-chip drivers:
50-
51-
.. figure:: img/app.png
52-
:align: center
53-
:alt: Example system, using emulators to implement a PC EC
54-
55-
The 'real' code is shown in green. The Zephyr emulation-framework code is shown
56-
in yellow. The blue boxes are the extra code we have to write to emulate the
57-
peripherals.
49+
Controller) on native_sim using emulators for all non-chip drivers.
5850

5951
With this approach we can:
6052

@@ -89,7 +81,7 @@ same ``compat`` value from the real driver.
8981
/* From drivers/sensor/bm160/bm160.c */
9082
#define DT_DRV_COMPAT bosch_bmi160
9183
92-
/* From subsys/emul/emul_bmi160.c */
84+
/* From drivers/sensor/bmi160/emul_bmi160.c */
9385
#define DT_DRV_COMPAT bosch_bmi160
9486
9587
The ``EMUL_DT_DEFINE()`` function accepts two API types:
@@ -104,7 +96,7 @@ The diagram below demonstrates the logical organization of the ``bus_api`` and
10496
``_backend_api`` using the BC1.2 charging detector driver as the model
10597
device-class.
10698

107-
.. figure:: img/device_class_emulator.png
99+
.. figure:: img/device_class_emulator.svg
108100
:align: center
109101
:alt: Device class example, demonstrating BC1.2 charging detectors.
110102

doc/hardware/emulator/img/app.png

-53.1 KB
Binary file not shown.

doc/hardware/emulator/img/arch.png

-31 KB
Binary file not shown.

doc/hardware/emulator/img/arch.svg

Lines changed: 4 additions & 0 deletions
Loading
Binary file not shown.

0 commit comments

Comments
 (0)