R20UT3654EJ0102-AUTOSARs

AUTOSAR MCAL R4.0.3
User's Manual

PORT Driver Component Ver.1.0.4

Generation Tool User's Manual

Target Device:
RH850/P1x-C

All information contained in these materials, including products and product specifications,
represents information on the product at the time of publication and is subject to change by
Renesas Electronics Corp. without notice. Please review the latest information published by
Renesas Electronics Corp. through various means, including the Renesas Electronics Corp.
website (http://www.renesas.com).

www.renesas.com
Rev.1.02 Jun 2017

Notice
1.
Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation of semiconductor
products and application examples. You are fully responsible for the incorporation or any other use of the circuits, software, and information in
the design of your product or system. Renesas Electronics disclaims any and all liability for any losses and damages incurred by you or third
parties arising from the use of these circuits, software, or information.
2.
Renesas Electronics hereby expressly disclaims any warranties against and liability for infringement or any other disputes involving patents,
copyrights, or other intellectual property rights of third parties, by or arising from the use of Renesas Electronics products or technical information
described in this document, including but not limited to, the product data, drawing, chart, program, algorithm, application examples.
3.
No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights of Renesas
Electronics or others.
4.
You shall not alter, modify, copy, or otherwise misappropriate any Renesas Electronics product, whether in whole or in part. Renesas Electronics
disclaims any and all liability for any losses or damages incurred by you or third parties arising from such alteration, modification, copy or
otherwise misappropriation of Renesas Electronics products.
5.
Renesas Electronics products are classified according to the following two quality grades: "Standard" and "High Quality". The intended
applications for each Renesas Electronics product depends on the product’s quality grade, as indicated below.
"Standard":          Computers; office equipment; communications equipment; test and measurement equipment; audio and visual equipment;
home electronic appliances; machine tools; personal electronic equipment; and industrial robots etc.
"High Quality":   Transportation equipment (automobiles, trains, ships, etc.); traffic control (traffic lights); large-scale communication
equipment; key financial terminal systems; safety control equipment; etc.
Renesas Electronics products are neither intended nor authorized for use in products or systems that may pose a direct threat to human life or
bodily injury (artificial life support devices or systems, surgical implantations etc.), or may cause serious property damages (space and undersea
repeaters; nuclear power control systems; aircraft control systems; key plant systems; military equipment; etc.). Renesas Electronics disclaims any
and all liability for any damages or losses incurred by you or third parties arising from the use of any Renesas Electronics product for which the
product is not intended by Renesas Electronics.
6.
When using the Renesas Electronics products, refer to the latest product information (data sheets, user’s manuals, application notes, "General
Notes for Handling and Using Semiconductor Devices" in the reliability handbook, etc.), and ensure that usage conditions are within the ranges
specified by Renesas Electronics with respect to maximum ratings, operating power supply voltage range, heat radiation characteristics,
installation, etc. Renesas Electronics disclaims any and all liability for any malfunctions or failure or accident arising out of the use of Renesas
Electronics products beyond such specified ranges.
7.
Although Renesas Electronics endeavors to improve the quality and reliability of Renesas Electronics products, semiconductor products have
specific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions. Further, Renesas
Electronics products are not subject to radiation resistance design. Please ensure to implement safety measures to guard them against the
possibility of bodily injury, injury or damage caused by fire, and social damage in the event of failure or malfunction of Renesas Electronics
products, such as safety design for hardware and software including but not limited to redundancy, fire control and malfunction prevention,
appropriate treatment for aging degradation or any other appropriate measures by your own responsibility as warranty for your products/system.
Because the evaluation of microcomputer software alone is very difficult and not practical, please evaluate the safety of the final products or
systems manufactured by you.
8.
Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibility of each Renesas
Electronics product. Please investigate applicable laws and regulations that regulate the inclusion or use of controlled substances, including
without limitation, the EU RoHS Directive carefully and sufficiently and use Renesas Electronics products in compliance with all these applicable
laws and regulations. Renesas Electronics disclaims any and all liability for damages or losses occurring as a result of your noncompliance with
applicable laws and regulations.
9.
Renesas Electronics products and technologies shall not be used for or incorporated into any products or systems whose manufacture, use, or sale
is prohibited under any applicable domestic or foreign laws or regulations. You shall not use Renesas Electronics products or technologies for (1)
any purpose relating to the development, design, manufacture, use, stockpiling, etc., of weapons of mass destruction, such as nuclear weapons,
chemical weapons, or biological weapons, or missiles (including unmanned aerial vehicles (UAVs)) for delivering such weapons, (2) any purpose
relating to the development, design, manufacture, or use of conventional weapons, or (3) any other purpose of disturbing international peace and
security, and you shall not sell, export, lease, transfer, or release Renesas Electronics products or technologies to any third party whether directly
or indirectly with knowledge or reason to know that the third party or any other party will engage in the activities described above. When
exporting, selling, transferring, etc., Renesas Electronics products or technologies, you shall comply with any applicable export control laws and
regulations promulgated and administered by the governments of the countries asserting jurisdiction over the parties or transactions.
10.  Please acknowledge and agree that you shall bear all the losses and damages which are incurred from the misuse or violation of the terms and
conditions described in this document, including this notice, and hold Renesas Electronics harmless, if such misuse or violation results from your
resale or making Renesas Electronics products available any third party.
11.  This document shall not be reprinted, reproduced or duplicated in any form, in whole or in part, without prior written consent of Renesas
Electronics.
12.  Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this document or Renesas
Electronics products.

(Note 1)   "Renesas Electronics" as used in this document means Renesas Electronics Corporation and also includes its majority-owned
subsidiaries.
(Note 2)   "Renesas Electronics product(s)" means any product developed or manufactured by or for Renesas Electronics.

3

Abbreviations and Acronyms

Abbreviation / Acronym
Description
AUTOSAR
AUTomotive Open System ARchitecture
BSWMDT
Basic Software Module Description Template
ECU
Electronic Control Unit
ICU
Input Capture Unit
Id/ID
Identifier
INTP
Interrupt
MCAL
Micro Controller Abstraction Layer
NMI
Non Maskable Interrupt
XML
eXtensible Mark-up Language

Definitions

Terminology
Description
BSWMDT File
This file is the template for the Basic Software Module Description.
Configuration XML File
This file contains the setting of command line options.
ECU Configuration Description
Input file to MCAL Code Generator Tool. It is generated by ECU
File
Configuration Editor.
Sl.No
Serial Number.
5

Introduction
Chapter 1

Chapter 1 Introduction

The PORT Driver component provides the service for initializing the whole
PORT structure of the microcontroller.

The PORT Driver Component comprises of two sections as Embedded
Software and the MCAL Code Generator Tool to achieve scalability and
configurability.

The document describes the PORT module specific inputs and outputs of the
MCAL Code Generator Tool that is the common code generator engine used
for the generation of the configuration code for all MCAL modules. MCAL
Code Generator Tool is a command line tool that extracts information from
ECU Configuration Description File, BSWMDT File and generates PORT
Driver C Source and C Header files (Port_PBcfg.c and Port_Cfg.h,
Port_Cbk.h, Port_Hardware.c and Port_Hardware.h).

This document contains information on the options, input and output files of the
MCAL Code Generator Tool. In addition, this manual covers a step-by-step
procedure for the usage of MCAL Code Generator Tool.

ECU Configuration Description File contains information about PORT General
Configuration, Port Pin Configurations.

1.1
Document Overview

This user manual is organized as given in the table below:

Table 1-1 Document Overview
Section
Contents
Section 1 (Introduction)
Provides an introduction to the document and explains how information
is organized in this manual.
Section 2 (Reference)
Provides a list of documents referred while developing this document.
Section 3 (Code Generation
Provides the Code Generation Overview.
Overview)
Section 4 (Input Files)
Provides information about ECU Configuration Description File.
Section 5 (Output Files)
Explains the output files that are generated by MCAL Code Generator
Tool.
Section 6 (Precautions)
Contains precautions to be taken during configuration of ECU
Configuration Description File.
Section 7 (User Configuration
Describes about user configuration validation done by the MCAL Code
Validation)
Generator Tool.
Section 8 (Configuration
Provides Container Overview.
Overview)
Section 9 (Messages)
Describes all the Error/Warning/Information messages of R4.0.3 which
helps the user to understand the probable reason for the same.
9

Chapter 1 Introduction

10

Reference
Chapter 2

Chapter 2
Reference

2.1
Reference Documents

The following table lists the documents referred to develop this document:

Table 2-1 Reference Documents

Sl.No. Title
Version
1.
AUTOSAR_SWS_PortDriver.pdf
3.2.0
2.
MCAL_CodeGenerator_Tool_UserManual.pdf
1.7
3.
R20UT3828EJ0101-AUTOSAR.pdf
1.0.3

2.2
Trademark Notice

Microsoft and Windows are trademarks/registered trademarks of Microsoft
Corporation.
11

Chapter 2
Reference

12

Code Generation Overview
Chapter 3

Chapter 3
Code Generation Overview

Code Generation overview is shown below.



ECU Configuration

Description File and

BSWMDT File
Port_Cfg.h,

MCAL
Port_Cbk.h,

Port_Hardware.h,
Generator

Velocity template files
Port_PBcfg.c,

for PORT

Port_Hardware.c

Configuration XML File

     Figure 3-1
Overview of Code Generation

  ECU Configuration Description File (.arxml):
This file will contain PORT Driver specific configuration information.
This file should be generated by AUTOSAR specified Configuration
Editor.

  BSWMDT File (.arxml):
MCAL Code Generator Tool uses “Common Published Information”
from PORT module specific BSWMDT File. PORT module specific
BSWMDT File should not be updated manually since it is “Static
Configuration” file.

  Velocity template files:
Port_PBcfg_c.vm, Port_Cbk_h.vm, Port_Cfg_h.vm,
Port_Hardware_h.vm, Port_Hardware_c.vm, Port_Validate.vm
They are interpreted by the MCAL Code Generator Tool in order to
provide user input validation and generate the final output file
needed by the AUTOSAR configuration chain .They are the "logic"
of the Code Generator.

  Configuration XML File (.xml):
This file is used to specify which velocity template to use and their
location and the name of the output file generated

For the error free input file, the MCAL Code Generator Tool generates the
following output files: Port_Cfg.h, Port_Cbk.h, Port_Hardware.h, Port_PBcfg.c
and Port_Hardware.c and displays appropriate context sensitive error
messages for wrong input and exits.

13

Chapter 3                                                                                                Code Generation Overview

ECU Configuration Description File can be created or edited using ECU
Configuration Editor.

Concept of execution MCAL Code Generator Tool is
as follows:

Generation start

Common
Validate.vm
Helper.vm

config.xml

ECU Configuration

Description Files
MCAL Code
Template files(.vm)

And BSWMDT file
Generator Tool

(.arxml)

No
Yes
Validation

successful

Display Error
Generate Output Files

  Generation stop

                   Figure 3-2
Flow-Diagram of Code Generation

The module “Validate” will validate the configuration (contents of ECU
Configuration Description File(s) as input). If there are incorrect values or
incorrect dependencies, the MCAL Code Generator Tool l will display error,
warning and information messages. In case of errors, the MCAL Code
Generator Tool will abort the execution.
Port_Cfg_h.vm / Port_PBcfg_c.vm will generate compiler switch / structures
necessary to the AUTOSAR Configuration chain and vendor specific
parameters.
Port_Cbk_h.vm will generate Prototype Declarations for Port Callback
Notification Functions.
Port_Hardware_h.vm / Port_Hardware_c.vm will generate hardware related
info (defines number of actual instances / channels used / structure to access
to the I/O mapped peripheral).

Remark   Please refer the general MCAL Code Generator Tool User Manual
          (MCAL_CodeGenerator_Tool_UserManual.pdf) and
14

Code Generation Overview
Chapter 3

          GettingStarted_MCAL_Drivers_X1x.pdf
             (R20UT3828EJ0101-AUTOSAR.pdf)
          for details about the tool command line options.

15

Chapter 3 Code Generation Overview

16

Input Files
Chapter 4

Chapter 4
Input Files

MCAL Code Generator Tool will accept the config.xml file which has paths to
the code generator template files for generating PORT Driver files. MCAL
Code Generator Tool accepts ECU Configuration Description File(s), PORT
Configuration XML file and BSWMDT File as input. MCAL Code Generator
Tool needs information about PORT Driver component. Hence ECU
Configuration Description File should contain configuration of PORT Driver
component. MCAL Code Generator Tool ignores any other AUTOSAR
component configured in the ECU Configuration Description File. ECU
Configuration Description File can be generated using configuration editor.

ECU Configuration Description File must comply with AUTOSAR standard
ECU Configuration Description File format.

Remark The detailed explanation about the parameters and containers are found in
Parameter Definition File.
17

Chapter 4

Input Files

18

Output Files
Chapter 5

Chapter 5
Output Files

MCAL Code Generator Tool generates configuration details in C Header and
C Source files (Port_Cfg.h, Port_Cbk.h, Port_PBcfg.c, Port_Hardware.c and
Port_Hardware.h).

The content of each output file is given in the table below:

Table 5-1  Output Files Description

Output File
Details
Port_Cfg.h
This file contains the macro definitions for general configuration, total number of Port
Pins configured and configuration set handles. This file also includes the Port Pin
handles for each configuration set.
Port_Cbk.h
This file contains Prototype Declarations for Port callback Notification Functions.
Port_PBcfg.c
This file contains structure for Port Pin Initialization, Port Pin Direction Switch and Port
Pin Direction Refresh during runtime.
Port_Hardware.c  This file contains the definitions for addresses of the hardware registers used
in the PORT Driver Module.
Port_Hardware.h  This file contains the declarations for addresses of the hardware registers
used in the PORT Driver Module.

Remark  Output files generated by MCAL Code Generator Tool shall not be modified or
edited manually.
19

Chapter 5 Output Files

20

Precautions
Chapter 6

Chapter 6
Precautions

•  ECU Configuration Description File and BSWMDT File must comply with
AUTOSAR standard for R4.0.3 ECU Configuration Description File and
BSWMDT File respectively.

•  ECU Configuration Description File must contain PORT module description
files.

•  Configuration XML File should contain the file extension ‘.xml’.

•  Configuration XML File (config.xml file) should convey the Velocity template
files location and output file location.

•  All the function names and the string values configured should follow C
syntax for variables. It can only contain alphanumeric characters and “_”. It
should start with an alphabet.

•  If the output files generated by MCAL Code Generator Tool are modified
externally, then they may not produce the expected results or may lead to
error/warning/Information messages.

•  Short Name for a container should be unique within a name space.

•  An error free ECU Configuration Description File generated from
configuration editor has to be provided as input to the MCAL Code Generator
Tool. Otherwise MCAL Code Generator Tool may not produce the expected
results or may lead to “errors/warnings/information messages”.

•  If no configuration of certain port filter is done within this Port Module, the
device specific default settings will take effect on this filter.

•  If user selects the alternate signal in the port group container, then the
respective port filter container should be configured. For example: If signal
NMI is selected in the port group container respective filter group container
has to be configured.

•  In case of multiple configuration sets, if any filter is configured in one
configuration set, then the same filter should be configured across all
configured multiple configuration sets.

•  In post-build time, sub containers of PortFilterGroupConfig containers
should not be added or deleted.

•  Edge/Level settings for External Interrupt (INTP) signals can be overwritten
by ICU component to change the default activation type and the type of
activation at run-time.

Remark      Please refer the PORT Component User Manual (R20UT3653EJ0102-
  AUTOSAR.pdf) for deviations from AUTOSAR.

21

Chapter 6

Precautions

22

User Configuration Validation
Chapter 7


Chapter 7
User Configuration Validation

This section provides help to analyze the error, warning and information
messages displayed during the execution of MCAL Code Generator Tool. It
ensures conformance of input file with syntax and semantics. It also performs
validation on the input file for correctness of the data.

For more details on list of Error/Warning/Information messages that are
displayed as a result of input file(s) validation, refer Chapter 9 “Messages”.

MCAL Code Generator Tool displays error or warning or information
messages when the user has configured incorrect inputs. The format of
Error/Warning/ Information message is as shown below.

<message_type>_<vendor_id>_<module_id>_<message_id>:<message_cont
ent>.
where,
  <message_type> : ERR/WARNING/INFO

  < vendor_id >          : vendor Id = 59

  < module_id >          : 124 - PORT Driver Module id (124) for user
               configuration checks.

  < Message_id.>      :  001-999

  <message_content>: Message content provides information
                about error or warning or information displayed
                      when the user has configured incorrect inputs.

                                                               File Name’ and ‘Path’ need not be present for all
                                          Error/Warning/Information messages

                File Name: Name of the file in which the error has
                occurred

                Path: Absolute path of the container in which the
                parameter is present

23

Chapter7

User Configuration Validation

24

       Configuration Overview                                                                                                     Ch apter 8

Chapter 8  Configuration Overview

8.1
Container Overview
The following figure represents container overview.

                                                                      Port

PortGeneral
PortDemEventParameterRef

s

PortConfigSet

PortPinx
PortGroup0

PortFilterGroupConfig
PortContainer
x= 0 to 14

PortGroup1

PortPinx
PortPin

x= 0 to 7

PortPinx

PortGroup2
x= 0 to 15

PortAnalogFilterGroupx
PortDigitalFilterGroupx

x= 0 to 12
x=0 to 5
PortPinx
PortGroup3
X=

x= 0 to 14

PortPinx
PortGroup4

x= 0 to 14

PortPinx
PortGroup5

x= 0 to 14

PortPinx

PortGroup6

x= 0 to 15

PortPinx

PortGroup7
x= 0 to 9
Figure 8-1  Configuration Overview

PortPinx
PortGroup8
x= 0 to 15

PortPinx
PortGroup9
x= 0 to 8

PortGroupJtag0
PortPinx
x= 0 to 5

25

Chapter 8                                                                                                      Configuration Overview
8.1.1
Pre-Compile Configurable Parameters
Table 8-1
Pre-Compile Configurable Parameters

Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

PortGeneral
PortDevErrorDetect
Boolean
TRUE / FALSE
Switches the Development
Error Detection and

Notification on or off.
True: Development Error
Detection and Notification is
enabled.
False: Development Error
Detection and Notification is
disabled.

PortSetPinDirectionApi
Boolean
TRUE / FALSE
Pre-processor switch to enable
/ disable the use of the
function
Port_SetPinDirection().
True: Enabled - Function
Port_SetPinDirection () is
available.
False: Disabled - Function
Port_SetPinDirection () is not
available.

PortSetPinDefaultDire
Boolean
TRUE / FALSE
Pre-processor switch to enable
ctionApi
/ disable the use of the
function
Port_SetPinDefaultDirection
().
True: Enabled - Function
Port_SetPinDefaultDirection ()
is available.
False: Disabled - Function
Port_SetPinDefaultDirection ()
is not available.

Pre-processor switch to enable
PortSetPinModeApi
Boolean
TRUE / FALSE
/ disable the use of the
function Port_SetPinMode ().
True: Enabled - Function
Port_SetPinMode () is
available.
False: Disabled - Function
Port_SetPinMode() is not
available.

Pre-processor switch to
PortSetPinDefaultMod
Boolean
TRUE / FALSE
enable / disable the use of the
eApi
function
PortSetPinDefaultModeApi ().
True: Enabled–Function
PortSetPinDefaultModeApi ()
is available.
False: Disabled - Function
PortSetPinDefaultModeApi ()
is not available.
26

       Configuration Overview                                                                                                     Ch apter 8

Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

Pre-processor switch to enable
PortVersionInfoApi
Boolean
TRUE / FALSE
/ disable the API to read out
the modules version
information.
PortVersionInfoApTrue:
Version info API enabled
False: Version info API
disabled.

PortDevErrorDetect
Boolean
TRUE / FALSE
Switches the Development
Error Detection and
Notification on or off.
True: Development Error
Detection and Notification is
enabled.
False: Development Error
Detection and Notification is
disabled.

PortCriticalSectionProt
Boolean
TRUE / FALSE
This parameter specifies if the
ection
PORT driver CPU load can be
reduced by disabling the
enter/exit critical section
functionality by adding a
precompiled configuration
parameter to the PORT driver
configuration.
True: Enables the critical
section functionality for the
restricted area.
False: Disables the critical
section functionality for the
restricted area.

PortMaxMode
Integer
6
This parameter indicates
maximum Alternative modes
present in a Port Module.

Pre-processor switch to enable
PortSetToDioAltMode
Boolean
TRUE / FALSE
/ disable the use of the
Api
function Port_SetToDioMode
() and
Port_SetToAlternateMode ().
True: Enabled - Function
Port_SetToDioMode () and
Port_SetToAlternateMode () is
available.
False: Disabled - Function
Port_SetToDioMode () and
Port_SetToAlternateMode () is
not available.

Enable / disable AUTOSAR
PortVersionCheckExte
Boolean
TRUE / FALSE
Version check for inter-module
rnalModules
dependencies.
True: AUTOSAR Version
check for inter-module
dependencies is enabled.
false: AUTOSAR Version
check for inter-module
dependencies is disabled
27

Chapter 8                                                                                                      Configuration Overview
Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

This parameter contains the
PortDeviceName
Integer
RF701370A,
supported device name to
RF701371,
identify the device specific C
RF701372,
header file through ARXML
RF701373,
File.
RF701374.
8.1.2
Post Build Time Configurable Parameters
Table 8-2  Post Build Time Configurable Parameters

Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

Parameter to indicate if the
PortPinDirectionChang
Boolean
TRUE /

direction is changeable on a port
eable
FALSE

pin during runtime.

True: Port Pin direction

changeable enabled.

False: Port Pin direction

changeable disabled.

PortConfigS
Parameter to indicate if the mode
et/PortGrou
PortPinDioAltModeCha
Boolean
TRUE /
of a port pin is changeable
p
ngeable
FALSE
between DIO and Alternate during
runtime by API functions
Port_SetToDioMode and
Port_SetToAlternateMode.
Including these APIs is controlled
by PortSetToDioAltModeApi.
True: Dio Alternate mode is
changeable.
False: Dio Alternate mode is not
changeable.

PortPinModeChangeab
Boolean
TRUE /
Parameter to indicate if the mode
le
FALSE
of a port pin is changeable during
runtime by API function
Port_SetPinMode. Including this
API is controlled by
PortSetPinModeApi.
True: Port Pin mode is
changeable.
False: Port Pin mode is not
changeable.

Parameter to indicate port pin
PortPinLevelValue
Enumeration
PORT_PIN_L
level value for a port pin.
EVEL_LOW /
PORT_PIN_LEVEL_LOW: Port
PORT_PIN_L
pin Level is low.
EVEL_HIGH
PORT_PIN_LEVEL_HIGH: Port
pin Level is high.
28

       Configuration Overview                                                                                                     Ch apter 8

Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

Mode of the port pin for use with
PortPinInitialMode
Enumeration
DIO
Port_Init() function.
ALT1_IN
<Input name>_ALT<Alternative
instance>_IN: Provides alternative
ALT1_OUT
instance for selected input.
ALT2_IN
<Output name>_ALT<Alternative
instance>_OUT: Provides
ALT2_OUT
alternative instance for selected
output.
ALT3_IN
ALT3_OUT
ALT4_IN
ALT4_OUT

PortPinDirection
Enumeration
PORT_PIN_O
The initial direction of the pin (IN
UT /
or OUT). If the direction is not
PORT_PIN_I
changeable, the value configured
N
here is fixed. The direction must
match the pin mode.
PORT_PIN_IN: Port pin direction
set as input.
PORT_PIN_OUT: Port pin
direction set as output.

PortInputBufferControl
Boolean
This parameter is used as one of
TRUE /

the factors to enable/disable port
FALSE

pins input buffer in DIO Mode

(PMC=0).

True: Port pin's input buffer is

ready to be enabled in DIO Mode.

False: Port pin's input buffer is

disabled in DIO Mode.

PortBiDirectionControl
Boolean
This parameter forces port pins

TRUE /
input buffer and output buffer at

FALSE
the same time. If activated, the

effect is valid independently from

any other port settings.

True: Activate forced Bi-

directional IO buffer of the port

pin.

False: Deactivate forced Bi-

directional IO buffer of the port

pin.

PortIpControl
Boolean
This parameter is used to

TRUE /
enable/disable the direct IO

FALSE
control of port pins input buffer

and output buffer.

true: Enables the direct IO control

of port pins input buffer and output

buffer by the corresponding

control signals of IP_ENI3(0) and

IP_ENO3(0) from internal

peripheral IPs. This register is

valid only in Control Mode
PortConfigS
(PMC=1).
et/PortGrou
False: Disables the direct IO
p
control of port pins input buffer
and output buffer.
29

Chapter 8                                                                                                      Configuration Overview
Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

PortPullUpOption
Boolean
This register switches on or off the
TRUE /
port pins pull-up resistor.
FALSE
True: Port pin's pull-up resistor is
enabled.
False: Port pin's pull-up resistor is
disabled.

PortPullDownOption
Boolean
This parameter switches on or off
TRUE /
the port pins pull-down resistor.
FALSE
True: Port pin's pull-down resistor
is enabled.
False: Port pin's pull-down
resistor is disabled.

PortOpenDrainControl
Boolean
This parameter selects port pins
TRUE /
output buffer function as push-pull
FALSE
type or open drain type.
True: Port pin's output buffer
operates as open drain driver.
false: Port pin's output buffer
operates as push-pull driver

This parameter selects port pins
PortOpenDrainControlE
Boolean
TRUE /
output buffer function as emulated
xpansion
FALSE
P-ch open drain type or emulated
N-ch open drain type.
True: Port pin's output buffer
operates as emulated P-Channel
open drain driver.
false: Port pin's output buffer
operates as emulated N-Channel
open drain drive

TRUE /

FALSE
Parameter to indicate if the mode
PortOutputLevelInversi
Boolean

of a port pin is changeable
on

between DIO and Alternate during

runtime by API functions

Port_SetToDioMode and

Port_SetToAlternateMode.

Including these APIs is controlled

by PortSetToDioAltModeApi.

True: Dio Alternate mode is

changeable.

False: Dio Alternate mode is not

changeable.

PortDriveStrengthContr
Enumeration
SLOW / FAST
Parameter to indicate if the mode

ol
of a port pin is changeable during

runtime by API function

Port_SetPinMode. Including this

API is controlled by

PortSetPinModeApi.

True: Port Pin mode is

changeable.

False: Port Pin mode is not
PortConfigS
changeable.
et/PortGrou
p
30

       Configuration Overview                                                                                                     Ch apter 8

Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

PortUniversalCharacter
Boolean
This parameter selects the port
TRUE /
isticCntrl
pins output drive strength as high
FALSE
or low type.
The PortDriveStrengthControl
must be enabled for this feature.
False: PortDriveStrengthControl
parameter specifies the output
driver strength of the port pin.
true : Number of output buffer
characteristics selection capability
is expanded,
the maximum of 4 characteristics
selection is possible
PUCCn     PDSCn
0         0       Output characteristic
selection 1 (400 Ohm buffer)
0         1       Output characteristic
selection 2 (200 Ohm buffer)
1         0       Output characteristic
selection 3 (100 Ohm buffer)
1         1       Output characteristic
selection 4 (50 Ohm buffer)

PortInputBufferSelectio
Enumeration
TYPE1_SHM
This setting specifies the input
n
T1
buffer characteristics.
TYPE2_SHM
TYPE1_SHMT1: TYPE 1 buffer is
T4
selected.
TYPE3_TTL
TYPE2_SHMT4: TYPE 2 buffer is
selected.
TYPE3_TTL: TYPE 3 buffer is
selected.

PortFilterGr
This parameter enables/disables
PortAnalogFilterBypass
Boolean
TRUE /
oupConfig/
bypass control.
FALSE
PortAnalog
FilterGroup

FALLING_ED
This parameter specifies the
PortEdgeOrLevelContr
Enumeration
GE_FCLA<In
mode selection.
ol
stance>_CTL
<Instance>
RISING_EDG
E_FCLA<Inst
ance>_CTL<I
nstance>
HIGH_LEVEL
_FCLA<Instan
ce>_CTL<Inst
ance>
LOW_LEVEL
_FCLA<Instan
ce>_CTL<Inst
ance>
BOTH_EDGE
S_FCLA<Inst
ance>_CTL<I
nstance>
BOTH_EDGE
S_DISABLED
31

Chapter 8                                                                                                      Configuration Overview
Container
Parameter Name
Parameter
Parameter
Parameter Description
Name
Type
Range

This parameter specifies the
PortSameLevelSample
Boolean
TRUE /

number of same level samples,
s
FALSE

i.e. the number of samples with

the same level to judge an

external signal pulse as valid.

This parameter specifies the

PortSamplingClockFreq
Enumeration
TRUE /
Digital filter sampling clock

uency
FALSE
frequency.

FIXED_LOW_
This parameter enables/disables

PortDigitalFilterEnableI
Enumeration
LEVEL
PortDigitalFilterEnableInput for

nput0 to n
BYPASSED_
the signal.

CTL<Instance

>

Instance

varies as

FCLAmCTLn

DISABLED
This parameter enables/disables
PortFilterGr
PortDigitalFilterEdgeCo
Enumeration
RISING_FCL
PortDigitalFilterEdgeControl for
oupConfig/
ntrol0 to n
A<Instance>_
the signal.
PortDigitalFi
CTL<Instance
lterGroup
>
FALLING_FC
LA<Instance>
_CTL<Instanc
e>
BOTH_EDGE
S_FCLA<Inst
ance>_CTL<I
nstance>

Instance
varies as
FCLAmCTLn

BYPASS_EN
This parameter enables/disables
PortDigitalFilterBypass
Enumeration
ABLED:
bypass control.
0 to n
Bypass
functionality
enabled.
DISABLED:
Bypass
functionality
disabled

32

Configuration Overview Ch apter 8

Table 8-3 Port Modes Description

Sl.No
Modes

Sl.No
Modes
GTM0I6_ALT1_IN
GTMAT1O0_ALT1_OUT
1
201
2
GTMAT0O2_ALT1_OUT
202
CSIH1RYI_ALT2_IN
3
SENT0RX_ALT3_IN
203
CSIH1RYO_ALT2_OUT
4
CSIH0CSS1_ALT3_OUT
204
SENT4RX_ALT3_IN
5
CSIH0CSS5_ALT4_OUT
205
MCAN0RX_ALT4_IN
6
GTM0I3_ALT1_IN
206
GTMAT0O4_ALT1_OUT
7
GTMAT0O3N_ALT1_OUT
207
MCAN0TX_ALT4_OUT
8
SENT1RX_ALT3_IN
208
GTMAT0O5_ALT1_OUT
9
CSIH1CSS6_ALT3_OUT
209
INTP4_ALT2_IN
10
CSIH0CSS6_ALT4_OUT
210
CSIH3CSS0_ALT2_OUT
11
GTM0I2_ALT1_IN
211
CSIH1SI_ALT3_IN
12
GTMAT1O1_ALT1_OUT
212
HSURT0SDIO0I_ALT4_IN
13
CSIH0CSS4_ALT3_OUT
213
HSURT0SDIO0O_ALT4_OUT
14
CSIH2CSS2_ALT2_OUT
214
GTM0I5_ALT1_IN
15
GTMAT0O0_ALT1_OUT
215
CSIH3SCI_ALT2_IN
16
CSIH0CSS3_ALT3_OUT
216
CSIH3SCO_ALT2_OUT
17
CSIH2CSS4_ALT2_OUT
217
CSIH1DCS_ALT3_IN
18
GTM1I0_ALT1_IN
218
CSIH1SO_ALT3_OUT
19
GTM1I0_ALT1_IN
219
HSURT0SDIO1I_ALT4_IN
20
GTM1I0_ALT1_IN
220
HSURT0SDIO1O_ALT4_OUT
21
CSIH1CSS2_ALT3_OUT
221
GTM0I4_ALT1_IN
22
CSIH2CSS5_ALT2_OUT
222
GTMAT0O3_ALT1_OUT
23
GTM1I0_ALT1_IN
223
CSIH3SI_ALT2_IN
24
GTMAT1O0_ALT1_OUT
224
HSURT0SDIO2I_ALT4_IN
25
INTP3_ALT2_IN
225
HSURT0SDIO2O_ALT4_OUT
26
CSIH1CSS1_ALT4_OUT
226
GTM0I0_ALT1_IN
27
CSIH2CSS6_ALT2_OUT
227
GTMAT1O3_ALT1_OUT
28
CSIH2CSS7_ALT2_OUT
228
CSIH3DCS_ALT2_IN
29
CSIH1CSS0_ALT4_OUT
229
CSIH3SO_ALT2_OUT
30
MCAN1RX_ALT2_IN
230
HSURT0SDIO3I_ALT4_IN
33

Chapter 8 Configuration Overview
Sl.No
Modes

Sl.No
Modes
31
CSIH0SI_ALT3_IN

231
HSURT0SDIO3O_ALT4_OUT
32
CSIH1DCS_ALT4_IN
232
GTM1I6_ALT1_IN
33
CSIH1SCO_ALT4_OUT
233
GTMAT2O4_ALT1_OUT
MCAN1TX_ALT2_OUT
234
CSIH3CSS1_ALT2_OUT
34
35
CSIH0SCI_ALT3_IN
235
GTMAT1O4_ALT1_OUT
36
CSIH1SC1_ALT4_IN
236
CSIH3CSS2_ALT2_OUT
37
CSIH0DCS_ALT3_IN
237
ESO2_BAR_ALT3_IN
38
CSIH0SO_ALT3_OUT
238
CSIH1CSS7_ALT3_OUT
39
EXTCLK1O_ALT2_OUT
239
GTM1I4_ALT1_IN
40
CSIH1SI_ALT4_IN
240
GTMAT1O5_ALT1_OUT
41
241
CSIH3CSS3_ALT2_OUT
RLIN30TX_ALT1_OUT
42
242
GTMAT0O1N_ALT1_OUT
INTP5_ALT2_IN
43
243
CSIH1CSS0_ALT2_OUT
CSIH0CSS2_ALT2_OUT
44
244
CSIH2SCI_ALT3_OUT
MTTCAN0TX_ALT3_OUT
45
245
CSIH2SCO_ALT3_IN
HSURT1SCKI_ALT4_IN
46
246
HSURT0SCKI_ALT4_IN
HSURT1SCKO_ALT4_OUT
47
247
HSURT0SCKO_ALT4_OUT
CSIH0CSS3_ALT2_OUT
48
248
CSIH1CSS2_ALT2_OUT
EXTCLK0O_ALT3_OUT
49
249
CSIH2DCS_ALT3_IN
HSURT1CSO_ALT4_OUT
50
250
CSIH2SO_ALT3_OUT
CSIH0CSS4_ALT2_OUT
51
251
HSURT0CSI_ALT4_IN
RLIN30RX_ALT3_IN
52
252
HSURT0CSO_ALT4_OUT
HSURT1SDIR_ALT4_OUT
53
253
GTMAT0O2N_ALT1_OUT
GTM1I7_ALT1_IN
54
254
GTM0I4_ALT2_IN
CSIH2RYI_ALT2_IN
55
255
CSIH2CSS1_ALT2_OUT
CSIH2RYO_ALT2_OUT
56
256
CSIH1SCI_ALT3_IN
RLIN30TX_ALT3_OUT
57
257
CSIH1SCO_ALT3_OUT
CSIH3CSS3_ALT4_OUT
58
258
CSIH2SCO_ALT3_OUT
GTMAT1O3N_ALT1_OUT
59
259
HSURT0SDIR_ALT4_OUT
CSIH0CSS0_ALT3_OUT
60
260
GTM0I5_ALT2_IN
CSIH0CSS7_ALT4_OUT
61
261
GTMAT0O5_ALT2_OUT
EXTCLK0O_ALT2_OUT
34

Configuration Overview Ch apter 8

Sl.No
Modes

Sl.No
Modes
62

262
CSIH2SI_ALT3_IN
GTMAT0O6_ALT1_OUT
63
263
CSIH0SS0_ALT3_OUT
SENT3SPCO_ALT3_OUT
64
264
HSURT1SDIO0I_ALT4_IN
GTM0I7_ALT1_IN
65
265
HSURT1SDIO0O_ALT4_OUT
GTMAT0O7_ALT1_OUT
66
266
ESO0Z_ALT2_IN
ETH0LINKSTA_ALT2_IN
67
267
RLIN31RX_ALT3_IN
SENT4SPCO_ALT3_OUT
68
268
SENT0SPCO_ALT3_OUT
CSIH3CSS1_ALT3_OUT
69
269
HSURT1SDIO1I_ALT4_IN
FLX0RXDA_ALT4_IN
70
270
HSURT1SDIO1O_ALT4_OUT
ETH0MDI_ALT2_IN
71
271
RLIN31TX_ALT3_OUT
ETH0MDO_ALT2_OUT
72
272
HSURT1SDIO2I_ALT4_IN
CSIH3CSS2_ALT3_OUT
73
273
HSURT1SDIO2O_ALT4_OUT
FLX0RXDB_ALT4_IN
74
274
RLIN30RX_ALT2_IN
GTM1I5_ALT1_IN
75
275
CSIH2CSS3_ALT2_OUT
FLX0STPWT_ALT4_IN
76
276
MTTCAN0RX_ALT3_IN
CSIH1CSS3_ALT3_OUT
77
277
CSIH1SS1_ALT3_OUT
SENT2SPCO_ALT4_OUT
78
278
HSURT1SDIO3I_ALT4_IN
ETH0COL_ALT2_IN
79
279
HSURT1SDIO3O_ALT4_OUT
INTP6_ALT3_IN
80
280
GTM1I2_ALT1_IN
FLX0TXENA_ALT4_OUT
81
ETH0MDC_ALT2_OUT
281
GTM01I0_ALT1_IN
82
282
FLX0TXDB_ALT4_OUT
ETH0WOL_ALT2_OUT
83
283
ETH0CRS_ALT2_IN
SENT1RX_ALT4_IN
84
284
RLIN30TX_ALT2_OUT
BHPDGRCLK1_ALT4_OUT
85
285
CSIH0CSS2_ALT3_OUT
ETH0CLK1O_ALT2_OUT
86
286
FLX0TXDA_ALT4_OUT
CSIH2SSI_BAR_ALT3_IN
87
287
ETH0TXER_ALT2_OUT
CSIH2CSS0_ALT3_OUT
88
288
INTP7_ALT3_IN
CSIH0CSS3_ALT4_OUT
54
254
GTM0I4_ALT2_IN
CSIH2RYI_ALT2_IN
55
255
CSIH2CSS1_ALT2_OUT
CSIH2RYO_ALT2_OUT
56
256
CSIH1SCI_ALT3_IN
RLIN30TX_ALT3_OUT
92
292
CSIH1CSS4_ALT3_OUT
INTP1_ALT2_IN
35

Chapter 8 Configuration Overview
Sl.No
Modes

Sl.No
Modes
93

293
SENT1SPCO_ALT4_OUT
ADTRG1_ALT4_IN
94
294
GTMAT0O1_ALT1_OUT
CSIH1CSS5_ALT4_OUT
95
295
ETH0TXD1_ALT2_OUT
CSIH0CSS5_ALT2_OUT
96
296
CSIH1CSS5_ALT3_OUT
SENT2RX_ALT3_IN
97
297
ETH0TXD2_ALT2_OUT
ESO1Z_ALT4_IN
98
298
SENT2RX_ALT4_IN
CSIH2CSS7_ALT4_OUT
99
299
ETH0TXD3_ALT2_OUT
GTMAT1O0N_ALT1_OUT
100
300
ETH0REF50CK_ALT2_IN
CSIH0CSS6_ALT2_OUT
101
301
SENT3RX_ALT4_IN
SENT3RX_ALT3_IN
102
302
ETH0TXEN_ALT1_OUT
EXTCLK1O_ALT4_OUT
103
303
MCAN0RX_ALT3_IN
CSIH2CSS2_ALT4_OUT
104
304
FLX0RXDA_INTP10_ALT4_IN
CSIH0CSS1_ALT2_IN
105
305
ETH0RXER_ALT2_IN
CSIH2CSS3_ALT4_OUT
106
306
MCAN0TX_ALT3_OUT
CSIH0SSI_BAR_ALT2_IN
107
307
RLIN30TX_ALT4_OUT
CSIH0CSSO0_ALT2_OUT
108
308
ETH0TXCLK_ALT2_IN
ADTRG0_ALT3_IN
109
309
CSIH1SSI_BAR_ALT3_IN
ADCA1CNV_ALT3_OUT
110
310
CSIH1SS0_ALT3_OUT
RLIN31RX_ALT4_IN
111
311
ETH0RXCLK_ALT2_IN
CSIH0DCS_ALT2_IN
112
312
GTMAT0O0N_ALT1_OUT
CSIH0SO_ALT2_OUT
113
313
ETH0RXD0_ALT2_IN
ADCA0CNV_ALT3_OUT
114
314
ETH0RXD1_ALT2_IN
RLIN31TX_ALT4_OUT
115

315
ETH0RXD2_ALT2_IN
CSIH0SCI_ALT2_IN
116
316
RLIN30RX_ALT4_IN
CSIH0CSO_ALT2_OUT
117
317
ETH0RXD3_ALT2_IN
CSIH2DCS_ALT4_IN
118
ETH0RXDV_ALT2_IN

318
CSIH2SO_ALT4_OUT
119
INTP0_ALT3_IN

319
CSIH0SI_ALT2_IN
120
BHPDGRCLK0_ALT4_OUT

320
NMI_ALT3_IN
121
SENT5SPCO_ALT3_OUT

321
GTMAT2O0N_ALT1_OUT
122
322
CSIH2SCI_ALT4_IN
CSIH3SCO_ALT3_OUT
123
323
CSIH2SCO_ALT4_OUT
HSURT3CSI_ALT4_IN
124
324
EXTCLK1O_ALT3_OUT
HSURT3CSO_ALT4_OUT
36

Configuration Overview Ch apter 8

Sl.No
Modes

Sl.No
Modes
125

325
CSIH0RYI_ALT4_IN
GTMAT2O0_ALT1_OUT
126
326
CSIH0RYO_ALT4_OUT
CSIH3CSS0_ALT3_OUT
127
327
MCAN1TX_ALT3_OUT
HSURT3SCKI_ALT4_IN
128
328
CSIH1CSS3_ALT4_OUT
HSURT3SCKO_ALT4_OUT
129
329
MCAN1RX_ALT3_IN
GTMAT1O7_ALT1_OUT
130
330
CSIH2SI_ALT4_IN
HSURT3SDIO3I_ALT4_IN
131
331
CSIH2CSS3_ALT3_OUT
HSURT3SDIO3O_ALT4_OUT
132
332
SENT2RX_ALT2_IN
GTMAT1O6_ALT1_OUT
133
333
INTP2_ALT3_IN
HSURT3SDIO2I_ALT4_IN
134
334
MTTCAN0TX_ALT2_OUT
HSURT3SDIO2O_ALT4_OUT
135
335
CSIH2CSS0_ALT4_OUT
HSURT3SDIO1I_ALT4_IN
136
336
MTTCAN0RX_ALT2_IN
HSURT3SDIO1O_ALT4_OUT
137
337
CSIH0CSS4_ALT4_OUT
HSURT3SDIO0I_ALT4_IN
138
338
CSIH1CSS6_ALT4_OUT
HSURT3SDIO0O_ALT4_OUT
139
339
HSURT2DIR_ALT2_OUT
SENT7RX_ALT3_IN
140
340
CSIH1CSS7_ALT4_OUT
MEMC0A0_ALT3_OUT
141
341
HSURT2CSI_ALT2_IN
CSIH3RYI_ALT4_IN
142
342
HSURT2CSO_ALT2_OUT
CSIH3RYO_ALT4_OUT
143
343
SENT5RX_ALT3_IN
FLX1TXENB_ALT2_OUT
144
344
HSURT2SCKI_ALT2_IN
SENT6RX_ALT3_IN
145
345
HSURT2SCKO_ALT2_OUT
ETH1MDC_ALT3_OUT
146
346
INTP9_ALT3_IN
FLX1RXDB_ALT2_IN
147
347
GTMAT2O3_ALT1_OUT
ETHCOL_ALT3_IN
148
348
HSURT2SDIO3I_ALT2_IN
MEMC0RD_BAR_ALT4_OUT
149
349
HSURT2SDIO3O_ALT2_OUT
FLX1TXDB_ALT3_OUT
150
350
HSURT2SDIO2I_ALT2_IN
ETHLINKSTA_ALT3_IN
151
351
HSURT2SDIO2O_ALT2_OUT
MEMC0WR_BAR_ALT4_OUT
152
352
SENT6SPCO_ALT3_OUT
ETH1RXDV_ALT3_IN
153
353
HSURT2SDIO1I_ALT2_IN
CSIH3CSS7_ALT3_OUT
154
354
HSURT2SDIO1O_ALT2_OUT
RLIN32RX_ALT4_IN
155
355
SENT7SPCO_ALT3_OUT
FLX1TXDA_ALT2_OUT
37

Chapter 8 Configuration Overview
Sl.No
Modes

Sl.No
Modes
156

356
GTMAT2O1N_ALT1_OUT
CSIH3CSS6_ALT3_OUT
157

357
HSURT2SDIO0I_ALT2_IN
RLIN32TX_ALT4_OUT
158
358
HSURT2SDIO0O_ALT2_OUT
FLX1TXENA_ALT2_OUT
159
359
GTMAT2O1_ALT1_OUT
CSIH3CSS5_ALT3_OUT
160
360
HSURT3SDIR_ALT4_OUT
MEMC0CS0_BAR_ALT4_OUT
161
FLX1RXDA_ALT2_IN

361
SENT0RX_ALT4_IN
162
INTP11_ALT3_IN

362
MEMC0D1I_ALT3_IN
163

363
CSIH3CSS4_ALT3_OUT
MEMC0D1O_ALT3_OUT
164

364
MEMC0CS1_BAR_ALT4_OUT
MTTCAN0EVT_ALT4_IN
165

365
ETH1WOL_ALT3_OUT
ETH1TXEN_ALT2_OUT
166

366
MEMC0CS2_BAR_ALT4_OUT
MEMC0D2I_ALT3_IN
167

367
FLX1STPWT_ALT3_IN
MEMC0D2O_ALT3_OUT
168

368
MEMC0CS3_BAR_ALT4_OUT
MTTCAN0SOC_ALT4_OUT
169

369
ETH1RXD3_ALT2_IN
ETH1TXD1_ALT2_OUT
170

370
MEMC0A1_ALT3_OUT
MEMC0D3I_ALT3_IN
171

371
CSIH3DCS_ALT4_IN
MEMC0D3O_ALT3_OUT
172

372
CSIH3SO_ALT4_OUT
MTTCAN0TMP_ALT4_OUT
173

373
ETH1RXD2_ALT2_IN
ETH1TXD2_ALT2_OUT
174

374
MEMC0A2_ALT3_OUT
MEMC0D4I_ALT3_IN
175

375
CSIH3SI_ALT4_IN
MEMC0D4O_ALT3_OUT
176

376
ETH1CRS_ALT2_IN
MTTCAN0RTP_ALT4_OUT
177

377
MEMC0A3_ALT3_OUT
GTMAT2O2_ALT1_OUT
178

378
CSIH3SSI_BAR_ALT4_IN
ETH1TXD3_ALT2_OUT
179

379
CSIH3CSS0_ALT4_OUT
MEMC0D5I_ALT3_IN
180

380
GTMAT2O3N_ALT1_OUT
MEMC0D5O_ALT3_OUT
181

381
ETH1RXER_ALT2_IN
GTMAT2O2N_ALT1_OUT
182

382
MEMC0A4_ALT3_OUT
ETH1TXER_ALT2_OUT
183

383
CSIH3SCI_ALT4_IN
MEMC0D6I_ALT3_IN
184

384
CSIH3SCO_ALT4_OUT
MEMC0D6O_ALT3_OUT
185

385
ETH1RXD1_ALT2_IN
ETH1MD1_ALT2_IN
186

386
MEMC0A5_ALT3_OUT
ETH1MDO_ALT2_OUT
38

Configuration Overview Ch apter 8

Sl.No
Modes

Sl.No
Modes
187

387
GTMT1I4_ALT1_IN
MEMC0D7I_ALT3_IN
188

388
ETH1RXD0_ALT2_IN
MEMC0D7O_ALT3_OUT
189

389
MEMC0A6_ALT3_OUT
SENT8SPCO_ALT4_OUT
190

390
ETH1RXCLK_ALT2_IN
SENT8RX_ALT4_IN
191

391
MEMC0A7_ALT3_OUT
RLIN33TX_ALT4_OUT
192

392
MCAN0TXFD_ALT4_OUT
RLIN33RX_ALT4_IN
193

393
ETH1TXCLK_ALT2_IN
SENT9SPCO_ALT4_OUT
194

394
MEMC0A8_ALT3_OUT
SENT9RX_ALT4_IN
195

395
MCAN0RXFD_ALT4_OUT
MCAN2TX_ALT2_OUT
196

396
ETH1REF50CK_ALT2_IN
MCAN2RX_ALT3_IN
197

397
FLSCI3RXD_ALT3_IN_SUPP_PFC_P
MEMC0D0I_ALT3_IN
MCSR
198

398
FLSCI3TXD_ALT3_OUT_SUPP_PFC_
MEMC0D0O_ALT3_OUT
PMCSR
199

399
MTTCAN0SWT_ALT4_IN
DIO_SUPP_PFC_PMCSR
200
ETH1TXD0_ALT2_OUT

39

Chapter 8 Configuration Overview

40

Messages Chapter 9

Chapter 9
Messages

The messages help to identify the syntax or semantic errors in the ECU
Configuration Description File. Hence it ensures validity and correctness of the
information available in the ECU Configuration Description File.

The following section gives the list of error, warning and information messages
displayed by the mcal code generator tool.

9.1 Error Messages

ERR_59_124_001: Parameter PortPinModeChangeable should not be
configured as true in the path /Renesas/EcucDefs_Port/Port0/
PortConfigSet0/PortGroup10/PortPin10 as the parameter
PortSetPinModeApi is set false.
This error occurs when ‘PortPinModeChangeable’ is set as true and
’PortSetPinModeApi’ is set as false
ERR_59_124_002: Number of fields is not same for the entity Structure
Port_GstConfiguration. At least one DNFA instance shall be configured in
in PortConfigSet0 across MultiConfigSet.
This error occurs when Number of fields is not same for the entity Structure
Port_GstConfiguration
ERR_59_124_003: PortGroup${GrpInst}0 is not configured in
PortConfigSet${ConfigSet}, PortGroups configured shall not be different
across MultiConfigSet.
This error occurs when any of the PortGroup is not configured and if
PortGroups configured different across MultiConfigSet
ERR_59_124_004: Configured PortPins of the PortGroup00 does not
match, PortPins of a PortGroup shall remain alike across MultiConfigSet.
This error occurs when PortPin not Present in a PortGroup, and if the PortPins
of a PortGroup different across MultiConfigSet
ERR_59_124_005: Number of fields is not same for the entity Structure
Port_GstConfiguration. At least one FCLA instance shall be configured in
PortConfigSet0 across MultiConfigSet.
This error occurs when Number of fields is not same for the entity Structure
‘’Port_GstConfiguration
ERR_59_124_006: Parameter PortPinDirectionChangeable should not be
configured as true in the Path Renesas/EcucDefs_Port/Port0/
PortConfigSet/PortGroup/PortPin, as parameter PortSetPinDirectionApi is
set false.
This error occurs when ‘PortPinDirectionChangeable’ is set as true and
’PortSetPinDirectionApi’ is set as false
ERR_59_124_007: Parameter PortPinDioAltModeChangeable should not
be configured as true in the path /Renesas/EcucDefs_Port/Port/
41

Chapter 9 Messages

PortConfigSet/PortGroup/PortPin, as parameter PortSetToDioAltModeApi
is set false.
This error occurs when ‘PortPinDioAltModeChangeable’ is set as true and’
PortSetToDioAltModeApi’ is set as false
ERR_59_124_009 : The value for parameter PortInputBufferControl of the
Port Group Container should not be configured as <true> in the path
/Renesas/EcucDefs_Port/Port/PortConfigSet/PortGroup/PortPin as the
value configured for parameter PortPinInitialMode of the same container
is configured as <PORT_PIN_OUT>.
This error occurs when ‘PortInputBufferControl’ is set as false and
’PortPinInitialMode’ is set as output mode.
ERR_59_124_010 : Value of the parameter PortPinInitialMode of Port
Group container Port Pin container support only
DIO_SUPP_PFCE_PMCSR mode in $PortPinPath, Hence the parameter
PortPinDioAltModeChangeable of same container shall not be configured
as <true>.
This error occurs when ‘PortPinInitialMode’ is set as
DIO_SUPP_PFCE_PMCSR and ’PortPinDioAltModeChangeable’ is set as true
ERR_59_124_011: $PortGrpShortNameCmp is repeated in
PortGroup${GrpInst} and PortGroup$ContInst.
This error occurs when ‘$PortGrpShortNameCmp is repeated in
PortGroup${GrpInst} and PortGroup$ContInst.
ERR_59_124_012: $PortShortNameCmp is repeated in
PortGroup${GrpInst} PortPin$PinInst and PortGroup$ContInst
PortPin$PinInstance.
This error occurs when $PortShortNameCmp is repeated in
PortGroup${GrpInst} PortPin$PinInst and PortGroup$ContInst
PortPin$PinInstance.
ERR_59_124_013: Parameter PortPinInitialMode of the container
PortGroup9 PortPin7 should not be configured as 'MCAN2TX_ALT2_OUT'
since the device $DeviceVariant does not support 'MCAN2TX_ALT2_OUT'
alternative mode.
This error occurs when PortDeviceName is R7F701372, and
PortPinInitialMode of the container PortGroup9 PortPin7 configured as
'MCAN2TX_ALT2_OUT'
ERR_59_124_014: The configured value of the parameter
'PortPinInitialMode' of the container
'PortGroup${GrpInst}0_PortPin${PinInst}' is incorrect, since the
parameter 'PortIpControl' is configured as <true> and 'PortPinInitialMode'
is configured as <$FullPortPinInitialMode>
This error occurs when parameter 'PortIpControl' is true and PortPinInitialMode
is not an alternative function of the Port IP Control Register

42

Messages Chapter 9

ERR_59_124_016: The value configured for the parameter
'PortWriteVerifyErrorInterface' should follow C Syntax <[a-zA-Z][a-zA-Z0-
9_]>.
This error occurs when the Port callback Notification function name for the
parameter 'PortWriteVerifyErrorInterface' is not followed the C Syntax <[a-zA-
Z][a-zA-Z0-9_]>.
ERR_59_124_017: The parameter '$paramlist' in the container
'PortConfigSet$ConfigSetCnt PortGroup${GrpInst}0 PortPin${PinInst}'
should be configured.
This error occurs when a particular parameter is not configured.
ERR_59_124_019: As write-verify check is enabled through the parameter
PortWriteVerify in PortGeneral container, PORT_E_REG_WRITE_VERIFY
in PortDemEventParameterRefs container should be configured.
This error occurs when the parameter PortWriteVerify is enabled in
PortGeneral and PORT_E_REG_WRITE_VERIFY in
PortDemEventParameterRefs container is not configured.
ERR_59_124_020: As write-verify check is enabled through the parameter
PortWriteVerify in PortGeneral container and
PortUseWriteVerifyErrorInterface is configured as true,
PortWriteVerifyErrorInterface should have valid error notification.
This error occurs when the parameter PortWriteVerify in PortGeneral container
and PortUseWriteVerifyErrorInterface is configured as true, but
PortWriteVerifyErrorInterface not have any valid error notification.
ERR_59_124_021 References path of Parameter
PORT_E_REG_WRITE_VERIFY $CbkPort_E_Reg_Verify is not correct in
PortDemEventParameterRefs container.
This error occurs when the incorrect Dem reference path is configured for
PORT_E_REG_WRITE_VERIFY parameter.
ERR_59_124_022: As write-verify check is disabled via the parameter
PortWriteVerify, PortUseWriteVerifyErrorInterface parameter should not
be configured as true in PortGeneral Container.
This error occurs when the write-verify check is disabled via the parameter
PortWriteVerify, and PortUseWriteVerifyErrorInterface parameter is not
configured as true in PortGeneral Container.
ERR_59_124_024: The Short name of 'PortGroup${GrpInst}0' container
should be same across all configuration sets.
This error occurs when the short name of the Port Group container is different
across the all configuration sets.
ERR_59_124_025: The Short name of 'PortGroup${GrpInst}0 ->
PortPin${PinInst}0' container should be same across all configuration
sets.
43

  Chapter 9                                                                                                                               Messages

This error occurs when the short name of the Port Pin is different across the all
configuration sets.
ERR_59_124_026: None of the Port Group is configured. At least any one
of the PORT GROUP should be configured.
This error occurs when none of the Port group is configured.
ERR_59_124_027: The parameters 'PortPullUpOption' and
'PortPullDownOption' from $PortPinPath container should not be
configured as <true> at the same time
This error occurs when both the parameters ‘PortPullUpOption’ and
'PortPullDownOption' configured as true.
ERR_59_124_028: The configured Device Name for parameter
PortDeviceName: '$DeviceVariant' in the container
$PortInstName/PortGeneral0 is invalid.
This error occurs when configured device variant name is incorrect.
ERR_59_124_029: The value for parameter
'PortSetPinDefaultDirectionApi' from PortGeneral0 container should not
be configured as <true> as the value for parameter
'PortSetPinDirectionApi' in the container PortGeneral0 is configured as
<false>.
Path:/Renesas/EcucDefs_Port/Port/PortGeneral0
This error occurs when configured 'PortSetPinDefaultDirectionApi' parameter is
true but ‘PortSetPinDirectionApi’ parameter is false in general container.
ERR_59_124_030: The value for parameter 'PortSetPinDefaultModeApi'
from PortGeneral0 container should not be configured as <true> as the
value for parameter 'PortSetPinModeApi' in the container PortGeneral0 is
configured as <false>.
Path:/Renesas/EcucDefs_Port/Port/PortGeneral0
This error occurs when configured 'PortSetPinDefaultModeApi' parameter is
configured as true but ‘'PortSetPinModeApi' parameter is false in general
container.

9.2 Warning Messages

WARNING_59_124_001:  The parameter PortPinDirection of container
Port Group container should not be configured as <PORT_PIN_OUT> in
the path /Renesas/EcucDefs_Port/Port0/PortConfigSet/PortGroup/PortPin
, since the parameter PortPinInitialMode of the same Port Group
container is configured as an Input type mode. The value for parameter
PortPinDirection is considered as <PORT_PIN_IN>.
This warning occurs when PortPinDirection parameter is set as output and
PortPinInitialMode parameter is an input.

44

Messages                                                                                                                             Chapter 9

WARNING_59_124_002:  The parameter PortPinDirection of container
Port Group container should not be configured as <PORT_PIN_IN> in the
path  /Renesas/EcucDefs_Port/Port0/PortConfigSet/PortGroup/PortPin,
since the parameter PortPinInitialMode of the same Port Group container
is configured as an Output type mode. The value for parameter
PortPinDirection is considered as <PORT_PIN_OUT>.
This warning occurs when PortPinDirection parameter is set as an input and
PortPinInitialMode parameter is set as an output.
WARNING - Checksum incorrect message should be generated.
This Warning occurs when any vm file is corrupted.

9.3 Information Messages

None.
45

Chapter 9 Me ssages

46

Revision History

Sl.No.  Description
Version
Date
1.
Draft Version
1.0.0
17-Aug-2015
2
The following changes are made:
1.0.1
05-Apr-2016
1.  Compiler path modified in Section 9.3
2.  R number is added in the last page.
3.  Error and warning descriptions are added in section 10.1.1
3
The following changes are made:
1.0.2
09-Feb-2017
1.  10.1 Error Messages updated.
2.  Chapter 3 Code Generation Overview updated for Port_Cbk.h file
3.  Chapter 5 Output Files updated for Port_Cbk.h file
4.  R number is updated in the last page
5.  Updated Chapters 1,3,4,5,6,7 by rephrasing Tool and PORT
Driver Generation Tool with MCAL Code Generation Tool.
6.  Updated description of Chapter1 introduction and table 1-1.
7.  Updated table 2-1 Reference Documents.
8.  Renamed the Chapter 3 heading as Code Generation Overview.
9.  Updated the chapter 3 by adding a remark on MCAL Code
Generator Tool User manual and updated figure 3-2.
10.  Added Remark in Chapter4.
11.  Updated the Figure 8-1, Table 8-1 and 8-2.
12.  Updated the format of Error/Warning/Information message in the
chapter Messages.
13.  Removed Chapter 9 Generator Tool and chapter 11 Notes.
14.  In Chapter 8, table 8-1 TRXML changed to ARXML abbreviation.
4
The following changes are made:
1.0.3
27-Apr-2017
1.  ERR_59_124_029 and ERR_59_124_030 are updated in section
9.1
2.  Notice and Copyright are updated.
3.  R- Number is updated.
5.
Following change  made:
1.0.4
16-Jun-2017
1.  R-Number updated.

47

AUTOSAR MCAL R4.0.3 User's Manual
PORT Driver Component Ver.1.0.4
Generation Tool User's Manual

Publication Date: Rev.1.02, 16 June, 2017

Published by: Renesas Electronics Corporation

SALES  OFFICES

http://www.renesas.com
Refer  to "http://www.renesas.com/" for the latest  and  de  tailed  information.
Renesas Electronics America Inc.
2801 Scott Boulevard Santa Clara, CA 95050-2549, U.S.A.
Tel: +1-408-588-6000, Fax: +1-408-588-6130
Renesas Electronics Canada Limited
9251 Yonge Street, Suite 8309 Richmond Hill, Ontario Canada L4C 9T3
Tel: +1-905-237-2004
Renesas Electronics Europe Limited
Dukes Meadow, Millboard Road, Bourne End, Buckinghamshire, SL8 5FH, U.K
Tel: +44-1628-585-100, Fax: +44-1628-585-900
Renesas Electronics Europe GmbH
Arcadiastrasse 10, 40472 Düsseldorf, Germany
Tel: +49-211-6503-0, Fax: +49-211-6503-1327
Renesas Electronics (China) Co., Ltd.
Room 1709, Quantum Plaza, No.27 ZhiChunLu Haidian District, Beijing 100191, P.R.China
Tel: +86-10-8235-1155, Fax: +86-10-8235-7679
Renesas Electronics (Shanghai) Co., Ltd.
Unit 301, Tower A, Central Towers, 555 Langao Road, Putuo District, Shanghai, P. R. China 200333
Tel: +86-21-2226-0888, Fax: +86-21-2226-0999
Renesas Electronics Hong Kong Limited
Unit 1601-1611, 16/F., Tower 2, Grand Century Place, 193 Prince Edward Road West, Mongkok, Kowloon, Hong Kong
Tel: +852-2265-6688, Fax: +852 2886-9022
Renesas Electronics Taiwan Co., Ltd.
13F, No. 363, Fu Shing North Road, Taipei 10543, Taiwan
Tel: +886-2-8175-9600, Fax: +886 2-8175-9670
Renesas Electronics Singapore Pte. Ltd.
80 Bendemeer Road, Unit #06-02 Hyflux Innovation Centre, Singapore 339949
Tel: +65-6213-0200, Fax: +65-6213-0300
Renesas Electronics Malaysia Sdn.Bhd.
Unit 1207, Block B, Menara Amcorp, Amcorp Trade Centre, No. 18, Jln Persiaran Barat, 46050 Petaling Jaya, Selangor Darul Ehsan, Malaysia
Tel: +60-3-7955-9390, Fax: +60-3-7955-9510
Renesas Electronics India Pvt. Ltd.
No.777C, 100 Feet Road, HAL II Stage, Indiranagar, Bangalore, India
Tel: +91-80-67208700, Fax: +91-80-67208777
Renesas Electronics Korea Co., Ltd.
12F., 234 Teheran-ro, Gangnam-Gu, Seoul, 135-080, Korea
Tel: +82-2-558-3737, Fax: +82-2-558-5141

© 2006-2017 Renesas  Electronics  Corporation.  All rights reserved.
Colophon  4.1

AUTOSAR MCAL R4.0.3

User’s Manual

R20UT3654EJ0102

Document Outline

Last modified October 12, 2025: Initial commit (ddf2e20)