# RX Family (/integration/chip_vendors/renesas/rx_family)



Supported boards in the RX Family:

* **RX72N Envision Kit**

Run the Project [#run-the-project]

<Steps>
  <Step>
    **Install e² studio**: The official IDE of Renesas is called e² studio. Because it's Eclipse-based,
    it runs on Windows, Linux, and Mac as well. It can be downloaded
    [here](https://www.renesas.com/us/en/software-tool/e-studio).
  </Step>

  <Step>
    **Install the debugger driver**: Download and install the required driver for the debugger:

    * for Windows: [64 bit here](https://www.renesas.com/us/en/document/uid/usb-driver-renesas-mcu-tools-v27700-64-bit-version-windows-os?r=488806)
      and [32 bit here](https://www.renesas.com/us/en/document/uid/usb-driver-renesas-mcu-toolse2e2-liteie850ie850apg-fp5-v27700for-32-bit-version-windows-os?r=488806)
    * for Linux: [here](https://www.renesas.com/us/en/document/swo/e2-emulator-e2-emulator-lite-linux-driver?r=488806)
  </Step>

  <Step>
    **Install the RXv3 toolchain**: RX72 requires an external compiler for the RXv3 core. A free and
    open-source version is available [here](https://llvm-gcc-renesas.com/rx-download-toolchains/)
    after registration.

    The compiler must be activated in e² studio:

    * Go to `Help` -> `Add Renesas Toolchains`
    * Press the `Add...` button
    * Select the installation folder of the toolchain

    <Figure src="/_static/images/renesas/toolchains.png" alt="Adding the RXv3 toolchain in e² studio" caption="Adding the RXv3 toolchain in e² studio" />
  </Step>

  <Step>
    **Clone the project**: Clone the ready-to-use
    [lv\_port\_renesas\_rx72n-envision-kit](https://github.com/lvgl/lv_port_renesas_rx72n-envision-kit.git)
    repository:

    ```bash title="bash" lineNumbers=1
    git clone https://github.com/lvgl/lv_port_renesas_rx72n-envision-kit.git --recurse-submodules
    ```

    Downloading the `.zip` from GitHub doesn't work as it doesn't download the submodules.
  </Step>

  <Step>
    **Import the project**: Open e² studio, go to `File` -> `Import project` and select
    `General` / `Existing projects into workspace`. Select the cloned folder and press `Finish`.
  </Step>

  <Step>
    **Generate the code**: Double-click on `RX72N_EnVision_LVGL.scfg` to activate the
    `Configuration Window`.

    Renesas' Smart Configurator (SMC) includes BSP and HAL layer support extended with
    multiple RTOS variants and other middleware stacks. The components will be
    available via code generation, including the entry point of the application.

    Press `Generate Code` in the top right corner.

    <Figure src="/_static/images/renesas/generate_smc.png" alt="Code generation with SMC" caption="Code generation with SMC" />
  </Step>

  <Step>
    **Build the project**: Press <Kbd>Ctrl</Kbd> + <Kbd>Alt</Kbd> + <Kbd>B</Kbd>.
  </Step>

  <Step>
    **Start debugging**: Click the Debug button.

    If prompted with `Debug Configurations`, on the `Debugger` tab select `E2 Lite` as
    `Debug hardware` and `R5F572NN` as `Target Device`:

    <Figure src="/_static/images/renesas/debug_rx72.png" alt="Debugger parameters for RX72" caption="Debugger parameters for RX72" />
  </Step>
</Steps>

<Callout type="info">
  Make sure that both channels of the `SW1` DIP switch (next to `ECN1`) are OFF.
</Callout>

Modify the Project [#modify-the-project]

Open a demo [#open-a-demo]

The entry point of the main task is contained in `src/LVGL_thread_entry.c`.

You can disable the LVGL demos (or just comment them out) and call some
`lv_example_...()` functions, or add your own custom code.

Configuration [#configuration]

`src/lv_conf.h` contains the most important settings for LVGL. Namely:

* <ApiLink name="LV_COLOR_FORMAT_DEFAULT" /> to set the color format LVGL renders in
* <ApiLink name="LV_MEM_SIZE" /> to set the maximum RAM available to LVGL
* <ApiLink name="LV_USE_DRAW_DAVE2D" /> to enable the [Dave2D GPU](/integration/chip_vendors/renesas/dave2d_gpu)

Hardware and software components can be modified in a visual way using the
`Configuration Window`.

Support [#support]

In case of any problems or questions open an issue in the corresponding repository.