boards/ite/it51xxx_evb/doc/index.rst
.. zephyr:board:: it51xxx_evb
Overview
The IT51XXX is a 32-bit RISC-V microcontroller. And a highly integrated embedded controller with system functions. It is suitable for mobile system applications. The picture below is the IT51526 development board (also known as it51xxx_evb/it51526aw) and its debug card.
.. figure:: it51xxx_evb_and_debug_card.webp :align: center :alt: IT51526 EVB
To find out more about ITE, visit our World Wide Web at:ITE's website_
Hardware
The IT51XXX series contains different chip types(ex, it51526, it51527), and they support different hardware features. Listing the IT51526 hardware features as following:
.. zephyr:board-supported-hw::
Programming and debugging on it51526
In order to upload the application to the device,
you'll need our flash tool and Download board.
You can get them at: ITE's website_.
#. Connect the Download Board to your host computer using the USB cable.
#. Connect the it51xxx_evb to the evolution motherboard.
#. Connect the Download Board J5 to J38(GPC1 & GPC2) on the evolution motherboard.
#. Connect the USB to UART wire to UART0 connector on the evolution motherboard.
.. image:: it51xxx_evb_wiring.webp :align: center :alt: it51xxx_evb wiring
.. note:: Be careful during connection! Use separate wires to connect I2C pins with pins on the it51xxx_evb board. Wiring connection is described in the table below.
+-------------+---------------+
| J5 | it51xxx_evb |
| Connector | J38 Connector |
+=============+===============+
| 2 | C1 |
+-------------+---------------+
| 3 | C2 |
+-------------+---------------+
| 4 | GND |
+-------------+---------------+
For USB to UART cable, connect the evolution motherboard as below:
+-------------+---------------+
| USB to UART | Evolution |
| cable | motherboard |
| | UART0 |
| | Connector |
+=============+===============+
| USB | UART0 |
+-------------+---------------+
#. Build :zephyr:code-sample:hello_world application as you would normally do
(see :Zephyr Getting Started Guide_):.
.. zephyr-app-commands:: :board: it51xxx_evb/it51526aw :zephyr-app: samples/hello_world :goals: build
#. The file :file:zephyr.bin will be created by west.
Use the winflash tool to program a zephyr application to the it51xxx/it51526aw board flash.
#. Flashing steps as described in the link: Flashing steps_.
#. Turn on the it51xxx_evb/it51526aw board switch, you should see
"Hello World! it51xxx_evb/it51526aw" sent by the board.
If you don't see this message, press the Reset button and the
message should appear.
#. Run your favorite terminal program to listen for output.
Under Linux the terminal should be :code:/dev/ttyUSB0. Do not close it.
For example:
.. code-block:: console
$ minicom -D /dev/ttyUSB0 -b 115200
#. Open a second terminal window and use the Linux flash tool to flash your board.
.. code-block:: console
$ sudo ~/itetool/ite -f build/zephyr/zephyr.bin
.. note:: The source code of ITE tool can be downloaded here: https://www.ite.com.tw/upload/2024_01_23/6_20240123162336wu55j1Rjm4.bz2
#. Split first and second terminal windows to view both of them.
You should see "Hello World! it51xxx_evb/it51526aw" in the first terminal window.
If you don't see this message, press the Reset button and the message should appear.
it51xxx_evb board can be debugged by connecting USB to UART. We can write commands and read messages through minicom in the Ubuntu terminal.
#. If the flash tool reports a failure, re-plug the 8390 Download board or power cycle the it51xxx_evb board and try again.
.. target-notes::
.. _ITE's website: https://www.ite.com.tw/en .. _Zephyr Getting Started Guide: https://docs.zephyrproject.org/latest/getting_started/index.html .. _Flashing steps: https://docs.zephyrproject.org/latest/boards/ite/it82xx2_evb/doc/index.html#flashing