HOWTO: Create a Blinking LED application project for S32R41 using S32 RTD No AUTOSAR

[#1]

This document shows the step-by-step process to create a simple blinking LED application for the S32R41 device using the S32 RTD non-AUTOSAR drivers. For this example used for the S32R41 EVB, connected via ethernet connection through S32 Debugger.

Preparation

1. Setup the software tools
   1. Install S32 Design Studio for S32 Platform
   2. Install the S32R41 development package and the S32R41 RTD AUTOSAR 4.4. Both of these are required for the S32 Configuration Tools.
      
2. Launch S32 Design Studio for S32 Platform

Procedure

1. New S32DS Project
   
   OR
   
2. Provide a name for the project, for example 'Blinking_LED_RTD_No_AUTOSAR'. The name must be entered with no space characters.
3. Expand Family S32R41, Select S32R418AB Cortex-M7
   
4. Click Next
   Now, uncheck the selection mark for other core, i.e. for Cortex-M7-1
   
5. And Click '…' button next to SDKs
   
6. Check box next to PlatformSDK_SAF85_S32R41_2022_08_S32R418AB _M7_0. (or whichever latest SDK for the S32R41 is installed). Click OK
   
7. Click Finish. Wait for project generation wizard to complete, then expand the project within the Project Explorer view to show the contents.
   
8. To control the LED on the board, some configuration needs to be performed within the Pins Tool. There are several ways to do this. One simple way by double-click on the MEX file.
   
9. The schematic for S32R41 EVB, checking for signal line for the user LED, channel 4 is connected to user LED signal, so we use channel 4 for signal line for user LED on the chip. So, we select the signal line for Dio channel Id 4 for the LED connected on the S32R41 EVB.
   
   

   From the Peripheral Signals tab left to the Pins tool perspective layout, locate Open the Siul2_0 from the peripheral signals tab. And from the drop down menu select “gpio,36 PC_04” option as per shown in the following image.
   
   We are using PC_04 for the GPIO usage, so we are routing SIUL2_0 GPIO signal to this pin.
   
   

10. The Direction required! menu will appear. Select Output then OK.
    
    
11. In Routing Details view, notice a new line has been added and highlighted in yellow.
    
    
12. Add ‘LED’ to the Label and Identifier columns for the PC_04 pin.
    
    
13. Code Preview
    
    
14. Go to Peripherals tool and add Siul2_Dio to enable LED blinking, it adjacent to the Blue LED on S32R41  EVB.
    1. Click on the Peripherals Tool icon from the Eclipse Perspective navigation bar.
       
       
    2. From the Components view, click on ‘Add a new configuration component…’ button from the Drivers category. This will bring up a list of all configuration components.
       
       
    3. Locate and then select the ‘Siul2_Dio’ component from the list and click OK. Do not worry about the warning message. It is only indicating that the driver is not already part of the current project. The associated driver package will be added automatically. Note: It may be necessary to change the selection at the top from ‘Present in the tool-chain project’ to ‘All’.
       The DIO driver provides services for reading and writing to/from DIO Channels.
       
15. Also, select the Siul2_Port tab and uncheck the checkmark against ‘Siul2 IP Port Development Error Detect’ option as below.
    
    
16. The Gpio_Dio driver requires no further configuration. Click Save to store all changes to the .MEX file.
    
    
17. Now the device configurations are complete and the RTD configuration code can be generated. Click ‘Update Code’ from the menu bar.
    
    
18. To control the output pin which was just configured, some application code will need to be written. Return to the ‘C/C++’ perspective.
    
    
19. If not already open, in the project window click the ‘>’ next to the ‘src’ folder to show the contents, then double click ‘main.c’ file to open it. This is where the application code will be added.
    
    
20. Before the pin can be controlled, it needs to be initialized using the configuration information that was generated from the S32 Configuration tools. Initialize all pins using the Port driver by adding the following line: Insert the following line into main, after the comment 'Write your code here':
    

    /* Initialize all pins using the Port driver */
    Siul2_Port_Ip_Init(NUM_OF_CONFIGURED_PINS0, g_pin_mux_InitConfigArr0);
    
    

21. Now, add logic for the LED turn and off. To turn the pin on and off with some delays in-between to cause the LED to blink. Make the delays long enough to be perceptible.

    1. Add line to initialize variable
       
       uint8 i = 0;
       
       
    2. Change the code within the provided for loop, and add the following lines:
       
       

       /* logic for blinking LED 10 times
       for (i=0; i<10; i++)
       {
             Siul2_Dio_Ip_WritePin(LED_PORT, LED_PIN, 1U);
             level = Siul2_Dio_Ip_ReadPin(LED_PORT, LED_PIN);
             TestDelay(2000000);
             Siul2_Dio_Ip_WritePin(LED_PORT, LED_PIN, 0U);
             level = Siul2_Dio_Ip_ReadPin(LED_PORT, LED_PIN);
             TestDelay(2000000);
       }
       return (0U);
       

    3. And add this line above the main() function to initialize the variable
       volatile uint8 level;

22. Before the 'main' function, add a delay function as follows:
    
    

    void TestDelay(uint32 delay);
    void TestDelay(uint32 delay)
    {
       static volatile uint32 DelayTimer = 0;
       while (DelayTimer<delay)
       {
           DelayTimer++;
       }
       DelayTimer=0;
    }
    

23. Update the includes lines at the top of the main.c file to include the headers for the drivers used in the application:
    
    Remove
    #include "Mcal.h"
    
    Add
    

    #include "Siul2_Port_Ip.h"
    #include "Siul2_Dio_Ip.h"
    

24. Build 'Blinking_LED_RTD_No_AUTOSAR'. Select the project name in 'C/C++ Projects' view and then press 'Build'.
    
25. After the build completes, check that there are no errors.
    
26. Open Debug Configurations and select 'Blinking_LED_RTD_No_AUTOSAR_Debug_RAM'. Make sure to select the configuration which matches the build type performed, otherwise it may report an error if the build output doesn’t exist.
    
27. Now, you need to Select the Interface (Ethernet or USB) by which the S32 Debug Probe is connected.
    
    
    1. If connected via USB and this option is selected for interface, then the COM port will be detected automatically (in the rare event where 2 or more S32 Debug Probes are connected via USB to the host PC, then it may be necessary to select which COM port is correct for the probe which is connected to the EVB)
       
    2. If connected via Ethernet, enter the IP address of the probe. See the S32 Debug Probe User Manual for ways to determine the IP address.
       
28. Click Debug
    
29. To see the LED blink, click ‘Resume'.
    
    
30. This code, as it is, will blink the LED 10 times, you can make changes in for loop condition to blink it infinitely.