1. Example Description
    This application demonstrates the usage of a subset of Real Time Drivers. It is not part of the production code deliverables.
    The application includes an EB Tresos project that configures the Base, Dem, Mcl, EcuC, Pwm, Mcu, Os, Platform, Port, Dio and Resource drivers.
    The example perform basic functionality of Pwm driver.
    1.1 The application software functionality
        - Mcu_Init, Mcu_InitClock, Mcu_SetMode
                Initialize the clock sources, the clock tree and to configure the clock gating of the peripherals.
        - Port_Init
                Initialize the pins used by the application using the Port driver.
        - Mcl_Init
                Initialize the flexio and emios common.
        - Pwm_Init, Mcl_Emios_SetCounterBusPeriod, Pwm_SetDutyCycle
                Initialize the Pwm driver, change the period and duty cycle to control the led brightness and blink LED.
2. Installation steps
    2.1 Hardware installation
        2.1.1 Supported boards
            - S32K3X4EVB-Q257 47827 PCB RevX1 SCH RevA.
            - S32K3X4EVB-Q172 51972 PCB RevA SCH RevA
        2.1.2 Connections
            PTA29(EMIOS_1_CH_12) will control the LED(RGBLED0_RED) with the edge aligned mode, control the led brightness and blink this Led.
            PTB16(EMIOS_0_CH_4) will control the output with the center aligned mode.
        2.1.3 Debugger
            The debugger must be connected to J365 20-pin JTAG Cortex Debug connector.
    2.2 Software installation
        2.2.1 Tresos Project Installation
            The following procedure requires that the user has EB Tresos Studio installed and it is only needed for viewing, updating and generating the driver's configuration.
            Procedure:
                1. Make sure that all RTD plugins are already installed in the Tresos Studio plugins directory
                2. Open Tresos Studio
                3. Import example application project
                    a. Click on "File" and select "Import"
                    b. Select "Existing Projects into Workspace" and click on "Next" button
                    c. Select "Select root directory" and click on "Browse"
                    d. Select the location of the [project] folder in the installed example application package folder
                    e. Optional* - Select "Copy projects into workspace"
                    f. Click on "Finish" button
        2.2.2 Example configuration
            The following procedure requires that the user has EB Tresos Studio installed and the toolchains versions specified in the Release Notes.
            The toolchain that will be used needs to be installed for correct operation and the path to the installation location shall be added into the system environment variable(s):
            - TRESOS_DIR the installation path of Electrobit Tresos (used for generating the project from command line)
                Ex: TRESOS_DIR = C:/EB/tresos29.0.0
            - GCC_DIR The path to the GCC installation directory
                Ex: GCC_DIR = C:/gcc-10.2.0-arm32-eabi
            - PLUGINS_DIR The path to the RTD plugins directory
                Ex: PLUGINS_DIR = C:/NXP/SW32_RTD/eclipse/plugins
            Procedure:
                1. Open project_parameters.mk file in a text editor and update the variables mentioned above with the correct paths
3. Building the example application
    3.1 Generating the Tresos project
        Procedure:
            1. Open the Windows command prompt window
            2. Change the current directory to the example application folder
            3. To generate the Tresos project of the example, execute the following command to build: make generate
            4. The output files of the generation shall be generated in the /generate subdirectory
    3.2 Compiling the application
        Procedure:
            1. Open the Windows command prompt window
            2. Change the current directory to the example application folder
            3. To build the example, execute the following command to build: make build
            4. The object files and linker output file (main.elf) shall be generated in the /out subdirectory
    3.3 Running the application on the board
        To execute the example application from your command line execute : make run.
        For executing the script in a T32 window already open the paths from run.cmm need to be changed relative to the debug folder instead of the example root folder.
    3.4 Modifying the configuration in Tresos and generating the code
        Users may change the application configuration according to their needs.
        Procedure:
            1. Open the EB Tresos Studio GUI
            2. Open previously imported Example Application project
            3. Use the Tresos Studio GUI to modify configuration parameter values and save the changes.
            4. Select the Example Application project and click on "Generate" button to generate the configuration files.