This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

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.

IT81302 EVB

To find out more about ITE, visit our World Wide Web at:ITE’s website 1

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:

Table 51 Supported Features

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 boards/riscv/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 1.

Wiring

  1. Connect the Download Board to your host computer using the USB cable.

  2. Connect the it8xxx2_evb to your host computer or a 5V1A USB power supply.

  3. Connect the Download Board J5 to J8 on the it8xxx2_evb board.

  4. Connect the USB to UART wire to it8xxx2_evb.

    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 Connector

    it8xxx2_evb J8 Connector

    2

    1

    3

    3

    4

    5

    For USB to UART cable, connect the it8xxx2_evb as below:

    USB to UART cable

    it8xxx2_evb J5 Connector

    RX

    J5.3

    TX

    J5.4

    GND

    eSPI Debug.10

Building

  1. Build Hello World application as you would normally do (see :Zephyr Getting Started Guide 2):.

    # From the root of the zephyr repository
    west build -b it8xxx2_evb samples/hello_world
    
  2. The file zephyr.bin will be created by west.

Flashing

Windows

Use the winflash tool to program a zephyr application to the it8xxx2 board flash.

  1. 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.

    ../../../../_images/WinFlashTool_P2.jpg
    ../../../../_images/WinFlashTool_P4.jpg
  2. 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.

    ../../../../_images/WinFlashTool_P3.jpg
  3. 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).

    ../../../../_images/WinFlashTool_P1.jpg
  4. 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

  1. Run your favorite terminal program to listen for output. Under Linux the terminal should be /dev/ttyUSB0. Do not close it.

    For example:

    $ minicom -D /dev/ttyUSB0 -b 115200
    
  2. Open a second terminal window and use linux flash tool to flash your board.

    $ 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

  3. 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

  1. If the flash tool reports a failure, re-plug the 8390 Download board or power cycle the it8xxx2_evb board and try again.

References

1(1,2)

http://www.ite.com.tw/en/product/view?mid=149

2

https://docs.zephyrproject.org/latest/getting_started/index.html