zephyr/tests/boards/mec15xxevb_assy6853/i2c_api
Gerard Marull-Paretas 79e6b0e0f6 includes: prefer <zephyr/kernel.h> over <zephyr/zephyr.h>
As of today <zephyr/zephyr.h> is 100% equivalent to <zephyr/kernel.h>.
This patch proposes to then include <zephyr/kernel.h> instead of
<zephyr/zephyr.h> since it is more clear that you are including the
Kernel APIs and (probably) nothing else. <zephyr/zephyr.h> sounds like a
catch-all header that may be confusing. Most applications need to
include a bunch of other things to compile, e.g. driver headers or
subsystem headers like BT, logging, etc.

The idea of a catch-all header in Zephyr is probably not feasible
anyway. Reason is that Zephyr is not a library, like it could be for
example `libpython`. Zephyr provides many utilities nowadays: a kernel,
drivers, subsystems, etc and things will likely grow. A catch-all header
would be massive, difficult to keep up-to-date. It is also likely that
an application will only build a small subset. Note that subsystem-level
headers may use a catch-all approach to make things easier, though.

NOTE: This patch is **NOT** removing the header, just removing its usage
in-tree. I'd advocate for its deprecation (add a #warning on it), but I
understand many people will have concerns.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-09-05 16:31:47 +02:00
..
src
CMakeLists.txt
README.txt
prj.conf
testcase.yaml

README.txt

I2C Test For Microchip board
############################

This application test is used to test the I2C driver on Microchip
mec15xxevb_assy6853 board.


Board Hardware Setup
####################

As the I2C slave device NXP pca95xx on mec15xxevb_assy6853 is connected
to I2C00 port, however, I2C00 port is shared with UART2 RS232 to TTL
converter used to catch serial log, so it's not possible to use UART2
and I2C00 port simultaneously.
We need to change to use I2C01 port by making some jumpers setting as below:

 * JP99 	1-2 	Connected	Connect I2C01_SDA from CPU to header J5
 * JP99 	13-14 	Connected	Connect I2C01_SCL from CPU to header J5
 * JP25 	21-22 	Connected	External pull-up for I2C01_SDA
 * JP25 	23-24 	Connected	External pull-up for I2C01_SCL
 *
 * JP44.1 	J5.1 	Connected	Connect NXP PCA95xx to I2C01
 * JP44.3 	J5.3	Connected	Connect NXP PCA95xx to I2C01