You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
228 lines
6.1 KiB
228 lines
6.1 KiB
.. _it8xxx2_evb: |
|
|
|
ITE IT8XXX2 series |
|
###################### |
|
|
|
Overview |
|
******** |
|
|
|
The IT8XXX2 is a 32-bit RISC-V Micro-controller. |
|
And a highly integrated embedded controller with system functions. |
|
It is suitable for mobile system applications. The picture below is |
|
the IT81302 MECC board (also known as it8xxx2_evb) and its debug card. |
|
|
|
.. figure:: it8xxx2_evb_and_debug_card.jpg |
|
:align: center |
|
:alt: IT81302 EVB |
|
|
|
To find out more about ITE, visit our World Wide Web at:`ITE's website`_ |
|
|
|
Hardware |
|
******** |
|
The IT8XXX2 series contains different chip types(ex, it81302, it83202), |
|
and they support different hardware features. |
|
Listing the IT81302 hardware features as following: |
|
|
|
- RISC-V RV32IMAFC instruction set |
|
- 4KB instruction cache size |
|
- 60KB SDRAM in total |
|
- Built-in 32.768 kHz clock generator |
|
- PWM, eSPI, LPC, FLASH, UART, GPIO, Timer, Watchdog, ADC, JTAG |
|
- 6 SMBus channels, with 3 DMA controllers, compatible with I2C |
|
- SPI master/slave |
|
- USB Type-c CC Logic |
|
- USB Power Delivery |
|
- Support KB scan |
|
|
|
|
|
Supported Features |
|
================== |
|
currently supports the following hardware features: |
|
|
|
.. list-table:: Supported Features |
|
:header-rows: 1 |
|
:widths: auto |
|
|
|
* - Interface |
|
- Controller |
|
- Driver/Component |
|
* - NVIC |
|
- on-chip |
|
- interrupt controller |
|
* - TIMER |
|
- on-chip |
|
- timer |
|
* - UART |
|
- on-chip |
|
- serial |
|
* - GPIO |
|
- on-chip |
|
- gpio |
|
* - ADC |
|
- on-chip |
|
- adc |
|
* - I2C |
|
- on-chip |
|
- i2c |
|
* - KSCAN |
|
- on-chip |
|
- kscan |
|
|
|
|
|
Other hardware features are not currently supported by Zephyr. |
|
|
|
The default configuration can be found in the |
|
:zephyr_file:`boards/ite/it8xxx2_evb/it8xxx2_evb_defconfig` Kconfig file. |
|
|
|
Hardware reworks |
|
**************** |
|
|
|
Before using the it8xxx2_evb, some hardware rework is needed. The HW rework |
|
guide can be found in ITE's website. |
|
https://www.ite.com.tw/uploads/product_download/IT81302_MECC_Rework_Guide_0927.pdf |
|
|
|
Programming and debugging on it83202 |
|
************************************ |
|
|
|
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`_. |
|
|
|
Wiring |
|
======= |
|
#. Connect the Download Board to your host computer using the USB cable. |
|
|
|
#. Connect the it8xxx2_evb to your host computer or a 5V1A USB power supply. |
|
|
|
#. Connect the Download Board J5 to J8 on the it8xxx2_evb board. |
|
|
|
#. Connect the USB to UART wire to it8xxx2_evb. |
|
|
|
.. image:: it8xxx2_evb_wiring.jpg |
|
:align: center |
|
:alt: it8xxx2_evb wiring |
|
|
|
.. note:: Be careful during connection! |
|
Use separate wires to connect I2C pins with pins on the it8xxx2_evb board. |
|
Wiring connection is described in the table below. |
|
|
|
+-------------+---------------+ |
|
| J5 | it8xxx2_evb | |
|
| Connector | J8 Connector | |
|
+=============+===============+ |
|
| 2 | 1 | |
|
+-------------+---------------+ |
|
| 3 | 3 | |
|
+-------------+---------------+ |
|
| 4 | 5 | |
|
+-------------+---------------+ |
|
|
|
For USB to UART cable, connect the it8xxx2_evb as below: |
|
|
|
+-------------+---------------+ |
|
| USB to UART | it8xxx2_evb | |
|
| cable | J5 Connector | |
|
+=============+===============+ |
|
| RX | J5.3 | |
|
+-------------+---------------+ |
|
| TX | J5.4 | |
|
+-------------+---------------+ |
|
| GND | eSPI Debug.10 | |
|
+-------------+---------------+ |
|
|
|
Building |
|
======== |
|
|
|
#. Build :ref:`hello_world` application as you would normally do |
|
(see :`Zephyr Getting Started Guide`_):. |
|
|
|
.. zephyr-app-commands:: |
|
:board: it8xxx2_evb |
|
:zephyr-app: samples/hello_world |
|
:goals: build |
|
|
|
#. The file :file:`zephyr.bin` will be created by west. |
|
|
|
Flashing |
|
======== |
|
|
|
Windows |
|
-------- |
|
|
|
Use the winflash tool to program a zephyr application |
|
to the it8xxx2 board flash. |
|
|
|
#. Open winflash tool and make sure the order you open the switch is right. |
|
Fisrt, turn on the Download board switch. |
|
Second, turn on the it8xxx2_evb board switch. |
|
Then, configure your winflash tool like below. |
|
|
|
.. figure:: WinFlashTool_P2.jpg |
|
:align: center |
|
|
|
.. figure:: WinFlashTool_P4.jpg |
|
|
|
#. Using winflash tool flash zephyr.bin into your ITE board. |
|
First, click ``Load`` button and select your zephyr.bin file. |
|
Second, click ``run`` to flash the iamge into board. |
|
|
|
.. figure:: WinFlashTool_P3.jpg |
|
:align: center |
|
|
|
#. At this point, you have flashed your image into ITE board and |
|
it will work if you turn on ITE board. You can use a terminal program |
|
to verify flashing worked correctly. |
|
|
|
For example, open device manager to find the USB Serial Port(COM4) and use your |
|
terminal program to connect it(Speed: 115200). |
|
|
|
.. figure:: WinFlashTool_P1.jpg |
|
:align: center |
|
|
|
#. Turn on the it8xxx2_evb board switch, you should see ``"Hello World! it8xxx2_evb"`` |
|
sent by the board. If you don't see this message, press the Reset button and the |
|
message should appear. |
|
|
|
Ubuntu |
|
-------- |
|
|
|
#. 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 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/uploads/product_download/itedlb4-linux-v106.tar.bz2 |
|
|
|
#. Split first and second terminal windows to view both of them. |
|
You should see ``"Hello World! it8xxx2_evb"`` in the first terminal window. |
|
If you don't see this message, press the Reset button and the message should appear. |
|
|
|
Debugging |
|
========= |
|
|
|
Supporting uart debug, currently. |
|
|
|
Troubleshooting |
|
=============== |
|
|
|
#. If the flash tool reports a failure, re-plug the 8390 Download board or |
|
power cycle the it8xxx2_evb board and try again. |
|
|
|
References |
|
========== |
|
|
|
.. target-notes:: |
|
|
|
.. _ITE's website: http://www.ite.com.tw/en/product/view?mid=149 |
|
.. _Zephyr Getting Started Guide: https://docs.zephyrproject.org/latest/getting_started/index.html
|
|
|