Setting up your XC120 + XE121
=============================

Flashing
--------

.. attention::

   To flash and connect to SDK/RSS v0.8.0 or newer,
   Exploration Tool v5.9.0 or newer is required.


The most convenient method to prepare the XC120 board for flashing is to let the Exploration Tool Application
automatically download the latest binary file.

Automatically download and flash using the GUI
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Start the Exploration Tool Application::

   python -m acconeer.exptool.app

To automatically download the latest binary file:

1. Open the **Flash tool** by selecting the **Flash tab** in the tab selection
2. Click the **Get latest bin file** button

.. figure:: /_static/gui/flash_tool_dialog_xc120.png
   :align: center
   :width: 80%

|

Once the binary file has been downloaded it is possible to start flashing the board by clicking the **Flash** button
in the **Flash tool**.

Automatically download and flash using the CLI
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Run the following command from the CLI::

   python -m acconeer.exptool.flash flash -d XC120 -f


Manually download and flash
^^^^^^^^^^^^^^^^^^^^^^^^^^^

Start by downloading the latest ``acc_exploration_server_a121.bin`` from our `developer page <https://developer.acconeer.com/>`_.

Flash XC120 using the Exploration Tool Application::

   python -m acconeer.exptool.app

or by using the following command::

   python -m acconeer.exptool.flash flash -d XC120 -i acc_exploration_server_a121.bin

Windows USB drivers (deprecated)
--------------------------------

.. attention::

   Manual driver installation is no longer needed from SDK/RSS v0.8.0,
   but requires Exploration Tool v5.9.0 or newer.

For enhanced stability and performance on Windows, we strongly recommend using the WinUSB driver to communicate with the XC120.
In order to do so, follow the steps below.

Download Zadig from their `website <https://zadig.akeo.ie/>`_.
We recommend version 2.7 or newer.

With the XC120 plugged in, run the Zadig application.

Under *Options*, select *List All Devices*:

.. figure:: /_static/zadig/zadig-1.png
   :align: center
   :width: 80%

|

Find the *XC120 Exploration Server* in the dropdown. Make sure *WinUSB* is selected as the driver to replace with. Now it should look like this:

.. figure:: /_static/zadig/zadig-2.png
   :align: center
   :width: 80%

|

Click *Replace Driver*. The process could take a minute. Once it's done, it should look like this:

.. figure:: /_static/zadig/zadig-3.png
   :align: center
   :width: 80%

|

All done! Now you can close Zadig and run the XC120 with the WinUSB driver.
In the app, select the XC120 like this:

.. figure:: /_static/zadig/usb-in-app.png
   :align: center
   :width: 80%

|