doc: it8xxx2: Documentation improvements

Better documentation describing the flashing and booting process.

Signed-off-by: Fu Haolei <[email protected]>

Author: fuhaolei

boards/riscv/it8xxx2_evb/doc/WinFlashTool_P1.png

@@ -18,7 +18,6 @@ It is suitable for mobile system applications.
 
 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),
@@ -60,39 +59,172 @@ currently supports the following hardware features:
    * - GPIO
      - on-chip
      - gpio
+   * - ADC
+     - on-chip
+     - adc
+   * - I2C
+     - on-chip
+     - i2c
+   * - KSCAN
+     - on-chip
+     - kscan
 
-Programming and debugging
-*************************
+
+Other hardware features are not currently supported by Zephyr.
+
+The default configuration can be found in the
+:zephyr_file:`boards/riscv/it8xxx2_evb/it8xxx2_evb_defconfig` Kconfig file.
+
+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 your Download Board to your host computer using the USB cable.
+
+   .. image:: ite_Downloadboard_setup.jpg
+        :width: 600px
+        :align: center
+        :alt: ITE Download Board Connected
+
+#. Connect your Download Board to J145 on the it8xxx2_evb board.
+
+   .. image:: it8xxx2_evb_setup.jpg
+        :width: 600px
+        :align: center
+        :alt: ITE Download Board Connected
+
+   .. 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 | J145 Connector|
+    +=============+===============+
+    |      2      |       7       |
+    +-------------+---------------+
+    |      3      |       9       |
+    +-------------+---------------+
+    |      4      |       10      |
+    +-------------+---------------+
+
+#. Connect UART0 port of the it8xxx2_evb board
+   to your host computer using the usb cable.
+
+   .. note:: Be careful during connection!
+    Use separate wires to connect USB serial with pins on the it8xxx2_evb board.
+    Wiring connection is described in the table below.
+
+    +-------------+---------------+
+    |   USB       |  it8xxx2_evb  |
+    |   Connector |  Connector    |
+    +=============+===============+
+    |      TX     |   UART0 5     |
+    +-------------+---------------+
+    |      RX     |   UART0 7     |
+    +-------------+---------------+
+    |      GND    |      J15      |
+    +-------------+---------------+
+
+#. Apply power to the board via a USB cable.
 
 Building
 ========
 
-Applications for the ``it8xxx2_evb`` board configuration can be built as usual
-(see :`Zephyr Getting Started Guide`_):
+#. 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
 
-.. zephyr-app-commands::
-   :board: it8xxx2_evb
-   :goals: build
+#. The file :file:`zephyr.bin` will be created by west.
 
 Flashing
 ========
 
-In order to upload the application to the device,
-you'll need our winflash tool and download board.
-You can get the winflash tool at here:`Download Link`_
-Use the winflash.exe tool to program a zephyr application
+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.png
+          :width: 600px
+          :align: center
+
+    .. figure:: WinFlashTool_P4.png
+          :width: 600px
+          :align: center
+
+#. 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.png
+          :width: 600px
+          :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.png
+          :width: 600px
+          :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.
+   You can find more details about tool usage from its document.
+
+#. 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
-.. _Download Link: http://www.ite.com.tw/en/product/view?mid=149