Getting Started

This section describes how to Compile and download the Tes Guilaini Demos on to the RZA3UL.

NOTE: If the IPL has not been loaded refer to the Loading the IPL.

1. Extract the Tes Guiliani archive file (Guiliani_SDK_<version>_Renesas_RZA3UL_FreeRTOS10_eGML.zip) to a working directory.  ( i.e. C:\workspace ) The resulting directory will look like this.

└── Guiliani_SDK_2.5.0_Renesas_RZA3UL_FreeRTOS10_eGML
    ├── CMake
    ├── Documentation
    ├── Export
    ├── External
    ├── FlashTools
    ├── GSE
    ├── Guiliani
    ├── Renesas
    ├── SR_GuilianiDemo
    ├── StreamRuntime
    └── eGaC

1. Start eclipse IDE
   1. In the IDE workspace dialog select the Renesas subdirectory in the extracted folder
      1. Example : C:\workspace\Guiliani_SDK_2.5.0_Renesas_RZA3UL_FreeRTOS10_eGML\Renesas

1. The Project Explorer in the IDE should be empty
2. Import the TES Projects into the IDE
   1. Right click in the Project Explorer and Select Import
   2. In the Import Dialog select  General -> Existing Projects and Workspaces
   3. In the Import Projects Dialog press the Browes Button then press the Select Folder Button in the popup dialog. Select only the following projects then click Finish.
      1. BSP
      2. SR_GuilianiDemo
3. Select the SR_GuilianiDemo Project. Right Click and select build. This build will do the following
   1. The Build will attempt a clean first. This will cause an error as there is nothing to clean
   2. Next the Build will first build the BSP Library
   3. Finally the SR_GuilianiDemo will build with no errors
4. The Generated executable and library files
   1. SR_GuilianiDemo ELF file
      1.   Debug information
   2. SR_GuilianiDemo.sec
      1.   Binary Code
   3. rza3ul_smarc_qspi_ipl.srec
      1. IPL boot loader
   4.   Resources.srec
      1. This is the GUI Widget Resouce file. This is generate the GSE.
5. Download ( J-Link)
   1. This section refers the Debug Configuration “Renesas GDB Hardware Debug”.
      1.  Connect power to the USBC connector
      2. Connect the J-Link to the Smarc Module. Use the dongle that is provided.
      3. Press and hold the red power button till the power leds are on.
      4. In the menu select Run -> Debug Configurations
      5. In the Debug Configuration Dialog select Renesas GDB Hardware Debug then SR_GuilianiDemo Debug.
         1. NOTE:  If Main Tab has a red dot this indicates the Project with the Debug Configuration was not compiled. Return to step 5.
      6.  A Segger Dialog window will show the progress of the download.

Install the IPL

TBD

Display Configuration

The Display Configuration by default are for a 1080p monitor, however the GUI demo is a Wide VGA demo. When displayed on a PC monitor the resulting image is located in the upper left side of the monitor. This section describes how to configure the RZA3UL Display Unit (DU) for a Wide VGA LCD Display.

Current Tested Displays :

RZA3UL Display Settings using FSP.

Step 1) Open the BSP Project FSP Configuration file ( configuration.xml ).

Step 2) Select the FSP Configurator "Stack" Tab.

Step 3) In the Stacks Configuration Tab in the Threads Window, select "g_display0 Display on r_lcdc"

Step 4) In the bottom of the IDE there are IDE windows ( console, Problems, Smart Brower, Properties, ... ). Select the Properties window.

NOTE: It the Properties Window is not visible, in the IDE memu select Window -> Show View -> Properties.

Step 5) With the "g_display0 Display on r_lcdc" selected in the FSP configurator you will see the properties for the DU.

Step 6) Expand the Display property Output -> Timing

Step 7) Make the following property changes.

Display Clock Settings

These steps require modification of the board level display Driver.

Step 1) Open the RA3UL Smarc Board Display Driver file rza3ul_smarc_lcd.c. This is located here <BSP Project>/src/rza3ul_smarc/ directory.

Step 2) Scroll down to the function "bsp_lcd_init".

Step 2.1) Change this code snippet

    /* PLL5 Pixel Clock */
    R_CPG->CPG_SIPLL5_CLK3 = 0x40000006;
    R_CPG->CPG_SIPLL5_CLK4 = 0x004a0000;
    R_CPG->CPG_PL5_SDIV  = 0x01010202;
    R_CPG->CPG_SIPLL5_STBY = 0x00150001;

Step 2.2) To this

    /* 40MHz 800x600 */
    uint32_t reg;
    uint32_t fracin  = 800;
    uint32_t intin   = 140;
    uint32_t refdiv  = 2;
    uint32_t posdiv1 = 7;
    uint32_t posdiv2 = 6;

    R_CPG->CPG_SIPLL5_CLK3_b.FRACIN = fracin;
    R_CPG->CPG_SIPLL5_CLK4_b.INTIN = intin;
    reg = R_CPG->CPG_SIPLL5_CLK1;
    reg &= 0xFFFF0000;
    reg |= ( (1 << 24) | (1 << 20) | (1 << 16) | (refdiv << 8) | (posdiv2 << 4) | posdiv1 );
    R_CPG->CPG_SIPLL5_CLK1 = reg;
    R_CPG->CPG_PL5_SDIV    = 0x01010000;
    R_CPG->CPG_SIPLL5_STBY = 0x00150001;

Step 3) Save file this Clean and build the SR_GuilianiDemo project. NOTE: This will clean and build the BSP project tool.

Step 4) Download the project to the RZA3UL.