R20UT3723EJ0101-AUTOSARs

AUTOSAR MCAL R4.0.3
User’s Manual

PORT Driver Component Ver.1.0.9

Generation Tool User’s Manual

Target Device:
RH850/P1x

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.01 Feb 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
DEM
Diagnostic Event Manager
DIO
Digital Input Output
ECU
Electronic Control Unit
ICU
Input Capture Unit
Id/ID
Identifier
INTP
Interrupt
MCAL
Micro Controller Abstraction Layer
MCU
Micro Controller Unit
NMI
Non Maskable Interrupt
RUCG
Renesas Unified Code Generator
Rev.
Revision
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 PORT Driver Generation Tool. It is generated by ECU
File
Configuration Editor.
PORT
Represents a whole configurable port on a microcontroller device.

Sl.No
Serial Number.
Rev
Revision
Translation XML File
This file contains the translation and device specific header file path.
5

List of Figures

Figure 3-1
Overview of PORT Driver Generation Tool .................................................................. 13

List of Tables

Table 5-1
Output Files Description .................................................................................................... 17
Table 8-1 Parameters and Container related to error ERR124004 ................................................................ 23

8

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 Generation Tool to achieve scalability and configurability.

The document describes the features of the PORT Driver Generation Tool.
PORT Driver Generation Tool is a command line tool that extracts
information from ECU Configuration Description File and generates PORT
Driver C Source and C Header files (Port_Cfg.h, Port_Cbk.h and
Port_PBcfg.c)

This document contains information on the options, input and output files of
the PORT Driver Generation Tool. In addition, this manual covers a step-by-
step procedure for the usage of 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:

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 (PORT Driver
Provides the component overview of PORT Driver.
Generation Tool Overview)
Section 4 (Input Files)
Provides information about ECU Configuration Description File.
Section 5 (Output Files)
Explains the output files that are generated by the PORT Driver
Generation 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 PORT Driver
Validation)
Generation Tool.
Section 8 (Messages)
Describes all the Error/Warning/Information messages of R4.0.3 which
helps the user to understand the probable reason for the same.
Section 9 (Notes)
Provides notes to help the user to understand this document better.
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:

Sl.No.  Title
Version
1.
AUTOSAR_SWS_PortDriver.pdf
3.2.0
2.
P1x Parameter Definition File
1.0.5

R403_PORT_P1M_04_05.arxml

3.
P1x Parameter Definition File
1.0.6

R403_PORT_P1M_12_13.arxml
4.
P1x Parameter Definition File
1.0.5

R403_PORT_P1M_20_21.arxml
5.
P1x Parameter Definition File
1.0.5

R403_PORT_P1M_18_19_22_23.arxml
6.
P1x Parameter Definition File
1.0.8

R403_PORT_P1M_10_11_14_15.arxml

2.2
Trademark Notice

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

Chapter 2
Reference

12

PORT Driver Generation Tool Overview
Chapter 3

Chapter 3  PORT Driver Generation Tool Overview

PORT Driver Generation Tool overview is shown below.

ECU

Configuration

RUCG Tool
Description File,
Port_Cfg.h,
Translation XML
Port_Cbk.h,
File, BSWMDT
Port_P Bcfg.c
File and
Configuration
XM L File and
and
Port_X1x.dll

     Figure 3-1
Overview of PORT Driver Generation Tool

RUCG  Tool  is  a  command  line  tool  that  provides  scalability  and
configurability for PORT Driver component. It accepts ECU Configuration
Description File(s) , BSWMDT File, Translation XML File, Configuration
XML  File  and  Port_X1x.dll  as  input  and  generates  the  C  Header  and  C
Source  files  (Port_Cfg.h,Port_Cbk.h  and  Port_PBcfg.c)  for  error  free  input
files.

Port_Cfg.h  and  Port_Cbk.h  will  be  compiled  and  linked  with  PORT  Driver
Component.  Port_PBcfg.c  will  be  compiled  and  linked  separately  from  the
other C Source files and placed in flash.

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

PORT  Driver  Generation  Tool  extracts,  analyzes  the  configuration  details
provided in the input file and validates correctness of the data. Tool displays
appropriate  context  sensitive  error  messages  for  wrong  input  and  exits.  Tool
creates
the
Log
file
(Port.log)
that
contains
the
list
of
Error/Warning/Information messages in the output directory.

For the error free input file, the tool generates the following output files: C
header Port_Cfg.h, Port_Cbk.h and C source Port_PBcfg.c file names.

Remark

•
In case of errors the generation tool returns a 1, in case of no errors
the generation tool returns a 0.
•
PORT Driver Generation Tool uses “Common Published Information”
13

Chapter 3 PORT Driver Generation Tool Overview

from PORT module specific BSWMDT File.This should not be
updated manually since it is “Static Configuration” file.

14

Input Files
Chapter 4

Chapter 4  Input Files

PORT Driver Generation Tool accepts ECU Configuration Description File(s),
Configuration  XML  file,  BSWMDT  File  and  Translation  XML  File  as  input.
PORT  Driver  Generation  Tool  needs  information  about  PORT  Driver
component.  Hence  ECU  Configuration  Description  File  should  contain
configuration of PORT Driver component. Generation 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 mentioned in the Reference Documents section.
15

Chapter 4
Input Files

16

Output Files

Chapter 5

Chapter 5  Output Files

PORT Driver Generation Tool generates configuration details in C Header and
C Source files (Port_Cfg.h, Port_Cbk.h and Port_PBcfg.c).

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 call back notification functions.

Port_PBcfg.c
This file contains structure for Port Pin Initialization, Port Pin Direction Switch and Port
Pin Direction Refresh during runtime.

Remark  Output files generated by PORT Driver Generation Tool should not be modified
or edited manually.
17

Chapter 5
Output Files

18

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.

•  The input file must contain PORT Driver and DEM component related
configuration.
.
•  Default Translation XML File (Port_X1x.trxml) should be present  in same
location of Port_X1x.dll when the variant specific trxml file is not given as
input in command line.

•  Default  Configuration  XML  File  (Port_X1x.cfgxml)  must  be  present  in
same location of Port_X1x.dll.

•  If  Translation  XML  File  is  not  provided  on  the  command  line,
Port_X1x.trxml  which  is  present  in  same  location  of  Port_X1x.dll  is
considered as ‘default’ Translation XML File.

•  If  Configuration  XML  File  is  not  provided  on  the  command  line,
Port_X1x.cfgxml  which  is  present  in  same  location  of  Port_X1x.dll  is
considered as ‘default’ Configuration XML File.

•  Translation XML File should contain the file extension ‘.trxml’.

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

•  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 PORT Driver Generation 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  PORT  Driver
Generation Tool. Otherwise 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.

•  The  digital  noise  filter  clock  container  ‘PortDigitalFilterClkCtrl’  should  be
configured along with containers ‘PortDigitalFilterGroup’, if
‘PortDigitalFilterClkCtrl’ container exists.

•  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
19

Chapter 6


              Precautions

the type of activation at run-time.

•  User has to make sure that the respective device specific configuration file
is used otherwise Tool may not produce the expected results or may lead
to errors/warnings/information messages.

•  The description file should always be generated using AUTOSAR
specified configuration editor and it should not be edited manually.

Remark    Please refer the PORT Component User Manual for deviations from
  AUTOSAR specifications, if any.
20

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 PORT Driver Generation 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 8 “Messages”.

The Generation 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.

•  ERR/WRN/INF<mid><xxx>: <Error/Warning/Information Message>.
where,
<mid>: 124 - PORT Driver Module Id (124) for user configuration checks.
000 - for command line checks.
<xxx>: 001-999 - Message Id.

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

•  Path: Absolute Path of the container in which the parameter is present.

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

21

Chapter 7

User Configuration Validation

22

Messages

Chapter 8

Chapter 8  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 Generation Tool.

8.1
Error Messages

ERR124001: Number of fields is not same for the entity 'Structure Name'.

This error occurs, if the number of fields is not same in the structure that is to
be generated in the output file.

ERR124002: Field 'Field Name' is empty in the entity 'Structure Name'.

This error occurs, if the structure fields that are to be generated in the output
file are empty.

ERR124003: 'PORT Driver / DEM' Component is not present in the input
file(s).

This  error  occurs,  if  PORT  Driver  or  DEM  component  is  not  present  in  the
input ECU Configuration Description File(s).

ERR124004: The parameter 'parameter name' in the container 'container
name' should be configured.

This error occurs, if any of the mandatory configuration parameter(s)
mentioned  below  is  (are)  not  configured  in  ECU  Configuration  Description
File.
The list of mandatory parameters with respect to container is listed below:

Table 8-1        Parameters and Container related to error ERR124004

Parameter Name
Container Name
-
PortConfigSet
PortDevErrorDetect

PortSetPinDirectionApi

PortSetPinModeApi

PortVersionInfoApi
PortDeviceName

PortCriticalSectionProtection
PortGeneral
PortVersionCheckExternalModules
PortLoopTimeout
23

Chapter 8                                                                                                            Messages

Parameter Name
Container Name
PortMaxMode

PortSetToDioAltModeApi
PortSetPinDefaultDirectionApi
PortWriteVerify
PortUseWriteVerifyErrorInterface
PortSetPinDefaultModeApi
PortPinDirection

PortPinDirectionChangeable

PortPinLevelValue
‘Port Group’ container
Where in ‘Port Group container': PortGroup<Group
PortPinInitialMode
number/Alphabetic name> for PortPin<Pin number>.
PortInputBufferControl
E.g. PortGroup0
PortPin0,
PortBiDirectionControl
PortGroup1
PortPullUpOption
PortPin1,
PortPullDownOption
PortGroupJtag0
PortPin0 etc.
PortInputSelection

PortIpControl
PortInputSelection
PortOutputDriveStrength
PortPinModeChangeable

PortOpenDrainControl_Expansion
PortOutputLevelInversion
PortPinDioAltModeChangeable
-
PortFilterGroupConfig
PortSameLevelSamples
Digital Filter Container PortDigitalFilterGroup<Filter
Group number> Ex: PortDigitalFilterGroup0,
PortSamplingClockFrequency
PortDigitalFilterGroup1... etc
PortDigitalFilterEnableInput(X) where X= 0-7
PortDigitalFilterEdgeControl(Y) where Y =0-5
PortDigitalFilterModeSelection
PORT_E_WRITE_TIMEOUT_FAILURE
PortDemEventParameterRefs
PortClockSource<Filter clock source selection
SamplingClockSourceSelection
number>

ERR124005:  The  number  of  configuration  sets  configured  for  'PORT'
and 'MCU' modules should be same.

This error occurs, if the number of configuration sets configured for PORT and
MCU modules are not same.

ERR124007:  Short  name  of  ‘Port  Group  container’  container  should
be same across all configuration sets.

This error occurs, if short name of ‘Port Group container’ container is not same
across all configuration sets.

ERR124008: Short name of ' Port Pin container’ should be same across all
configuration sets.

This  error  occurs,  if  short name  of  ‘Port  Pin  container’  is  not  same  across  all
configuration sets.
24

Messages

Chapter 8

ERR124009: The value for parameter 'PortPinModeChangeable' from
‘Port  Group  Container’  container  should  not  be  configured  as  <true>
as the value for parameter ‘PortSetPinModeApi’ in the container
‘PortGeneral’ is configured as <false>.

This  error  occurs,  if  the  parameter  PortSetPinModeApi  in  the  container
PortGeneral is configured as false and parameter PortPinModeChangeable is
configured as true for at least one of the ‘Port Group container’ container.

  ERR124010:  The  value  for  parameter  'PortInputBufferControl'  of  the
'PortPin[X]'  container  should  not  be  configured  as  <true>  as  either
configured  value  for  parameter  'PortPinDirection'  of  the  same  container
is configured as <PORT_PIN_OUT> or parameter 'PortPinInitialMode'
is configured as '<value of PortPinInitialMode>' and parameters
'PortPinDirectionChangeable', 'PortPinDioAltModeChangeable'
'PortPinModeChangeable' are configured <FALSE>.

This  error  will  occur,if  PortInputBufferControl  configured  as    true  when
PortPinInitialMode  is  OUT  mode  or  PortPinDirection  is  PORT_PIN_OUT  and
none
of
the
corresponding
runtime
changeable
features
[
PortPinDirectionChangeable,
PortPinDioAltModeChangeable,
PortPinModeChangeable] is made true.

ERR124011: The value for parameter ‘PortPinDirectionChangeable’ for
any ‘Port Group Container’ container should not be configured as <true>
as the value for parameter ‘PortSetPinDirectionApi’ in the container
‘PortGeneral’ is configured as <false>.

This  error  occurs,  if  the  parameter  PortSetPinDirectionApi  in  the  container
PortGeneral is configured as false and parameter PortPinDirectionChangeable
is configured as true for at least one of the ‘Port Group container’ container.

ERR124012: The reference path <path> provided for the parameter
'PORT_E_WRITE_TIMEOUT_FAILURE' within the container
'PortDemEventParameterRefs' is incorrect.

This error occurs, if the path provided for parameter
PORT_E_WRITE_TIMEOUT_FAILURE
in
the
container
PortDemEventParameterRefs is
incorrect.

ERR124013:  Value  of  the  parameter  'PortPinInitialMode'  of  'Port
Group  container'  'Port  Pin  container'  container  should  not  be
configured as <value of PortPinInitialMode>, since the parameter
'PortPinDioAltModeChangeable' of same container is configured as
<true>.

This  error  occurs,  if  the  parameter  PortPinInitialMode  of  the  ‘Port  Group
container’ is configured as DIO and parameter PortPinDioAltModeChangeable
of the same ‘Port Group container’ container is true.

ERR124014: The value for parameter ‘PortPinDioAltModeChangeable’ for
any ‘Port Group Container’ container should not be configured as <true>
as  the  value  for  parameter  ‘PortSetToDioAltModeApi’  in  the  container
‘PortGeneral’ is configured as <false>.

This  error  occurs,  if  the  parameter  PortSetToDioAltModeApi  in  the  container
PortGeneral
is
configured
as
false
and
parameter
PortPinDioAltModeChangeable  is  configured  as  true  for  at  least  one  of  the
25

Chapter 8                                                                                                            Messages

‘Port Group container’ container.

ERR124015: The value for parameter 'PortSetPinDefaultDirectionApi'
from 'PortGeneral' container should not be configured as <true> as the
value for parameter 'PortSetPinDirectionApi' in the container
'PortGeneral' is configured as <false>.

This  error  will  occur,  if  the  parameter  PortSetPinDirectionApi  in  the  container
PortGeneral
is
configured
as
false
and
parameter
PortSetPinDefaultDirectionApi  in  the  PortGeneral  container  PortGeneral  is
configured as true.

ERR124016: The value for parameter 'PortSetPinDefaultModeApi' from
'PortGeneral' container should not be configured as <true> as the value
for parameter 'PortSetPinModeApi' in the container 'PortGeneral' is
configured as <false>.

This  error  will  occur,  if  the  parameter  PortSetPinModeApi  in  the  container
PortGeneral  is  configured  as  false  and  parameter  PortSetPinDefaultModeApi
in the PortGeneral container PortGeneral is configured as true.

ERR124018: The configured value of the parameter ‘PortPinInitialMode’
of the container ‘PortPin1’ is incorrect, since the parameter
‘PortIpControl’ is configured as <true> and ‘PortPinInitialMode’ is
configured as <>.

This error will occur, if the parameter PortIpControl in the container PortGroup
is configured as true and parameter PortPinInitialMode of the same PortGroup
container  is  configured  as  any  mode  except  the  one  for  which  the  parameter
PortIpControl is required to be TRUE.

ERR124019: The value of the parameter‘PORT_E_REG_WRITE_VERIFY’
should be configured in the container ‘PortDemEventParameterRefs’
when the parameter ‘PortWriteVerify’ is configured as <TRUE> in the
‘PortGeneral’ container

This  error  occurs,  if  DEM  parameter  PORT_E_REG_WRITE_VERIFY  path  is
not  configured  in  PortDemEventParameterRefs  container  when  parameter
‘PortWriteVerify’ is configured as true in PortGeneral container.

ERR124020: 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
will
occur,
if
the
parameters
PortWriteVerify
and
PortUseWriteVerifyErrorInterface  in  PortGeneral  container  is  configured  as
true  and  valid  notification  name  is  not  configured  for  the  parameter
PortWriteVerifyErrorInterface.

ERR124021: The reference path <Value of path > configured for the
parameter 'PORT_E_REG_WRITE_VERIFY' in the container
'PortDemEventParameterRefs', short name of the DEM container is
incorrect.

This  error  occurs,  if  the  path  provided  for  the  DEM  parameter
'PORT_E_REG_WRITE_VERIFY'
inside
‘PortDemEventParameterRefs’
container  is  wrong  when  the  parameter  ‘PortWriteVerify’  in  the  ‘PortGeneral  '
container is configured as True.
26

Messages

Chapter 8

ERR124022: As write-verify check is disabled in the parameter
‘PortWriteVerify’ and ‘PortUseWriteVerifyErrorInterface’ parameter
should not be configured as true in PortGeneral Container.

This  error  will  occur,  if  the  parameter  ‘PortUseWriteVerifyErrorInterface’  is
configured as true when the parameter ‘PortWriteVerify’ is disabled in the
PortGeneral Container.

ERR124023: In PortConfigSet container If any PortDigitalFilterGroup is
configured,then the container SamplingClockSourceSelection inside
PortFilterGroupConfig should be configured.

This error will occur, if  any of the PortDigitalFilterGroup is configured and the
container  SamplingClockSourceSelection  inside  the  PortFilterGroupConfig  is
not configured.

ERR124024: In PortConfigSet container If any PortDigitalFilterGroup is
configured,then the parameter PortDigitalFilterClockSelection inside
the PortFilterGroupConfig container should be configured.

This  error  will  occur,if  any  of  the  PortDigitalFilterGroup  is  configured  and  the
parameter  PortDigitalFilterClockSelection  inside  the  PortFilterGroupConfig
container is not configured.

ERR124025: The reference path <PortDigitalFilterClockSelectionPath>
provided for the parameter within the container 'PortFilterGroupConfig'
is incorrect.

This  error  will  occur,  if  the  reference  path  provided  for  the  parameter
PortDigitalFilterClockSelection  within  the  container  'PortFilterGroupConfig'  is
incorrect.

ERR124026: If any PortDigitalFilterGroup is configured,then the
parameter PortDigitalFilterClockSelection should be present and
configured inside the PortFilterGroupConfig container.

This error will occur, if any of the PortDigitalFilterGroup container is configured
and
the
parameter
PortDigitalFilterClockSelection
inside
the
PortFilterGroupConfig container is not present.

ERR124027: The parameters 'PortPullUpOption' and
'PortPullDownOption' should not be configured as <true> at the same
time.

This error will occur, if the parameters 'PortPullUpOption' and
'PortPullDownOption' configured as <true> at the same time in PortPin
container of any PortGroup.

8.2
Warning Messages

WRN124001:  The  parameter  ‘PortPinDirection’  of  container  ‘Port
Group  container’  should  not  be  configured  as  <PORT_PIN_OUT>,
since  the  parameter  ‘PortPinInitialMode’  of  the  same  ‘Port  Group
container’  container  is  configured  as  an  Input  type  mode.  The  value
for parameter
‘PortPinDirection’ is considered as <PORT_PIN_IN>.

27

Chapter 8                                                                                                            Messages

This warning occurs, if value configured for the parameter PortPinDirection is
Output  and  value  configured  for  the  parameter  PortPinInitialMode  is  of  Input
type mode. The value of the parameter PortPinDirection will be considered as
Input.

WRN124002:  The  parameter  ‘PortPinDirection’  of  container  ‘Port
Group container’ should not be configured as <PORT_PIN_IN>, since
the parameter ‘PortPinInitialMode’ of the same ‘Port Group container’
container  'is  configured  as  an  Output  type  mode.  The  value  for
parameter
‘PortPinDirection’ is considered as <PORT_PIN_OUT>.

This warning occurs, if value configured for the parameter  PortPinDirection is
Input  and  value  configured  for  the  parameter  PortPinInitialMode  is  of  Output
type mode. The value of the parameter PortPinDirection will be considered as
Output.

WRN124006: The values configured in SamplingClockSourceSelection
container  are  ignored  since  no  PortDigitalFilterGroup  container  is
configured.

This
warning
will
occur
if
the
values
configured
for
SamplingClockSourceSelection
container
are
ignored
when
no
PortDigitalFilterGroup container is configured.

8.3
Information Messages

None.
28

Notes

Chapter 9

Chapter 9 Notes

“Generation Tool” and “Tool” terminologies are used interchangeably to refer
PORT Driver Generation Tool.

29

Chapter 9

Notes

30

Revision History

Sl.No.  Description
Version
Date
1.
Initial Version
1.0.0
08-Oct-2013
2.
Following change is made:
1.0.1
21-Nov-2013

•
Error message ERR124004 is updated for addition of
PortDemEventParameterRefs container.

3.
Following changes are made:
1.0.2
28-Jan-2014

•
Error messages ERR124003, ERR124005, ERR124006,
ERR124008 and ERR124014 are added in section 8.1.

•
Error message ERR124004 is updated in section 8.1.

•
Warning messages WRN124003, WRN124005 are updated in
section 8.2.

4.
  Following changes are made:
1.0.3
12-Mar-2014

•
Error messages ERR124004 is updated in section 8.1 for the

removal of PortPinStatusBackup parameter.

•
The error message ERR124006 and the warning message
WRN124004 are deleted from chapter 8.

5.
Following changes are made:
1.0.4
27-Aug-2014

•
Error messages ERR124015 and ERR124016 are added newly in
section 8.1.

•
Error message ERR124004 is updated for addition of
SamplingClockSourceSelection container and
PortSetPinDefaultDirectionApi and PortSetPinDefaultModeApi
parameters in PortGeneral container.

•
The warning message WRN124006 is added newly in section 8.3
.
•
Reference Documents section is updated for addition of Parameter
definition file reference in chapter 2.

•
Precautions chapter is updated.

6.
Following changes are made:
1.0.5
29-Apr-2015

•
Parameter definition file names and versions are updated in
section 2.1.

•
Error message ERR124018 is added in section 8.1.

7.
Following changes are made:
1.0.6
29-Mar-2016

•
Parameter definition file name versions are updated in section 2.1.
•
Description for error message ERR124010 is updated in section

8.1.
•
Port_X1x.exe is replaced with Port_X1x.dll in Chapter 6

•
ERR124004 is updated to remove parameter PortDemErrorDetect
from container PortGeneral

•
Added R number at end of the document
•
Chapter 3 is updated for Figure 3-1

•
Copyright information is updated

   31

Sl.No. Description
Version
Date
8.
Following changes are made:
1.0.7
11-Jul-2016

•
Parameter definition file name versions are updated in section 2.1
•
Port_Cbk.h information added in the chapter 1,3 and 5.
•
Error message ERR124019 to ERR124027 are added in section
8.1.
•
R number is updated at end of the document

9.
Following changes are made:
1.0.8
24-Oct-2016

•
Warning messages WRN124003 and WRN124005 are removed

from section 8.2.
•

Table number is added for table present in Chapter 8.1 Error
Messages.

•
Parameter definition file name versions are updated in section 2.1

•
Parameters PortDriveStrengthControl and
PortUnlimitedCurrentControl are removed and
PortOutputDriveStrength is added to the Table 8-1

10.
Following changes are made:
1.0.9
14-Feb-2017

•
Abbreviation list is updated.
•
R number is updated at end of the document
•
Notice is updated
•
Version of Parameter definition files updated in the section
2.1.Reference Documents

32

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

Publication Date: Rev.1.01, February 14, 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

R20UT3723EJ0101

Document Outline

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