Specification of GPT Driver

AUTOSAR CP R22-11

Document Title Specification of GPT Driver

Document Owner AUTOSAR
Document Responsibility AUTOSAR
Document Identification No 30

Document Status published

Part of AUTOSAR Standard Classic Platform
Part of Standard Release R22-11

Document Change History

Date Release Changed by Change Description
2022-11-24 R22-11 AUTOSAR  Rename SWS_Gpt_00381 into
Release SWS_Gpt_NA_00381
Management
2021-11-25 R21-11 AUTOSAR  Update optional interfaces relative to
Release EcuM
Management
2020-11-30 R20-11 AUTOSAR  Delete requirement Sws_Gpt_00270
Release  Replace requirements defined for
Management each error by global requirement for
each error table defined in §7.4.
 Move chapter Error detection in §8
2019-11-28 R19-11 AUTOSAR  No content changes.
Release  Changed Document Status from
Management Final to published
2018-10-31 4.4.0 AUTOSAR  Incorporation of concept MCAL
Release Multicore Distribution (Draft)
Management  Header File Cleanup
2017-12-08 4.3.1 AUTOSAR  Ensure consistency between default
Release error tracer and development errors.
Management  Add support of runtime errors and
change type of errors
GPT_E_MODE and GPT_E_BUSY.
2016-11-30 4.3.0 AUTOSAR  Variant chapter reworked. Remove
Release redundant requirement
Management SWS_Gpt_00342. Remove any
reference to Dem.

1 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Document Change History

Date Release Changed by Change Description
2015-07-31 4.2.2 AUTOSAR  Det renaming and extension
Release incorporation
Management  Debugging support marked as
obsolete
 Remove duplicated requirements in
traceability
2014-10-31 4.2.1 AUTOSAR  Init pointer check harmonized with
Release BSW_General, redundant
Management SWS_GPT_00294,
SWS_GPT_00340 items removed
 Added new error code
GPT_E_INIT_FAILED
2013-10-31 4.1.2 AUTOSAR  Editorial changes
Release
Management
2013-03-15 4.1.1 AUTOSAR  GPT Predef Timer functionality
Administration added
 Gpt_GetTimeElapsed and
Gpt_GetTimeRemaining are fully
reentrant now
 MemMap.h renamed to
Gpt_MemMap.h
2011-12-22 4.0.3 AUTOSAR  Range added to ECUC_Gpt_00331
Administration  "module short name" replaced by
"module abbreviation"
 Chapter 6 revised and chapter 13
added due to new traceability
mechanism
2011-04-15 4.0.2 AUTOSAR  GPT208, GPT376 and GPT378
Administration removed
 Multiplicity changed in
ECUC_Gpt_00312 (chapter 10.2.6
updated)
 SWS_Gpt_00256 rephrased
 SWS_Gpt_00256 changed
according to changed
SRS_BSW_00004

2 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Document Change History

Date Release Changed by Change Description
2009-12-18 4.0.1 AUTOSAR  Revised completely, a lot of SWS
Administration items deleted, replaced, changed
and added
 Gpt_Cbk_CheckWakeup renamed
to Gpt_CheckWakeup
 Parameter names of API services
renamed
 Configuration parameters renamed,
deleted and added
 Debugging Concept incorporated
 ClockReferencePoint mechanism
incorporated
 Traceability tables updated
 Legal disclaimer revised
 Chapter 10.3 revised
2008-08-13 3.1.1 AUTOSAR  Legal disclaimer revised
Administration
2007-12-21 3.0.1 AUTOSAR  Introduction of consistent description
Administration of wakeup concept (as evaluated in
Startup/ Wakeup Taskforce). This
includes modifications and
extensions of textual descriptions as
well as the modification of sequence
charts related to wakeup.
 SWS Improvement: improvement of
wording, alignment of API
description
 Introduction of additional
development error in case of
already initialized module
 Document meta information
extended
 Small layout adaptations made

3 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Document Change History

Date Release Changed by Change Description
2007-01-24 2.1.15 AUTOSAR  Header file structure changed
Administration significantly
 Return values and development
errors for Gpt_GetTimeRemaining()
and Gpt_GetTimeElapsed()
changed
 Development error checking of
ConfigPtr in Gpt_Init() changed
 Configuration container structure
and configuration parameters
 changed
 Interface Dem_ReportErrorEvent()
removed
 Legal disclaimer revised
 Release Notes added
 “Advice for users” revised
 “Revision Information” added
2006-05-16 2.0 AUTOSAR  Document structure adapted to
Administration common Release 2.0 SWS
Template.
 Added wake-up functionality
 For more details see chapter 11
2005-05-31 1.0 AUTOSAR  Initial release
Administration

4 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Disclaimer

This work (specification and/or software implementation) and the material contained
in it, as released by AUTOSAR, is for the purpose of information only. AUTOSAR
and the companies that have contributed to it shall not be liable for any use of the
work.
The material contained in this work is protected by copyright and other types of
intellectual property rights. The commercial exploitation of the material contained in
this work requires a license to such intellectual property rights.
This work may be utilized or reproduced without any modification, in any form or by
any means, for informational purposes only. For any other purpose, no part of the
work may be utilized or reproduced, in any form or by any means, without permission
in writing from the publisher.
The work has been developed for automotive applications only. It has neither been
developed, nor tested for non-automotive applications.
The word AUTOSAR and the AUTOSAR logo are registered trademarks.

5 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Table of Contents

1 Introduction and functional overview .................................................................... 8

2 Acronyms, abbreviations and terms ..................................................................... 9
3 Related documentation ....................................................................................... 10
3.1 Input documents............................................................................................ 10
3.2 Related standards and norms....................................................................... 11
3.3 Related specification ..................................................................................... 11
4 Constraints and assumptions ............................................................................. 12
4.1 Assumptions.................................................................................................. 12
4.2 Limitations ..................................................................................................... 12
4.3 Applicability to car domains .......................................................................... 12
5 Dependencies to other modules ......................................................................... 13
6 Requirements traceability ................................................................................... 14
7 Functional specification ...................................................................................... 22
7.1 General behavior .......................................................................................... 22
7.2 GPT Predef Timers ....................................................................................... 25
7.3 Version checking ........................................................................................... 27
7.4 Error classification ......................................................................................... 27
7.4.1 Development Errors .................................................................................. 27
7.4.2 Runtime Errors .......................................................................................... 28
7.4.3 Transient Faults ........................................................................................ 28
7.4.4 Production Errors ...................................................................................... 28
7.4.5 Extended Production Errors ...................................................................... 28
8 API specification ................................................................................................. 29
8.1 Imported types .............................................................................................. 29
8.2 Type Definitions ............................................................................................ 29
8.2.1 Gpt_ConfigType ........................................................................................ 29
8.2.2 Gpt_ChannelType ..................................................................................... 29
8.2.3 Gpt_ValueType ......................................................................................... 30
8.2.4 Gpt_ModeType ......................................................................................... 30
8.2.5 Gpt_PredefTimerType............................................................................... 31
8.3 Function definitions ....................................................................................... 31
8.3.1 Gpt_GetVersionInfo .................................................................................. 31
8.3.2 Gpt_Init ...................................................................................................... 32
8.3.3 Gpt_DeInit ................................................................................................. 34
8.3.4 Gpt_GetTimeElapsed................................................................................ 35
8.3.5 Gpt_GetTimeRemaining ........................................................................... 37
8.3.6 Gpt_StartTimer .......................................................................................... 38
8.3.7 Gpt_StopTimer .......................................................................................... 40
8.3.8 Gpt_EnableNotification ............................................................................. 41
8.3.9 Gpt_DisableNotification ............................................................................ 42
8.3.10 Gpt_SetMode ............................................................................................ 43
8.3.11 Gpt_DisableWakeup ................................................................................. 45
6 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

8.3.12 Gpt_EnableWakeup .................................................................................. 46

8.3.13 Gpt_CheckWakeup ................................................................................... 47
8.3.14 Gpt_GetPredefTimerValue ....................................................................... 48
8.4 Call-back Notifications .................................................................................. 50
8.5 Scheduled functions...................................................................................... 50
8.6 Expected Interfaces ...................................................................................... 50
8.6.1 Mandatory Interfaces ................................................................................ 50
8.6.2 Optional Interfaces .................................................................................... 51
8.6.3 Configurable Interfaces ............................................................................. 51
8.7 Error detection............................................................................................... 53
9 Sequence diagrams ............................................................................................ 54
9.1 Gpt_Init .......................................................................................................... 54
9.2 GPT continuous mode .................................................................................. 55
9.3 GPT one-shot mode...................................................................................... 56
9.4 Disable/Enable Notifications ......................................................................... 56
9.5 Wakeup ......................................................................................................... 57
10 Configuration specification ................................................................................. 59
10.1 How to read this chapter ............................................................................... 59
10.2 Containers and configuration parameters .................................................... 60
10.2.1 Gpt ............................................................................................................. 60
10.2.2 GptDriverConfiguration ............................................................................. 60
10.2.3 GptClockReferencePoint .......................................................................... 65
10.2.4 GptChannelConfigSet ............................................................................... 66
10.2.5 GptChannelConfiguration ......................................................................... 66
10.2.6 GptWakeupConfiguration .......................................................................... 71
10.2.7 GptConfigurationOfOptApiServices .......................................................... 72
10.3 Published Information ................................................................................... 74
11 Not applicable requirements ............................................................................... 76

7 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

1 Introduction and functional overview

This specification specifies the functionality, API and the configuration of the
AUTOSAR Basic Software module GPT driver.

The GPT driver is part of the microcontroller abstraction layer (MCAL). It initializes
and controls the internal General Purpose Timer(s) (GPT) of the microcontroller.

The GPT driver provides services and configuration parameters for

 Starting and stopping hardware timers
 Getting timer values
 Controlling time triggered interrupt notifications, if supported by hardware
 Controlling time triggered wakeup interrupts, if supported by hardware

The tick duration of a timer channel depends on channel specific settings (part of
GPT driver) as well as on system clock and settings of the clock tree controlled by
the MCU module. The tick duration is not limited by this specification.

Not all hardware timers must be controlled by the GPT module. Some timers may be
controlled by AUTOSAR Operating System or Complex Drivers directly. The number
of timer channels controlled by the GPT driver depends on hardware, implementation
and system configuration.

Beside the possibility to configure individual timer channels with individual properties,
some free running up counters – so-called GPT Predef Timers – are defined. These
timers have predefined tick durations and predefined number of bits (physical time
units and ranges). The GPT Predef Timers are used by the Time Service module.

The GPT driver only generates time bases. Further time based functionality on driver
level is covered by other MCAL modules like:
 PWM Driver (driver for pulse width modulation)
 ICU Driver (driver for input capture unit)
 OCU Driver (driver for output compare unit)

8 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

2 Acronyms, abbreviations and terms

Only a few acronyms and abbreviations are listed here which are helpful to
understand this document or which have a local scope. Further information can be
found in the official AUTOSAR glossary [13].

Acronym / Description
Abbreviation
BSW Basic Software
DET Default Error Tracer
ECU Electronic Control Unit
GPT General Purpose Timer
ICU Input Capture Unit
MCU Micro Controller Unit
NOP, nop Null Operation
OS Operating System

Table 1: Acronyms and abbreviations

The terms defined in the table below have a local scope within this document.

Term Description
Timer channel Represents a logical timer entity assigned to a timer hardware
Target time Time, something shall occur, when the value is reached. The behavior
depends on the configuration and the enabled functionality.
Tick Defines the timer resolution, the duration of a timer increment
GPT Predef Timer A GPT Predef Timer is a free running up counter provided by the GPT driver.
Which GPT Predef Timer(s) are available depends on hardware (clock,
hardware timers, prescaler, width of timer register, …) and configuration. A
GPT Predef Timer has predefined physical time unit and range.

Table 2: Terms

9 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

3 Related documentation

3.1 Input documents

[1] List of Basic Software Modules,
AUTOSAR_TR_BSWModuleList.pdf

[2] Layered Software Architecture,

AUTOSAR_EXP_LayeredSoftwareArchitecture.pdf

[3] General Requirements on Basic Software Modules,

AUTOSAR_SRS_BSWGeneral.pdf

[4] Specification of Standard Types,

AUTOSAR_SWS_StandardTypes.pdf

[5] Specification of Default Error Tracer,

AUTOSAR_SWS_DefaultErrorTracer.pdf

[6] Specification of ECU Configuration,

AUTOSAR_TPS_ECUConfiguration.pdf

[7] Specification of Diagnostic Event Manager,

AUTOSAR_SWS_DiagnosticEventManager.pdf

[8] Specification of ECU State Manager,

AUTOSAR_SWS_ECUStateManager.pdf

[9] General Requirements on SPAL,

AUTOSAR_SRS_SPALGeneral.pdf

[10] Requirements on GPT Driver,

AUTOSAR_SRS_GPTDriver.pdf

[11] Specification of ICU Driver,

AUTOSAR_SWS_ICUDriver.pdf

[12] Specification of MCU Driver,

AUTOSAR_SWS_MCUDriver.pdf

[13] Glossary,
AUTOSAR_TR_Glossary.pdf

[14] Basic Software Module Description Template,

AUTOSAR_TPS_BSWModuleDescriptionTemplate.pdf

10 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[15] General Specification of Basic Software Modules,

AUTOSAR_SWS_BSWGeneral.pdf

3.2 Related standards and norms

[16] IEC 7498-1 The Basic Model, IEC Norm, 1994

3.3 Related specification

AUTOSAR provides a General Specification on Basic Software modules [15] (SWS

BSW General), which is also valid for GPT Driver.

Thus, the specification SWS BSW General shall be considered as additional and
required specification for GPT Driver.

11 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

4 Constraints and assumptions

4.1 Assumptions
No assumptions.

4.2 Limitations
No limitations.

4.3 Applicability to car domains

No restrictions.

12 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

5 Dependencies to other modules

Module DET [5]
In development mode the Error hook-function of module DET [5] will be called.

Module MCU [12]

The GPT depends on the system clock, prescaler(s) and PLL. Thus, changes of the
system clock (e.g. PLL on  PLL off) also affect the clock settings of the GPT
hardware. Module GPT will not take care of settings which configure the clock,
prescaler(s) and PLL in its init function. This has to be done by the MCU module [12].
Hence the conversions between time and ticks shall be part of an upper layer.

Module EcuM [8]

The GPT driver reports the wakeup interrupts to the ECU State Manager for further
processing.
File structure
The file structure is not defined within this specification completely. It depends on the
implementation. The GPT driver shall provide at least the following files, if the
conditions described are fulfilled:

[SWS_Gpt_00261] ⌈Gpt_Irq.c shall include Gpt.h for the prototype declaration

of the notification functions. ⌋ (SRS_BSW_00164)

[SWS_Gpt_00375] ⌈Gpt.c shall include Det.h in any case to be able to raise

runtime error. ⌋ ( )

13 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

6 Requirements traceability
This chapter refers to input requirements specified in the SRS documents (Software
Requirements Specifications) that are applicable for this software module.

The table below lists links to specification items of the GPT driver SWS document,
which satisfy the input requirements. Only functional requirements are referenced.

Requirement Description Satisfied by

SRS_BSW_00005 Modules of the \mu C SWS_Gpt_NA_00381
Abstraction Layer (MCAL) may
not have hard coded horizontal
interfaces
SRS_BSW_00006 The source code of software SWS_Gpt_NA_00381
modules above the \mu C
Abstraction Layer (MCAL) shall
not be processor and compiler
dependent.
SRS_BSW_00007 All Basic SW Modules written in SWS_Gpt_NA_00381
C language shall conform to
the MISRA C 2012 Standard.
SRS_BSW_00009 All Basic SW Modules shall be SWS_Gpt_NA_00381
documented according to a
common standard.
SRS_BSW_00010 The memory consumption of all SWS_Gpt_NA_00381
Basic SW Modules shall be
documented for a defined
configuration for all supported
platforms.
SRS_BSW_00101 The Basic Software Module SWS_Gpt_00006, SWS_Gpt_00280
shall be able to initialize
variables and hardware in a
separate initialization function
SRS_BSW_00159 All modules of the AUTOSAR SWS_Gpt_NA_00381
Basic Software shall support a
tool based configuration
SRS_BSW_00160 Configuration files of SWS_Gpt_NA_00381
AUTOSAR Basic SW module
shall be readable for human
beings
SRS_BSW_00161 The AUTOSAR Basic Software SWS_Gpt_NA_00381
shall provide a microcontroller
abstraction layer which
provides a standardized
interface to higher software
layers
SRS_BSW_00162 The AUTOSAR Basic Software SWS_Gpt_NA_00381
shall provide a hardware
abstraction layer
SRS_BSW_00164 The Implementation of interrupt SWS_Gpt_00261
service routines shall be done

14 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

by the Operating System,

complex drivers or modules
SRS_BSW_00167 All AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules shall provide
configuration rules and
constraints to enable
plausibility checks
SRS_BSW_00168 SW components shall be tested SWS_Gpt_NA_00381
by a function defined in a
common API in the Basis-SW
SRS_BSW_00170 The AUTOSAR SW SWS_Gpt_NA_00381
Components shall provide
information about their
dependency from faults, signal
qualities, driver demands
SRS_BSW_00171 Optional functionality of a SWS_Gpt_00194, SWS_Gpt_00195,
Basic-SW component that is SWS_Gpt_00196, SWS_Gpt_00199,
not required in the ECU shall SWS_Gpt_00200, SWS_Gpt_00201,
be configurable at pre-compile- SWS_Gpt_00202, SWS_Gpt_00203
time
SRS_BSW_00172 The scheduling strategy that is SWS_Gpt_NA_00381
built inside the Basic Software
Modules shall be compatible
with the strategy used in the
system
SRS_BSW_00305 Data types naming convention SWS_Gpt_00357, SWS_Gpt_00358,
SWS_Gpt_00359, SWS_Gpt_00360
SRS_BSW_00306 AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules shall be compiler and
platform independent
SRS_BSW_00307 Global variables naming SWS_Gpt_NA_00381
convention
SRS_BSW_00308 AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules shall not define global
data in their header files, but in
the C file
SRS_BSW_00309 All AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules shall indicate all global
data with read-only purposes
by explicitly assigning the const
keyword
SRS_BSW_00321 The version numbers of SWS_Gpt_NA_00381
AUTOSAR Basic Software
Modules shall be enumerated
according specific rules
SRS_BSW_00323 All AUTOSAR Basic Software SWS_Gpt_00218, SWS_Gpt_00338,
Modules shall check passed SWS_Gpt_00399, SWS_Gpt_00403
API parameters for validity
SRS_BSW_00325 The runtime of interrupt service SWS_Gpt_NA_00381
routines and functions that are
running in interrupt context
shall be kept short

15 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

SRS_BSW_00328 All AUTOSAR Basic Software SWS_Gpt_NA_00381

Modules shall avoid the
duplication of code
SRS_BSW_00330 It shall be allowed to use SWS_Gpt_NA_00381
macros instead of functions
where source code is used and
runtime is critical
SRS_BSW_00331 All Basic Software Modules SWS_Gpt_NA_00381
shall strictly separate error and
status information
SRS_BSW_00333 For each callback function it SWS_Gpt_NA_00381
shall be specified if it is called
from interrupt context or not
SRS_BSW_00334 All Basic Software Modules SWS_Gpt_NA_00381
shall provide an XML file that
contains the meta data
SRS_BSW_00335 Status values naming SWS_Gpt_NA_00381
convention
SRS_BSW_00336 Basic SW module shall be able SWS_Gpt_00008, SWS_Gpt_00281
to shutdown
SRS_BSW_00341 Module documentation shall SWS_Gpt_NA_00381
contains all needed
informations
SRS_BSW_00342 It shall be possible to create an SWS_Gpt_NA_00381
AUTOSAR ECU out of modules
provided as source code and
modules provided as object
code, even mixed
SRS_BSW_00344 BSW Modules shall support SWS_Gpt_NA_00381
link-time configuration
SRS_BSW_00347 A Naming seperation of SWS_Gpt_NA_00381
different instances of BSW
drivers shall be in place
SRS_BSW_00348 All AUTOSAR standard types SWS_Gpt_00278, SWS_Gpt_NA_00381
and constants shall be placed
and organized in a standard
type header file
SRS_BSW_00353 All integer type definitions of SWS_Gpt_NA_00381
target and compiler specific
scope shall be placed and
organized in a single type
header
SRS_BSW_00357 For success/failure of an API SWS_Gpt_NA_00381
call a standard return type shall
be defined
SRS_BSW_00358 The return type of init() SWS_Gpt_00280
functions implemented by
AUTOSAR Basic Software
Modules shall be void
SRS_BSW_00359 All AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules callback functions
shall avoid return types other
16 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

than void if possible

SRS_BSW_00360 AUTOSAR Basic Software SWS_Gpt_NA_00381
Modules callback functions are
allowed to have parameters
SRS_BSW_00369 All AUTOSAR Basic Software SWS_Gpt_00403
Modules shall not return
specific development error
codes via the API
SRS_BSW_00373 The main processing function SWS_Gpt_NA_00381
of each AUTOSAR Basic
Software Module shall be
named according the defined
convention
SRS_BSW_00375 Basic Software Modules shall SWS_Gpt_00209, SWS_Gpt_00292
report wake-up reasons
SRS_BSW_00377 A Basic Software Module can SWS_Gpt_NA_00381
return a module specific types
SRS_BSW_00378 AUTOSAR shall provide a SWS_Gpt_NA_00381
boolean type
SRS_BSW_00398 The link-time configuration is SWS_Gpt_NA_00381
achieved on object code basis
in the stage after compiling and
before linking
SRS_BSW_00404 BSW Modules shall support SWS_Gpt_00280, SWS_Gpt_00357
post-build configuration
SRS_BSW_00405 BSW Modules shall support SWS_Gpt_00280, SWS_Gpt_00357
multiple configuration sets
SRS_BSW_00406 A static status variable SWS_Gpt_00220, SWS_Gpt_00222,
denoting if a BSW module is SWS_Gpt_00223, SWS_Gpt_00224,
initialized shall be initialized SWS_Gpt_00225, SWS_Gpt_00226,
with value 0 before any APIs of SWS_Gpt_00227, SWS_Gpt_00228,
the BSW module is called SWS_Gpt_00229, SWS_Gpt_00230,
SWS_Gpt_00325, SWS_Gpt_00398,
SWS_Gpt_00402
SRS_BSW_00407 Each BSW module shall SWS_Gpt_00279
provide a function to read out
the version information of a
dedicated module
implementation
SRS_BSW_00413 An index-based accessing of SWS_Gpt_NA_00381
the instances of BSW modules
shall be done
SRS_BSW_00414 Init functions shall have a SWS_Gpt_00280, SWS_Gpt_00357
pointer to a configuration
structure as single parameter
SRS_BSW_00415 Interfaces which are provided SWS_Gpt_NA_00381
exclusively for one module
shall be separated into a
dedicated header file
SRS_BSW_00416 The sequence of modules to be SWS_Gpt_NA_00381
initialized shall be configurable

17 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

SRS_BSW_00417 Software which is not part of SWS_Gpt_NA_00381

the SW-C shall report error
events only after the Dem is
fully operational.
SRS_BSW_00422 Pre-de-bouncing of error status SWS_Gpt_NA_00381
information is done within the
Dem
SRS_BSW_00423 BSW modules with AUTOSAR SWS_Gpt_NA_00381
interfaces shall be describable
with the means of the SW-C
Template
SRS_BSW_00424 BSW module main processing SWS_Gpt_NA_00381
functions shall not be allowed
to enter a wait state
SRS_BSW_00425 The BSW module description SWS_Gpt_NA_00381
template shall provide means
to model the defined trigger
conditions of schedulable
objects
SRS_BSW_00426 BSW Modules shall ensure SWS_Gpt_NA_00381
data consistency of data which
is shared between BSW
modules
SRS_BSW_00427 ISR functions shall be defined SWS_Gpt_NA_00381
and documented in the BSW
module description template
SRS_BSW_00428 A BSW module shall state if its SWS_Gpt_NA_00381
main processing function(s)
has to be executed in a specific
order or sequence
SRS_BSW_00429 Access to OS is restricted SWS_Gpt_NA_00381
SRS_BSW_00432 Modules should have separate SWS_Gpt_NA_00381
main processing functions for
read/receive and write/transmit
data path
SRS_BSW_00433 Main processing functions are SWS_Gpt_NA_00381
only allowed to be called from
task bodies provided by the
BSW Scheduler
SRS_BSW_00437 Memory mapping shall provide SWS_Gpt_NA_00381
the possibility to define RAM
segments which are not to be
initialized during startup
SRS_BSW_00438 Configuration data shall be SWS_Gpt_00280, SWS_Gpt_00357
defined in a structure
SRS_BSW_00439 Enable BSW modules to SWS_Gpt_NA_00381
handle interrupts
SRS_BSW_00440 The callback function SWS_Gpt_NA_00381
invocation by the BSW module
shall follow the signature
provided by RTE to invoke
servers via Rte_Call API

18 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

SRS_BSW_00441 Naming convention for type, SWS_Gpt_00360

macro and function
SRS_Gpt_12116 The GPT Driver shall provide SWS_Gpt_00008, SWS_Gpt_00162,
the functionality to deinitialize SWS_Gpt_00281, SWS_Gpt_00308
timer channels to their power
on reset state
SRS_Gpt_12117 The GPT Driver shall provide a SWS_Gpt_00010, SWS_Gpt_00083,
synchronous service for SWS_Gpt_00282, SWS_Gpt_00283
reading the current timer value
of each timer channel
SRS_Gpt_12119 The GPT driver shall provide SWS_Gpt_00013, SWS_Gpt_00285
the service for stopping each
channel of the timer
SRS_Gpt_12120 The GPT Driver shall provide a SWS_Gpt_00233
notification per channel that is
called when the time period has
elapsed
SRS_Gpt_12121 The GPT Driver shall provide SWS_Gpt_00014, SWS_Gpt_00286
the functionality to enable the
call of a notification function per
channel during the runtime
SRS_Gpt_12122 The GPT Driver shall provide SWS_Gpt_00015, SWS_Gpt_00287
the functionality to disable the
call of a notification function per
channel during the runtime
SRS_Gpt_12128 The GPT driver shall provide a SWS_Gpt_00274, SWS_Gpt_00275,
service for starting a timer with SWS_Gpt_00284
specific parameters
SRS_Gpt_12328 The GPT driver shall use the SWS_Gpt_00359
time unit ticks for all API
services which are related to
GPT timer channels
SRS_Gpt_13601 The GPT Driver shall be SWS_Gpt_00127
capable of performing wakeup
events, whenever a predefined
wakeup period has expired
SRS_Gpt_13602 The GPT driver shall provide a SWS_Gpt_00159, SWS_Gpt_00160,
service for enabling / disabling SWS_Gpt_00289, SWS_Gpt_00290
the wake-up capability of single
timer channels
SRS_Gpt_13603 The GPT driver shall provide a SWS_Gpt_00151, SWS_Gpt_00152,
service for selecting the Wake- SWS_Gpt_00153, SWS_Gpt_00288
up mode
SRS_Gpt_13604 The GPT driver shall support SWS_Gpt_00382
special free running up
counters, so-called GPT Predef
Timers
SRS_Gpt_13605 Different types of GPT Predef SWS_Gpt_00383, SWS_Gpt_00389
Timers shall be supported by
the GPT driver
SRS_Gpt_13606 The GPT driver shall make it SWS_Gpt_00385
possible to configure statically

19 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

which GPT Predef Timers are

enabled
SRS_Gpt_13607 The GPT Predef Timers shall SWS_Gpt_00390, SWS_Gpt_00391,
be started/stopped SWS_Gpt_00392, SWS_Gpt_00393
automatically by the GPT driver
SRS_Gpt_13608 The GPT driver shall provide a SWS_Gpt_00394, SWS_Gpt_00395,
synchronous service for SWS_Gpt_00397
reading the current timer value
of each GPT Predef Timer
SRS_SPAL_00157 All drivers and handlers of the SWS_Gpt_00014, SWS_Gpt_00015,
AUTOSAR Basic Software SWS_Gpt_00405, SWS_Gpt_00406
shall implement notification
mechanisms of drivers and
handlers
SRS_SPAL_12057 All driver modules shall SWS_Gpt_00006, SWS_Gpt_00280
implement an interface for
initialization
SRS_SPAL_12063 All driver modules shall only SWS_Gpt_00359
support raw value mode
SRS_SPAL_12064 All driver modules shall raise SWS_Gpt_00405, SWS_Gpt_NA_00381
an error if the change of the
operation mode leads to
degradation of running
operations
SRS_SPAL_12067 All driver modules shall set SWS_Gpt_00014, SWS_Gpt_00015,
their wake-up conditions SWS_Gpt_00233
depending on the selected
operation mode
SRS_SPAL_12068 The modules of the MCAL shall SWS_Gpt_NA_00381
be initialized in a defined
sequence
SRS_SPAL_12069 All drivers of the SPAL that SWS_Gpt_00209, SWS_Gpt_00292
wake up from a wake-up
interrupt shall report the wake-
up reason
SRS_SPAL_12075 All drivers with random SWS_Gpt_NA_00381
streaming capabilities shall use
application buffers
SRS_SPAL_12077 All drivers shall provide a non SWS_Gpt_NA_00381
blocking implementation
SRS_SPAL_12078 The drivers shall be coded in a SWS_Gpt_NA_00381
way that is most efficient in
terms of memory and runtime
resources
SRS_SPAL_12092 The driver's API shall be SWS_Gpt_NA_00381
accessed by its handler or
manager
SRS_SPAL_12125 All driver modules shall only SWS_Gpt_00068
initialize the configured
resources
SRS_SPAL_12129 The ISRs shall be responsible SWS_Gpt_00206, SWS_Gpt_00327
for resetting the interrupt flags
20 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

and calling the according

notification function
SRS_SPAL_12163 All driver modules shall SWS_Gpt_00008, SWS_Gpt_00281
implement an interface for de-
initialization
SRS_SPAL_12169 All driver modules that provide SWS_Gpt_00151, SWS_Gpt_00288
different operation modes shall
provide a service for mode
selection
SRS_SPAL_12263 The implementation of all driver SWS_Gpt_00357
modules shall allow the
configuration of specific module
parameter types at link time
SRS_SPAL_12265 Configuration data shall be kept SWS_Gpt_NA_00381
constant
SRS_SPAL_12448 All driver modules shall have a SWS_Gpt_00332
specific behavior after a
development error detection
SRS_SPAL_12461 Specific rules regarding SWS_Gpt_00352, SWS_Gpt_00353,
initialization of controller SWS_Gpt_00354, SWS_Gpt_00355,
registers shall apply to all driver SWS_Gpt_00356
implementations
SRS_SPAL_12462 The register initialization SWS_Gpt_NA_00381
settings shall be published
SRS_SPAL_12463 The register initialization SWS_Gpt_NA_00381
settings shall be combined and
forwarded

21 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

7 Functional specification
7.1 General behavior

The GPT driver provides services for starting and stopping timer channels (logical
timer instances assigned to a timer hardware), individual for each channel by calling
of:
Gpt_StartTimer
Gpt_StopTimer

The "target time" is passed as a parameter to Gpt_StartTimer. So, for each start
of a timer channel, the target time can be set individually.

The states and the state transitions of a timer channel are shown in Figure 1

stm GPT timer channel states

for each timer channel

(module already initialized)
initialized

Gpt_StartTimer()

stopped Gpt_StopTimer() or Gpt_SetMode() *

Gpt_StartTimer() running

timer channel in "one-shot mode" has reached its target time

expired

Gpt_StartTimer()

* for details, see specification of Gpt_SetMode()

Figure 1: Channel states and state transitions

A timer channel can be configured in "one-shot mode" or in "continuous mode".

[SWS_Gpt_00329] ⌈A timer channel starts counting at value zero. ⌋ ( )

[SWS_Gpt_00185] ⌈If a timer channel is configured in "one-shot mode":

22 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

If the timer has reached the target time (timer value = target time), the timer shall
stop automatically and maintain its timer value unchanged. The channel state shall
change from "running" to "expired".⌋

timer value

initialized running expired running stopped running expired

2
target time

target time 3
target time 1

0
t
Gpt_StartTimer 1 Gpt_StartTimer 2 Gpt_StopTimer Gpt_StartTimer 3

Figure 2: Timer channel in "one-shot mode"

[SWS_Gpt_00186] ⌈If a timer channel is configured in "continuous mode":

If the timer has reached the target time (timer value = target time), the timer shall
continue running with the value "0" at next timer tick. So, the time interval of the
recurrence is: target time + 1. This interval shall be independently of implementation,
e.g. interrupt delays. ⌋

[SWS_Gpt_00330] ⌈If a timer channel is configured in "continuous mode":

If supported by hardware, it shall be possible to realize a free running timer. This
means: A timer which rolls over automatically by hardware, if the target time is set to
the maximum value the timer is able to count (max value = 2n -1, n=number of bits). ⌋

23 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

timer value

initialized running stopped running

target time 1
target time 2

0
t
Gpt_StartTimer 1 2
Gpt_StopTimer Gpt_StartTimer

Figure 3: Timer channel in "continuous mode"

Both, the relative time elapsed and the time remaining can be queried by calling:
Gpt_GetTimeElapsed
Gpt_GetTimeRemaining

Gpt_StartTimer Target time reached Target time reached

Period 1 Period 2 Period 3

t
Time elapsed Time remaining Time elapsed Time remaining

Gpt_GetTimeElapsed Gpt_GetTimeElapsed
Gpt_GetTimeRemaining Gpt_GetTimeRemaining

Figure 4: Querying of time elapsed / time remaining for a timer channel in "continuous mode"

[SWS_Gpt_00331] ⌈If supported by hardware, a timer channel shall be able to be

configured to call a notification function. If enabled, the function is called when the
target time is reached (timer value = target time). ⌋ ( )

Interrupt notifications can be enabled and disabled at runtime individually for each
channel by calling of:
Gpt_EnableNotification
Gpt_DisableNotification

24 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00127] ⌈If supported by hardware, a timer channel shall be able to be

configured as wakeup source of the ECU. If enabled, the wakeup occurs when the
target time is reached (timer value = target time). ⌋ (SRS_Gpt_13601)

Wakeup interrupts can be enabled and disabled at runtime individually for each
channel by calling of:
Gpt_EnableWakeup
Gpt_DisableWakeup

After initialization the GPT driver is in "normal mode". A wakeup interrupt can only
occur when the driver is switched to "sleep mode". The operation mode can be set by
calling of:
Gpt_SetMode

For a detailled description on wakeup handling please refer to the ECU State
Manager specification [8].

The operation modes and the possible mode transitions of the GPT driver are shown
in Figure 5.

stm GPT driv er modes

uninitialized
initial

Gpt_Init()

Gpt_DeInit()
Gpt_DeInit()

Gpt_SetMode(GPT_MODE_SLEEP)

GPT_MODE_SLEEP GPT_MODE_NORMAL

Gpt_SetMode(GPT_MODE_NORMAL)

Figure 5: GPT driver modes

7.2 GPT Predef Timers

Beside the possibility to configure individual timer channels with individual properties,
some GPT Predef Timers are defined. The API specified for “GPT timer channels”
can not be used for GPT Predef Timers.

25 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00382] ⌈A GPT Predef Timer is a free running up counter (user point of

view). If the timer has reached the maximum value (max value = 2n -1, n=number of
bits), the timer shall continue running with the value "0" at next timer tick. ⌋
(SRS_Gpt_13604)

[SWS_Gpt_00383] ⌈Types of GPT Predef Timers

Name of GPT Predef Timer Tick Maximum Number Maximum
duration tick value of bits time span
(circa values)
GPT_PREDEF_TIMER_1US_16BIT 65535 16 bit 65 ms
GPT_PREDEF_TIMER_1US_24BIT 1 µs 16777215 24 bit 16 s
GPT_PREDEF_TIMER_1US_32BIT 4294967295 32 bit 71 minutes
GPT_PREDEF_TIMER_100US_32BIT 100 µs 4294967295 32 bit 4.9 days
⌋ (SRS_Gpt_13605)

[SWS_Gpt_00384] ⌈A GPT Predef Timer shall have a maximum tick tolerance of +/-
1 tick to ensure accuracy of time based functionality. ⌋ ( )

Which GPT Predef Timer(s) can be enabled depends on clock and available timer
hardware (prescaler, width of timer register). It is recommended to enable all GPT
Predef Timers to ensure compatibility of time based functionality for all platforms.

It is recommended to use one hardware timer per tick duration and to supply the
hardware timer directly with the clock source “f clock = 1 / (tick duration)” by good
choice of clock and prescaler(s). By this, the values of the timer counter register can
be used directly without any need of adaptation (computation) for performance
reasons. A lower bit timer can be derived from a higher bit timer by a simple software
mask operation.

For implementation of GPT Predef Timers, special hardware features may be used:
 Timers may be cascaded asynchronously to use a timer as a prescaler
 Timers may be cascaded synchronously to extend the timer range (number of
bits)
 Timers with bit number greater than 32 bit may be used
 Assembler code may be used to perform 64 bit arithmetic, if necessary GPT
internal, e.g. if a 48 bit timer with tick duration 250 ns or 1 µs is used for all
GPT Predef Timers

[SWS_Gpt_00385] ⌈It shall be possible to configure which GPT Predef Timers are
enabled. ⌋ (SRS_Gpt_13606)

[SWS_Gpt_00386] ⌈If a GPT Predef Timer is enabled, the timer(s) with the same tick
duration and lower bit number(s) shall be enabled also. ⌋ ( )

26 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Implementation specific configuration parameters are allowed if needed, e.g. to

select the used hardware unit.

All enabled GPT Predef Timers run after calling of:

Gpt_Init (SWS_Gpt_00390)
Gpt_SetMode(GPT_MODE_NORMAL) (SWS_Gpt_00392)

All enabled GPT Predef Timers are stopped by calling of:

Gpt_DeInit (SWS_Gpt_00391)
Gpt_SetMode(GPT_MODE_SLEEP) (SWS_Gpt_00393)

The current time value of the GPT Predef Timers can be got by calling of:
Gpt_GetPredefTimerValue (SWS_Gpt_00394)

7.3 Version checking

For details refer to the chapter 5.1.8 “Version Check” in SWS_BSWGeneral.

7.4 Error classification

Section 7.x "Error Handling" of the document "General Specification of Basic
Software Modules" describes the error handling of the Basic Software in detail.
Above all, it constitutes a classification scheme consisting of five error types which
may occur in BSW modules.
Based on this foundation, the following section specifies particular errors arranged in
the respective subsections below.

7.4.1 Development Errors

[SWS_Gpt_91000]⌈
Error
Type of error Related error code
value

API service called without module initialization GPT_E_UNINIT 0x0A

API service for initialization called when already GPT_E_ALREADY_

0x0D
initialized INITIALIZED

API error return code: Init function failed GPT_E_INIT_FAILED 0x0E

API parameter checking: invalid channel GPT_E_PARAM_CHANNEL 0x14

API parameter checking: invalid value GPT_E_PARAM_VALUE 0x15

API parameter checking: invalid pointer GPT_E_PARAM_POINTER 0x16

GPT_E_PARAM_PREDEF_
API parameter checking: invalid Predef Timer 0x17
TIMER

API parameter checking: invalid mode GPT_E_PARAM_MODE 0x1F

27 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

⌋()

7.4.2 Runtime Errors

[SWS_Gpt_91001]⌈
Type of error Related error code Error value

API service called when timer channel is still busy (running) GPT_E_BUSY 0x0B

API service called when driver is in wrong mode GPT_E_MODE 0x0C

⌋()

7.4.3 Transient Faults

There are no transient faults.

7.4.4 Production Errors

There are no production errors.

7.4.5 Extended Production Errors

There are no extended production errors.

28 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

8 API specification

8.1 Imported types

In this chapter all types included from the following modules are listed:

[SWS_Gpt_00278]⌈
Module Header File Imported Type

EcuM EcuM.h EcuM_WakeupSourceType

Std_Types.h Std_ReturnType
Std
Std_Types.h Std_VersionInfoType

⌋(SRS_BSW_00348)

8.2 Type Definitions

8.2.1 Gpt_ConfigType

[SWS_Gpt_00357]⌈
Name Gpt_ConfigType

Kind Structure

--

Type --
Elements
Implementation specific configuration data structure, see chapter 10 for
Comment
configurable parameters.

This is the type of the data structure including the configuration set required for
Description
initializing the GPT timer unit.

Available
Gpt.h
via

⌋(SRS_BSW_00404, SRS_BSW_00405, SRS_BSW_00438, SRS_BSW_00305,

SRS_BSW_00414, SRS_SPAL_12263)

8.2.2 Gpt_ChannelType

[SWS_Gpt_00358]⌈
Name Gpt_ChannelType

Kind Type
29 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

Derived
uint
from

Implementation specific. But not all values may be valid within this type. This
Range -- -- type shall be chosen in order to have the most efficient implementation on a
specific micro controller platform.

Description Numeric ID of a GPT channel.

Available
Gpt.h
via

⌋(SRS_BSW_00305)

8.2.3 Gpt_ValueType

[SWS_Gpt_00359]⌈
Name Gpt_ValueType

Kind Type

Derived
uint
from

The range of this type is µC dependent (width of the timer register) and has to
Range -- --
be described by the supplier.

Description Type for reading and setting the timer values (in number of ticks).

Available
Gpt.h
via

⌋(SRS_BSW_00305, SRS_SPAL_12063, SRS_Gpt_12328)

8.2.4 Gpt_ModeType

[SWS_Gpt_00360]⌈
Name Gpt_ModeType

Kind Enumeration

GPT_MODE_
0x00 Normal operation mode of the GPT
NORMAL
Range
GPT_MODE_ Operation for reduced power operation mode. In sleep
0x01
SLEEP mode only wakeup capable channels are available.

Description Modes of the GPT driver.

Available
Gpt.h
via

⌋(SRS_BSW_00441, SRS_BSW_00305)

30 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

8.2.5 Gpt_PredefTimerType

[SWS_Gpt_00389]⌈
Name Gpt_PredefTimerType

Kind Enumeration

GPT_PREDEF_ GPT Predef Timer with tick duration 1µs

0x00
TIMER_1US_16BIT and range 16bit

GPT_PREDEF_ GPT Predef Timer with tick duration 1µs

0x01
TIMER_1US_24BIT and range 24bit
Range
GPT_PREDEF_ GPT Predef Timer with tick duration 1µs
0x02
TIMER_1US_32BIT and range 32bit

GPT_PREDEF_ GPT Predef Timer with tick duration 100µs

0x03
TIMER_100US_32BIT and range 32bit

Description Type for GPT Predef Timers

Available
Gpt.h
via

⌋(SRS_Gpt_13605)

8.3 Function definitions

This is a list of functions provided for upper layer modules.

8.3.1 Gpt_GetVersionInfo

[SWS_Gpt_00279]⌈
Service Name Gpt_GetVersionInfo

void Gpt_GetVersionInfo (
Syntax Std_VersionInfoType* VersionInfoPtr
)

Service ID [hex] 0x00

Sync/Async Synchronous

Reentrancy Reentrant

Parameters (in) None

Parameters
None
(inout)

VersionInfo Pointer to where to store the version information of this

Parameters (out)
Ptr module.

Return value None

31 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Description Returns the version information of this module.

Available via Gpt.h

⌋(SRS_BSW_00407)

[SWS_Gpt_00338] ⌈If development error detection is enabled for the GPT module:
If the parameter VersionInfoPtr is a null pointer, the function
Gpt_GetVersionInfo shall raise the error GPT_E_PARAM_POINTER. ⌋
(SRS_BSW_00323)

8.3.2 Gpt_Init

[SWS_Gpt_00280]⌈
Service Name Gpt_Init

void Gpt_Init (
Syntax const Gpt_ConfigType* ConfigPtr
)

Service ID [hex] 0x01

Sync/Async Synchronous

Reentrancy Non Reentrant

Parameters (in) ConfigPtr Pointer to a selected configuration structure

Parameters (inout) None

Parameters (out) None

Return value None

Description Initializes the GPT driver.

Available via Gpt.h

⌋(SRS_BSW_00404, SRS_BSW_00405, SRS_BSW_00438, SRS_BSW_00101,

SRS_BSW_00358, SRS_BSW_00414, SRS_SPAL_12057)
[SWS_Gpt_00006] ⌈The function Gpt_Init shall initialize the hardware timer
module according to a configuration set referenced by ConfigPtr. ⌋
(SRS_BSW_00101, SRS_SPAL_12057)

[SWS_Gpt_00107] ⌈The function Gpt_Init shall disable all interrupt notifications,

controlled by the GPT driver. ⌋ ( )

32 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00068] ⌈The function Gpt_Init shall only initialize the configured

resources. Resources that are not configured in the configuration file shall not be
touched. ⌋ (SRS_SPAL_12125)

The following rules regarding initialization of controller registers shall apply to this
driver implementation:
 [SWS_Gpt_00352] ⌈If the hardware allows for only one usage of the register,
the driver module implementing that functionality is responsible for initializing
the register. ⌋ (SRS_SPAL_12461)
 [SWS_Gpt_00353] ⌈If the register can affect several hardware modules and if it
is an I/O register it shall be initialized by the PORT driver. ⌋ (SRS_SPAL_12461)
 [SWS_Gpt_00354] ⌈If the register can affect several hardware modules and if it
is not an I/O register it shall be initialized by the MCU driver. ⌋
(SRS_SPAL_12461)
 [SWS_Gpt_00355] ⌈One-time writable registers that require initialization directly
after reset shall be initialized by the startup code. ⌋ (SRS_SPAL_12461)
 [SWS_Gpt_00356] ⌈All other registers shall be initialized by the startup code. ⌋
(SRS_SPAL_12461)

[SWS_Gpt_00307] ⌈If development error detection is enabled for the GPT module:
If the GPT driver is not in operation mode "uninitialized", the function Gpt_Init shall
raise the error GPT_E_ALREADY_INITIALIZED. ⌋ ( )

[SWS_Gpt_00258] ⌈The function Gpt_Init shall disable all wakeup interrupts,

controlled by the GPT driver. ⌋ ( )

[SWS_Gpt_00339] ⌈The function Gpt_Init shall set the operation mode of the
GPT driver to "normal mode". This leads to a behavior like Gpt_SetMode is called
with parameter GPT_MODE_NORMAL. ⌋ ( )

[SWS_Gpt_00309] ⌈A re-initialization of the GPT driver by executing the Gpt_Init

function requires a de-initialization before by executing a Gpt_DeInit. ⌋ ( )

[SWS_Gpt_00390] ⌈The function Gpt_Init shall start all enabled GPT Predef
Timers at value “0”. ⌋ (SRS_Gpt_13607)

33 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

8.3.3 Gpt_DeInit

[SWS_Gpt_00281]⌈
Service Name Gpt_DeInit

void Gpt_DeInit (
Syntax void
)

Service ID [hex] 0x02

Sync/Async Synchronous

Reentrancy Non Reentrant

Parameters (in) None

Parameters (inout) None

Parameters (out) None

Return value None

Description Deinitializes the GPT driver.

Available via Gpt.h

⌋(SRS_BSW_00336, SRS_SPAL_12163, SRS_Gpt_12116)

[SWS_Gpt_00008] ⌈The function Gpt_DeInit shall deinitialize the hardware used
by the GPT driver (depending on configuration) to the power on reset state. Values of
registers which are not writeable are excluded. It’s the responsibility of the hardware
design that the state does not lead to undefined activities in the µC. ⌋
(SRS_BSW_00336, SRS_SPAL_12163, SRS_Gpt_12116)

[SWS_Gpt_00105] ⌈The function Gpt_DeInit shall disable all interrupt notifications

and wakeup interrupts, controlled by the GPT driver. ⌋ ( )

[SWS_Gpt_00162] ⌈The function Gpt_DeInit shall influence only the peripherals,

which are allocated by the static configuration. ⌋ (SRS_Gpt_12116)

[SWS_Gpt_00308] ⌈If a postbuild multiple selectable configuration variant was used,

the function Gpt_DeInit shall further influence only the peripherals, which are
allocated by the runtime configuration set passed by the previous call of the function
Gpt_Init. ⌋ (SRS_Gpt_12116)

[SWS_Gpt_00194] ⌈The function Gpt_DeInit shall be pre compile time

configurable On/Off by the configuration parameter: GptDeInitApi. ⌋
(SRS_BSW_00171)
34 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00363] ⌈The function Gpt_DeInit shall set the operation mode of the
GPT driver to "uninitialized". ⌋ ( )

[SWS_Gpt_00234] ⌈If any timer channel is in state "running", the function

Gpt_DeInit shall raise the runtime error GPT_E_BUSY. ⌋ ( )

[SWS_Gpt_00220] ⌈If development error detection is enabled for the GPT module:
If the driver is not initialized, the function Gpt_DeInit shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00391] ⌈The function Gpt_DeInit shall stop all enabled GPT Predef
Timers. ⌋ (SRS_Gpt_13607)

8.3.4 Gpt_GetTimeElapsed

[SWS_Gpt_00282]⌈
Service Name Gpt_GetTimeElapsed

Gpt_ValueType Gpt_GetTimeElapsed (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x03

Sync/Async Synchronous

Reentrancy Reentrant

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value Gpt_ValueType Elapsed timer value (in number of ticks)

Description Returns the time already elapsed.

Available via Gpt.h

⌋(SRS_Gpt_12117)
[SWS_Gpt_00010] ⌈The function Gpt_GetTimeElapsed shall return the time
already elapsed. When the channel is in mode “one-shot mode”, this is the value
relative to the point in time, the channel has been started. ⌋ (SRS_Gpt_12117)

35 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00361] ⌈When the channel is in mode "continuous mode", the return

value of Gpt_GetTimeElapsed is the value relative to the last recurrence (target
time reached) or to the start of the channel before the first recurrence occurs. ⌋ ( )

[SWS_Gpt_00295] ⌈If the function Gpt_GetTimeElapsed is called on a timer

channel in state "initialized" (channel started never before), the function shall return
the value "0". ⌋ ( )

[SWS_Gpt_00297] ⌈If the function Gpt_GetTimeElapsed is called on a timer

channel in state "stopped", the function shall return the time value at the moment of
stopping. ⌋ ( )

[SWS_Gpt_00299] ⌈If the function Gpt_GetTimeElapsed is called on a channel

configured for "one-shot mode" in state "expired" (timer has reached the target time),
the function shall return the target time. ⌋ ( )

[SWS_Gpt_00113] ⌈The function Gpt_GetTimeElapsed shall be fully reentrant,

this means even for the same timer channel. ⌋ ( )

[SWS_Gpt_00195] ⌈The function Gpt_GetTimeElapsed shall be pre compile time

configurable On/Off by the configuration parameter: GptTimeElapsedApi. ⌋
(SRS_BSW_00171)

[SWS_Gpt_00222] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_GetTimeElapsed shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00210] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration),
the function Gpt_GetTimeElapsed shall raise the error GPT_E_PARAM_CHANNEL. ⌋
()

State / Development error

Timer channel state Return value
Circumstance (if enabled)
Driver uninitialized - 0 GPT_E_UNINIT
initialized 0 -

running elapsed time -

Driver initialized
elapsed time at
stopped -
moment of stopping
expired target time -

36 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

(only one-shot mode)

Invalid parameter
all 0 GPT_E_PARAM_CHANNEL
"Channel"

Table 3: Summary: Return values and DET errors of Gpt_GetTimeElapsed

8.3.5 Gpt_GetTimeRemaining

[SWS_Gpt_00283]⌈
Service Name Gpt_GetTimeRemaining

Gpt_ValueType Gpt_GetTimeRemaining (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x04

Sync/Async Synchronous

Reentrancy Reentrant

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value Gpt_ValueType Remaining timer value (in number of ticks)

Description Returns the time remaining until the target time is reached.

Available via Gpt.h

⌋(SRS_Gpt_12117)
[SWS_Gpt_00083] ⌈The function Gpt_GetTimeRemaining shall return the timer
value remaining until the target time will be reached next time. The remaining time is
the "target time" minus the time already elapsed. ⌋ (SRS_Gpt_12117)

[SWS_Gpt_00301] ⌈If the function Gpt_GetTimeRemaining is called on a timer

channel in state "initialized" (channel started never before), the function shall return
the value "0". ⌋ ( )

[SWS_Gpt_00303] ⌈If the function Gpt_GetTimeRemaining is called on a timer

channel in state "stopped", the function shall return the remaining time value at the
moment of stopping. ⌋ ( )

[SWS_Gpt_00305] ⌈If the function Gpt_GetTimeRemaining is called on a channel

configured for "one-shot mode" in state "expired" (timer has reached the target time),
the function shall return the value “0”. ⌋ ( )

37 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00114] ⌈The function Gpt_GetTimeRemaining shall be fully reentrant,

this means even for the same timer channel. ⌋ ( )

[SWS_Gpt_00196] ⌈The function Gpt_GetTimeRemaining shall be pre compile time

configurable On/Off by the configuration parameter: GptTimeRemainingApi. ⌋
(SRS_BSW_00171)

[SWS_Gpt_00223] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_GetTimeRemaining shall raise the
error GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00211] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration),
the function Gpt_GetTimeRemaining shall raise the error
GPT_E_PARAM_CHANNEL. ⌋ ( )

State / Development error

Timer channel state Return value
Circumstance (if enabled)
Driver uninitialized - 0 GPT_E_UNINIT
initialized 0 -
running remaining time -
Driver initialized remaining time at
stopped -
moment of stopping
expired
0 -
(only one-shot mode)
Invalid parameter
all 0 GPT_E_PARAM_CHANNEL
"Channel"

Table 4: Summary: Return values and DET errors of Gpt_GetTimeRemaining

8.3.6 Gpt_StartTimer

[SWS_Gpt_00284]⌈
Service Name Gpt_StartTimer

void Gpt_StartTimer (
Gpt_ChannelType Channel,
Syntax
Gpt_ValueType Value
)

Service ID [hex] 0x05

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

38 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Channel Numeric identifier of the GPT channel.

Parameters (in)
Value Target time in number of ticks.

Parameters (inout) None

Parameters (out) None

Return value None

Description Starts a timer channel.

Available via Gpt.h

⌋(SRS_Gpt_12128)
[SWS_Gpt_00274] ⌈The function Gpt_StartTimer shall start the selected timer
channel with a defined target time. ⌋ (SRS_Gpt_12128)

[SWS_Gpt_00275] ⌈If configured and enabled, an interrupt notification or a wakeup

interrupt occurs, when the target time is reached. ⌋ (SRS_Gpt_12128)

[SWS_Gpt_00115] ⌈The function Gpt_StartTimer shall be reentrant, if the timer

channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00364] ⌈The state of the selected timer channel shall be changed to

"running" if Gpt_StartTimer is called. ⌋ ( )

[SWS_Gpt_00212] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration),
the function Gpt_StartTimer shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )

[SWS_Gpt_00218] ⌈If development error detection is enabled for GPT module:

The function Gpt_StartTimer shall raise the error GPT_E_PARAM_VALUE if the
parameter Value is "0" or not within the allowed range (exceeding the maximum
timer resolution). ⌋ (SRS_BSW_00323)

[SWS_Gpt_00224] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_StartTimer shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00084] ⌈If the function Gpt_StartTimer is called on a channel in state

"running", the function shall raise the runtime error GPT_E_BUSY. ⌋ ( )

39 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

8.3.7 Gpt_StopTimer

[SWS_Gpt_00285]⌈
Service Name Gpt_StopTimer

void Gpt_StopTimer (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x06

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value None

Description Stops a timer channel.

Available via Gpt.h

⌋(SRS_Gpt_12119)
[SWS_Gpt_00013] ⌈The function Gpt_StopTimer shall stop the selected timer
channel. ⌋ (SRS_Gpt_12119)

[SWS_Gpt_00343] ⌈The state of the selected timer channel shall be changed to

"stopped" if Gpt_StopTimer is called. ⌋ ( )

[SWS_Gpt_00099] ⌈If development error detection is enabled for GPT module:

If the function Gpt_StopTimer is called on a channel in state "initialized", "stopped"
or "expired", the function shall not raise a development error. ⌋ ( )

[SWS_Gpt_00344] ⌈If the function Gpt_StopTimer is called on a channel in state

"initialized", "stopped" or "expired", the function shall leave without any action (no
change of the channel state). ⌋ ( )

[SWS_Gpt_00116] ⌈The function Gpt_StopTimer shall be reentrant, if the timer

channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00213] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration),
the function Gpt_StopTimer shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )
40 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00225] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_StopTimer shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

8.3.8 Gpt_EnableNotification

[SWS_Gpt_00286]⌈
Service Name Gpt_EnableNotification

void Gpt_EnableNotification (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x07

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value None

Description Enables the interrupt notification for a channel (relevant in normal mode).

Available via Gpt.h

⌋(SRS_Gpt_12121)
[SWS_Gpt_00014] ⌈The function Gpt_EnableNotification shall enable the
interrupt notification of the referenced channel configured for notification (see also
SWS_Gpt_00233). The function shall save an attribute like "notification enabled" of
the channel. ⌋ (SRS_SPAL_00157, SRS_SPAL_12067, SRS_Gpt_12121)

Comment: This attribute affects the interrupt notification always when the driver is in
"normal mode". In "sleep mode" the attribute has no influence.

[SWS_Gpt_00117] ⌈The function Gpt_EnableNotification shall be reentrant, if

the timer channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00199] ⌈The function Gpt_EnableNotification shall be pre compile

time configurable On/Off by the configuration parameter:
GptEnableDisableNotificationApi. ⌋ (SRS_BSW_00171)

41 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00226] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_EnableNotification shall raise the
error GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00214] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by
configuration), the function Gpt_EnableNotification shall raise the error
GPT_E_PARAM_CHANNEL. ⌋ ( )

[SWS_Gpt_00377] ⌈If development error detection is enabled for GPT module:

If no valid notification function is configured (GptNotification), the function
Gpt_EnableNotification shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )

8.3.9 Gpt_DisableNotification

[SWS_Gpt_00287]⌈
Service Name Gpt_DisableNotification

void Gpt_DisableNotification (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x08

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value None

Description Disables the interrupt notification for a channel (relevant in normal mode).

Available via Gpt.h

⌋(SRS_Gpt_12122)
[SWS_Gpt_00015] ⌈The function Gpt_DisableNotification shall disable the
interrupt notification of the referenced channel configured for notification (see also
SWS_Gpt_00233). The function shall save an attribute like "notification disabled" of
the channel. ⌋ (SRS_SPAL_00157, SRS_Gpt_12122, SRS_SPAL_12067)

Comment: This attribute affects the interrupt notification always when the driver is in
"normal mode". In "sleep mode" the attribute has no influence.

42 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00118] ⌈The function Gpt_DisableNotification shall be reentrant,

if the timer channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00200] ⌈The function Gpt_DisableNotification shall be pre

compile time configurable On/Off by the configuration parameter:
GptEnableDisableNotificationApi. ⌋ (SRS_BSW_00171)

[SWS_Gpt_00227] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_DisableNotification shall raise
the error GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00217] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration),
the function Gpt_DisableNotification shall raise the error
GPT_E_PARAM_CHANNEL. ⌋ ( )

[SWS_Gpt_00379] ⌈If development error detection is enabled for GPT module:

If no valid notification function is configured (GptNotification), the function
Gpt_DisableNotification shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )

8.3.10 Gpt_SetMode

[SWS_Gpt_00288]⌈
Service Name Gpt_SetMode

void Gpt_SetMode (
Syntax Gpt_ModeType Mode
)

Service ID [hex] 0x09

Sync/Async Synchronous

Reentrancy Non Reentrant

GPT_MODE_NORMAL: Normal operation mode of the GPT driver.

GPT_MODE_SLEEP: Sleep mode of the GPT driver (wakeup
Parameters (in) Mode
capable).
See also Gpt_ModeType.

Parameters
None
(inout)

Parameters (out) None

Return value None

Description Sets the operation mode of the GPT.

43 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Available via Gpt.h

⌋(SRS_SPAL_12169, SRS_Gpt_13603)
[SWS_Gpt_00151] ⌈The function Gpt_SetMode shall set the operation mode of the
GPT driver to the given mode parameter. ⌋ (SRS_SPAL_12169, SRS_Gpt_13603)

[SWS_Gpt_00255] ⌈The function Gpt_SetMode is only available if the configuration

parameter GptReportWakeupSource is enabled. ⌋ ( )

[SWS_Gpt_00152] ⌈If the parameter Mode has the value GPT_MODE_NORMAL:

The function Gpt_SetMode shall enable the interrupt notification for all channels
which are configured for notification and the notification is enabled (stored attribute)
via the function Gpt_EnableNotification prior. All other interrupt notifications
shall be disabled. ⌋ (SRS_Gpt_13603)

[SWS_Gpt_00153] ⌈If the parameter Mode has the value GPT_MODE_SLEEP:

The function Gpt_SetMode shall enable the wakeup interrupts for all channels which
are configured for wakeup and the wakeup is enabled (stored attribute) via the
function Gpt_EnableWakeup prior. All other wakeup interrupts shall be disabled. ⌋
(SRS_Gpt_13603)

[SWS_Gpt_00164] ⌈If the function Gpt_SetMode is called with parameter Mode

has the value GPT_MODE_SLEEP: All timer channels in state "running" which are not
configured for wakeup or not enabled for wakeup interruption (stored attribute) via
Gpt_EnableWakeup shall be stopped and their state shall be changed to "stopped".
⌋()

[SWS_Gpt_00165] ⌈If the parameter Mode has the value GPT_MODE_NORMAL, the
function Gpt_SetMode shall not restart automatically the timer channels which have
been stopped by entering the sleep mode. ⌋ ( )

[SWS_Gpt_00341] ⌈If the parameter has the value GPT_MODE_SLEEP the function
Gpt_SetMode shall not start a wakeup timer automatically. First, the user shall call
Gpt_StartTimer to start a wakeup timer, after this the user shall call
Gpt_SetMode with parameter GPT_MODE_SLEEP. ⌋ ( )

[SWS_Gpt_00228] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_SetMode shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

44 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00231] ⌈If development error detection is enabled for GPT module:

The function Gpt_SetMode shall raise the error GPT_E_PARAM_MODE if the
parameter Mode is invalid. ⌋ ( )

[SWS_Gpt_00201] ⌈The function Gpt_SetMode shall be pre compile time

configurable On/Off by the configuration parameter:
GptWakeupFunctionalityApi. ⌋ (SRS_BSW_00171)

[SWS_Gpt_00392] ⌈If the parameter Mode has the value GPT_MODE_NORMAL:

If the driver is in “sleep mode”, the function Gpt_SetMode shall restart all enabled
GPT Predef Timers at value “0”. ⌋ (SRS_Gpt_13607)

[SWS_Gpt_00393] ⌈If the parameter Mode has the value GPT_MODE_SLEEP:

The function Gpt_SetMode shall stop all enabled GPT Predef Timers. ⌋
(SRS_Gpt_13607)

8.3.11 Gpt_DisableWakeup

[SWS_Gpt_00289]⌈
Service Name Gpt_DisableWakeup

void Gpt_DisableWakeup (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x0a

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value None

Description Disables the wakeup interrupt of a channel (relevant in sleep mode).

Available via Gpt.h

⌋(SRS_Gpt_13602)
[SWS_Gpt_00159] ⌈The function Gpt_DisableWakeup shall disable the wakeup
interrupt of the referenced channel configured for wakeup. The function shall save an
attribute like "wakeup disabled" of the channel.
45 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

Comment: This attribute affects the wakeup interrupt always when the driver is in
"sleep mode". In "normal mode" the attribute has no influence. ⌋ (SRS_Gpt_13602)

[SWS_Gpt_00157] ⌈The function Gpt_DisableWakeup is only feasible, if

GptReportWakeupSource is statically configured available. ⌋ ( )

[SWS_Gpt_00155] ⌈The function Gpt_DisableWakeup shall be reentrant, if the

timer channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00202] ⌈The function Gpt_DisableWakeup shall be pre compile time

configurable On/Off by the configuration parameter:
GptWakeupFunctionalityApi. ⌋ (SRS_BSW_00171)

[SWS_Gpt_00215] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration)
or channel wakeup is not enabled by configuration (GptEnableWakeup), the function
Gpt_DisableWakeup shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )

[SWS_Gpt_00229] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_DisableWakeup shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

8.3.12 Gpt_EnableWakeup

[SWS_Gpt_00290]⌈
Service Name Gpt_EnableWakeup

void Gpt_EnableWakeup (
Syntax Gpt_ChannelType Channel
)

Service ID [hex] 0x0b

Sync/Async Synchronous

Reentrancy Reentrant (but not for the same timer channel)

Parameters (in) Channel Numeric identifier of the GPT channel.

Parameters (inout) None

Parameters (out) None

Return value None

Description Enables the wakeup interrupt of a channel (relevant in sleep mode).

46 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Available via Gpt.h

⌋(SRS_Gpt_13602)
[SWS_Gpt_00160] ⌈The function Gpt_EnableWakeup shall enable the wakeup
interrupt of the referenced channel configured for wakeup. The function shall save an
attribute like "wakeup enabled" of the channel. ⌋ (SRS_Gpt_13602)

Comment: This attribute affects the wakeup interrupt always when the driver is in
"sleep mode". In "normal mode" the attribute has no influence.

[SWS_Gpt_00158] ⌈The function Gpt_EnableWakeup is only feasible, if

GptReportWakeupSource is statically configured available. ⌋ ( )

[SWS_Gpt_00156] ⌈The function Gpt_EnableWakeup shall be reentrant, if the

timer channels used in concurrent calls are different. ⌋ ( )

[SWS_Gpt_00203] ⌈The function Gpt_EnableWakeup shall be pre compile time

configurable On/Off by the configuration parameter:
GptWakeupFunctionalityApi. ⌋ (SRS_BSW_00171)

[SWS_Gpt_00230] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_EnableWakeup shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00216] ⌈If development error detection is enabled for GPT module:

If the parameter Channel is invalid (not within the range specified by configuration)
or channel wakeup is not enabled by configuration (GptEnableWakeup), the function
Gpt_EnableWakeup shall raise the error GPT_E_PARAM_CHANNEL. ⌋ ( )

8.3.13 Gpt_CheckWakeup

[SWS_Gpt_00328]⌈
Service Name Gpt_CheckWakeup

void Gpt_CheckWakeup (
Syntax EcuM_WakeupSourceType WakeupSource
)

Service ID
0x0c
[hex]

Sync/Async Synchronous

Reentrancy Reentrant

47 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Parameters Wakeup Information on wakeup source to be checked. The associated GPT

(in) Source channel can be determined from configuration data.

Parameters
None
(inout)

Parameters
None
(out)

Return value None

Checks if a wakeup capable GPT channel is the source for a wakeup event and
Description calls the ECU state manager service EcuM_SetWakeupEvent in case of a valid
GPT channel wakeup event.

Available via Gpt.h

⌋()
[SWS_Gpt_00321] ⌈The function Gpt_CheckWakeup shall check if a wakeup
capable GPT channel is the source for a wakeup event and call
EcuM_SetWakeupEvent to indicate a valid timer wakeup event to the ECU State
Manager [8]. ⌋ ( )

[SWS_Gpt_00322] ⌈The function Gpt_CheckWakeup is only feasible, if

GptReportWakeupSource is statically configured available. ⌋ ( )

[SWS_Gpt_00323] ⌈The function Gpt_CheckWakeup shall be reentrant, by reason

of possible usage in concurrent interrupt service routines. ⌋ ( )

[SWS_Gpt_00324] ⌈The function Gpt_CheckWakeup shall be pre compile time

configurable On/Off by the configuration parameter:
GptWakeupFunctionalityApi. ⌋ ( )

[SWS_Gpt_00325] ⌈If development error detection is enabled for GPT module:

If the driver is not initialized, the function Gpt_CheckWakeup shall raise the error
GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

8.3.14 Gpt_GetPredefTimerValue

[SWS_Gpt_00394]⌈
Service Name Gpt_GetPredefTimerValue

Std_ReturnType Gpt_GetPredefTimerValue (
Gpt_PredefTimerType PredefTimer,
Syntax
uint32* TimeValuePtr
)

48 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Service ID [hex] 0x0d

Sync/Async Synchronous

Reentrancy Reentrant

Parameters (in) PredefTimer GPT Predef Timer

Parameters (inout) None

Parameters (out) TimeValuePtr Pointer to time value destination data in RAM

E_OK: no error has been detected

Return value Std_ReturnType
E_NOT_OK: aborted due to errors

Description Delivers the current value of the desired GPT Predef Timer.

Available via Gpt.h

⌋(SRS_Gpt_13608)
Note:
It is strongly recommended to check the return value of the function
Gpt_GetPredefTimerValue on user software level. When E_NOT_OK is
returned the time value - pointed by TimeValuePtr - may be invalid and must not
be used.

[SWS_Gpt_00395] ⌈The function Gpt_GetPredefTimerValue shall return the

current value of the GPT Predef Timer passed by PredefTimer. ⌋
(SRS_Gpt_13608)

[SWS_Gpt_00396] ⌈If the timer value of the function Gpt_GetPredefTimerValue

is less than 32 bit (16bit or 24bit timer), the upper bits shall be filled with zero. ⌋ ( )

[SWS_Gpt_00397] ⌈The function Gpt_GetPredefTimerValue shall be fully

reentrant, this means even for the same GPT Predef Timer. ⌋ (SRS_Gpt_13608)

[SWS_Gpt_00402] ⌈If the GPT driver is not initialized, in “sleep mode” or the GPT
Predef Timer is not enabled, the function Gpt_GetPredefTimerValue shall
return E_NOT_OK. ⌋ (SRS_BSW_00406)

Note:
This is to inform user software if the hardware timer is not running, independent of
development error detection is enabled for GPT module enabled/disabled for the
GPT module. The function Gpt_GetPredefTimerValue is used by the Time
Service module which is part of the Services Layer. The user of the Time Service
module shall have a chance to cope with missed timer support.

49 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00398] ⌈If development error detection is enabled for GPT module: If the
driver is not initialized, the function Gpt_GetPredefTimerValue shall raise the
error GPT_E_UNINIT. ⌋ (SRS_BSW_00406)

[SWS_Gpt_00399] ⌈If development error detection is enabled for GPT module: If the
parameter PredefTimer is invalid, the function Gpt_GetPredefTimerValue
shall raise the development error GPT_E_PARAM_PREDEF_TIMER. ⌋
(SRS_BSW_00323)

[SWS_Gpt_00400] ⌈If development error detection is enabled for GPT module: If the
GPT Predef Timer passed by the parameter PredefTimer is not enabled, the
function Gpt_GetPredefTimerValue shall raise the development error
GPT_E_PARAM_PREDEF_TIMER. ⌋ ( )

[SWS_Gpt_00401] ⌈If the driver is in "sleep mode", the function

Gpt_GetPredefTimerValue shall raise the runtime error GPT_E_MODE.⌋ ( )

[SWS_Gpt_00403] ⌈If development error detection is enabled for GPT module: If the
parameter TimeValuePtr is a null pointer, the function
Gpt_GetPredefTimerValue shall raise the error GPT_E_PARAM_POINTER.⌋
(SRS_BSW_00369, SRS_BSW_00323)

8.4 Call-back Notifications

Since the GPT is a driver module it doesn’t provide any callback functions for lower
layer modules.

8.5 Scheduled functions

None.

8.6 Expected Interfaces

In this chapter all interfaces required from other modules are listed.

8.6.1 Mandatory Interfaces

This chapter defines all interfaces, which are required to fulfill the core functionality of
the module.
50 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_00405]⌈
API function Description
Det_ReportRuntimeError Service to report runtime errors.

⌋(SRS_SPAL_00157 , SRS_SPAL_12064)

8.6.2 Optional Interfaces

This chapter defines all interfaces, which are required to fulfill an optional
functionality of the module.

[SWS_Gpt_00406]⌈[]⌈
API Header
Description
Function File

Det_Report-
Det.h Service to report development errors.
Error

This function can be called to check the given wakeup sources. It will pass
EcuM_-
the argument to the integrator function EcuM_CheckWakeupHook. It can
Check- EcuM.h
also be called by the ISR of a wakeup source to set up the PLL and check
Wakeup
other wakeup sources that may be connected to the same interrupt.

EcuM_Set-
Wakeup- EcuM.h Sets the wakeup event.
Event

⌋()⌋(SRS_SPAL_00157)

[SWS_Gpt_00326] ⌈EcuM_CheckWakeup shall be called within the Interrupt Service

Routine, servicing the GPT channel wakeup event on wakeup-capable channels. ⌋ ( )

[SWS_Gpt_00327] ⌈The ISR´s, providing the wakeup events, shall be responsible

for resetting the interrupt flags (if needed by hardware). ⌋ (SRS_SPAL_12129)

8.6.3 Configurable Interfaces

In this chapter all interfaces are listed where the target function could be configured.
The target function is usually a call-back function. The names of these kinds of
interfaces is not fixed because they are configurable.

8.6.3.1 GPT Notification

[SWS_Gpt_00292]⌈

51 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Service Name Gpt_Notification_<channel>

void Gpt_Notification_<channel> (
Syntax void
)

Sync/Async Synchronous

Reentrancy GPT user implementation dependant.

Parameters (in) None

Parameters (inout) None

Parameters (out) None

Return value None

Description --

Available via Gpt.h

⌋(SRS_BSW_00375, SRS_SPAL_12069)

The notification prototype Gpt_Notification_<channel> is for the notification

callback function and shall be implemented by the user.

The GPT module’s environment shall declare a separate notification for each channel
to avoid parameters in notification services and to improve run time efficiency.

[SWS_Gpt_00086] ⌈The callback notifications Gpt_Notification_<channel>

shall be configurable as pointers to user defined functions within the configuration
structure. ⌋ ( )

[SWS_Gpt_00209] ⌈Each channel shall provide its own notification if configured. ⌋

(SRS_BSW_00375, SRS_SPAL_12069)

[SWS_Gpt_00093] ⌈When disabled, the GPT Driver will send no notification. ⌋ ( )

[SWS_Gpt_00233] ⌈The GPT Driver shall invoke a notification whenever the defined
target time of the channel is reached. ⌋ (SRS_SPAL_12067, SRS_Gpt_12120)

[SWS_Gpt_00206] ⌈The ISR´s, providing the timer events, shall be responsible for
resetting the interrupt flags (if needed by hardware) and calling the according
notification function. ⌋ (SRS_SPAL_12129)

[SWS_Gpt_00362] ⌈For all available channels, callback functions have to be

declared by the configuration tool. ⌋ ( )
52 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

8.7 Error detection

[SWS_Gpt_00332] ⌈If the GptDevErrorDetect switch is enabled:

When a development error occurs the corresponding GPT function shall skip the
desired functionality (leave service without any action). ⌋ (SRS_SPAL_12448)

53 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

9 Sequence diagrams
All functions except Gpt_Init, Gpt_DeInit, Gpt_GetVersionInfo and
Gpt_SetMode are synchronous and re-entrant.

9.1 Gpt_Init
The ECU State Manager (EcuM) is responsible for calling the init function.

«module» «module»
EcuM Gpt

Gpt_Init(const
Gpt_ConfigType*)

Gpt_Init()

Figure 6: Sequence Diagram - Gpt_Init

54 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

9.2 GPT continuous mode

Channel 2 is configured as “Continuous Mode”

Gpt User «module» «Peripheral»

Gpt GPT Hardware

Gpt_EnableNotification(Gpt_ChannelType)

Gpt_EnableNotification()

Gpt_StartTimer(Gpt_ChannelType,
Gpt_ValueType)
start Channel2
Gpt_StartTimer()
Timer has reached
target time (set by
Gpt_StartTimer) and
continuous running.

target time reached

1st time

Gpt_Notification_Channel2()

Gpt_Notification_Channel2()

Gpt_GetTimeElapsed(Gpt_ValueType,
Gpt_ChannelType): Gpt_ValueType read Channel2

Gpt_GetTimeElapsed()
Timer has reached
target time (set by
Gpt_StartTimer) and
continuous running.

target time reached

2nd time

Gpt_Notification_Channel2()

Gpt_Notification_Channel2()

Timer has reached

target time (set by
Gpt_StartTimer) and
continuous running.

target time reached

3rd time
Gpt_Notification_Channel2()

Gpt_Notification_Channel2()

Gpt_StopTimer(Gpt_ChannelType)

stop Channel2

Gpt_StopTimer()
Description:
Timer is stopped by the user.

Figure 7: Sequence Diagram - GPT continuous mode

55 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

9.3 GPT one-shot mode

Channel 1 is configured for “One-shot Mode”

Gpt User «module» «Peripheral»

Gpt GPT Hardware

Gpt_EnableNotification(Gpt_ChannelType)

Gpt_EnableNotification()

Gpt_StartTimer(Gpt_ChannelType,
Gpt_ValueType) start Channel1
Gpt_StartTimer()
Timer has reached target time
(set by Gpt_StartTimer)

timer expired

Gpt_Notification_Channel1()

Gpt_Notification_Channel1()

Note:
Notification can be used to start the timer again

Gpt_StartTimer(Gpt_ChannelType,
Gpt_ValueType)
start Channel1

Gpt_StartTimer()

Gpt_GetTimeRemaining(Gpt_ValueType,
Gpt_ChannelType): Gpt_ValueType
read Channel1

Gpt_GetTimeRemaining()

Gpt_StopTimer(Gpt_ChannelType)
stop Channel1

Gpt_StopTimer()
Description:
Timer is stopped by the user
Gpt_DeInit()
before the timer has expired

Gpt_DeInit()

Figure 8: Sequence Diagram - GPT one-shot mode

9.4 Disable/Enable Notifications

The sequence diagram shown in this chapter explains the behavior of the driver,
when the notification is disabled, while the timer is still running in continuous mode. If
56 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

the notification is disabled, the user will not be informed, when the timer reaches the
target time the 2nd time (period 2).
This notification is discarded and not made up again, when the notification is re-
enabled.

Gpt User «module» «Peripheral»

Gpt GPT Hardware

Gpt_EnableNotification(Gpt_ChannelType)

Gpt_EnableNotification()

Gpt_StartTimer(Gpt_ChannelType,
Gpt_ValueType)
start Channel
Gpt_StartTimer()

Timer has reached

target time (set by
Gpt_StartTimer) and
continuous running.

target time reached

1st time (period 1)
Gpt_Notification_<channel>()

Gpt_Notification_<channel>()

Gpt_DisableNotification(Gpt_ChannelType)
Timer has reached
target time (set by
Description: Gpt_DisableNotification() Gpt_StartTimer) and
Notification is disabled, no
continuous running.
notification is performed.

target time reached

2nd time (period 2)

Description:
Gpt_EnableNotification(Gpt_ChannelType)
Notification for period 2 is discarded.
Timer has reached
Gpt_EnableNotification() target time (set by
Gpt_StartTimer) and
continuous running.

target time reached

Gpt_Notification_<channel>() 3rd time (period 3)

Gpt_Notification_<channel>()

Description:
Notification is re-enabled.
Notification for period 3 will be
performed.

Figure 9: Sequence Diagram - Disable/Enable Notifications

9.5 Wakeup

57 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Note: Sequence charts on timer wakeup can be found in the ECU state manager
specification [8].

58 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

10 Configuration specification
In general, this chapter defines configuration parameters and their clustering into
containers. In order to support the specification Chapter 10.1 describes
fundamentals. It also specifies a template (table) you shall use for the parameter
specification. We intend to leave Chapter 10.1 in the specification to guarantee
comprehension.

Chapter 10.2 specifies the structure (containers) and the parameters of the module
GPT

Chapter 10.3 specifies published information of the module GPT

10.1 How to read this chapter

For details refer to the chapter 10.1 “Introduction to configuration specification” in
SWS_BSWGeneral.

59 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

10.2 Containers and configuration parameters

The following chapters summarize all configuration parameters. The detailed
meanings of the parameters describe Chapter 7 and Chapter 8.

[SWS_Gpt_00407] ⌈The GPT module shall reject configurations with partition

mappings which are not supported by the implementation.⌋()

10.2.1 Gpt

SWS Item [ECUC_Gpt_00336]

Module Name Gpt

Description Configuration of the Gpt (General Purpose Timer) module.

Post-Build Variant Support true

Supported Config Variants VARIANT-POST-BUILD, VARIANT-PRE-COMPILE

Included Containers

Container Name Multiplicity Scope / Dependency

This container is the base of a Configuration Set which contains

GptChannelConfig-
1 the configured GPT channels. This way, different configuration
Set
sets can be defined for post-build process.

GptConfigurationOf- This container contains all configuration switches for configuring

1
OptApiServices optional API services of the GPT driver.

GptDriver- This container contains the module-wide configuration

1
Configuration (parameters) of the GPT Driver

10.2.2 GptDriverConfiguration

SWS Item [ECUC_Gpt_00183]

Container Name GptDriverConfiguration

Parent
Gpt
Container

This container contains the module-wide configuration (parameters) of the GPT

Description
Driver

Configuration Parameters

60 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

SWS Item [ECUC_Gpt_00321]

Parameter Name GptDevErrorDetect

Parent Container GptDriverConfiguration

Switches the development error detection and notification on or off.

Description  true: detection and notification is enabled.

 false: detection and notification is disabled.

Multiplicity 1

Type EcucBooleanParamDef

Default value false

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00335]

Parameter Name GptPredefTimer100us32bitEnable

Parent Container GptDriverConfiguration

Description Enables/disables the GPT Predef Timer 100µs32bit.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: ECU

SWS Item [ECUC_Gpt_00334]

Parameter Name GptPredefTimer1usEnablingGrade

Parent Container GptDriverConfiguration

61 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Specifies the grade of enabling the GPT Predef Timers with 1µs tick
Description
duration.

Multiplicity 1

Type EcucEnumerationParamDef

GPT_PREDEF_TIMER_1US_16BIT_ENABLED 16bit timer enabled

GPT_PREDEF_TIMER_1US_16_24BIT_ 16 and 24bit timers

ENABLED enabled
Range
GPT_PREDEF_TIMER_1US_16_24_32BIT_ 16, 24 and 32bit timers
ENABLED enabled

GPT_PREDEF_TIMER_1US_DISABLED disabled

Post-Build Variant
false
Value

Pre-compile time X All Variants

Value Configuration
Link time --
Class
Post-build time --

Scope / Dependency scope: ECU

SWS Item [ECUC_Gpt_00322]

Parameter Name GptReportWakeupSource

Parent Container GptDriverConfiguration

Description Enables/Disables wakeup source reporting.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00337]

Parameter Name GptEcucPartitionRef

Parent Container GptDriverConfiguration

Description Maps the GPT driver to zero or multiple ECUC partitions to make the driver
62 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

API available in the according partition. Depending on the addressed timer

resource the interfaces operate as follows:
a) In case of partition local timer resources (n:1 mapping) the API operates as
an independent instance in the according ECUC partition.
b) In case of global timer resources (1:m mapping) the API operates on the
global timer resource either by protected access to the resource or by
implementing an according kernel.

Multiplicity 0..*

Type Reference to EcucPartition

Post-Build Variant
true
Multiplicity

Post-Build Variant
true
Value

Pre-compile time X All Variants

Multiplicity
Configuration Link time --
Class
Post-build time --

Pre-compile time X All Variants

Value
Configuration Link time --
Class
Post-build time --

Scope /
scope: ECU
Dependency

SWS Item [ECUC_Gpt_00338]

Parameter Name GptKernelEcucPartitionRef

Parent Container GptDriverConfiguration

Maps the GPT kernel to zero or one ECUC partitions to assign the driver
kernel to a certain core. The ECUC partition referenced is a subset of the
Description ECUC partitions where the GPT driver is mapped to.
Note: The kernel reference shall not be set in case the GPT driver is
implemented without a kernel (refer to definition of GptEcucPartitionRef).

Multiplicity 0..1

Type Reference to EcucPartition

Post-Build Variant
true
Multiplicity

Post-Build Variant
true
Value

Pre-compile time X All Variants

Multiplicity
Configuration Link time --
Class
Post-build time --
63 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

Pre-compile time X All Variants

Value
Configuration Link time --
Class
Post-build time --

Scope /
scope: ECU
Dependency

Included Containers

Container
Multiplicity Scope / Dependency
Name

This container contains a parameter, which represents a reference

GptClock-
1..* to a container of the type McuClockReferencePoint (defined in
ReferencePoint
module MCU).

HW
Configurator 1 Tick  x s
Description

I/O Hardware
OS
Prescaler value Abstraction

Ticks

MCU Driver GPT Driver

Configuration of Configuration of
shared resources GPT resources
Init

µC
Module1 HW

GPT
PLL Prescaler GPT HW
Prescaler

Module2 HW

Figure 10: Scope of the GPT Driver configuration

64 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_CONSTR_00001] ⌈ The ECUC partitions referenced by

GptKernelEcucPartitionRef shall be a subset of the ECUC partitions referenced by
GptEcucPartitionRef.⌋()
[SWS_Gpt_CONSTR_00003] ⌈ If GptEcucPartitionRef references one or more
ECUC partitions, GptKernelEcucPartitionRef shall have a multiplicity of one and
reference one of these ECUC partitions as well.⌋()
[SWS_Gpt_CONSTR_00005] ⌈ In case of partition local timer resources, the module
will operate as an independent instance in each of the partitions, means the called
API will only target the partition it is called in.⌋()

10.2.3 GptClockReferencePoint

SWS Item [ECUC_Gpt_00329]

Container
GptClockReferencePoint
Name

Parent
GptDriverConfiguration
Container

This container contains a parameter, which represents a reference to a container of

Description the type McuClockReferencePoint (defined in module MCU). A container is needed
to support multiple clock references (hardware dependent).

Configuration Parameters

SWS Item [ECUC_Gpt_00330]

Parameter
GptClockReference
Name

Parent
GptClockReferencePoint
Container

Reference to a container of the type McuClockReferencePoint, to select an input

clock.
The configuration editor for the GPT module can support the integrator by only
Description allowing a selection of those clock reference points that can be connected
physically to the GPT hardware peripheral. The desired frequency (desired by
GPT) has to be the same as the selected and provided frequency of the MCU
configuration. This has to be checked automatically.

Multiplicity 1

Type Reference to McuClockReferencePoint

Post-Build
false
Variant Value

Value Pre-compile time X All Variants

65 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Configuration Link time --

Class
Post-build time --

Scope /
scope: local
Dependency

No Included Containers

10.2.4 GptChannelConfigSet

SWS Item [ECUC_Gpt_00269]

Container
GptChannelConfigSet
Name

Parent
Gpt
Container

This container is the base of a Configuration Set which contains the configured GPT
Description channels. This way, different configuration sets can be defined for post-build
process.

Configuration Parameters

Included Containers

Container Name Multiplicity Scope / Dependency

GptChannel- This container contains the channel specific configuration of

1..*
Configuration the GPT Driver.

10.2.5 GptChannelConfiguration

SWS Item [ECUC_Gpt_00184]

Container Name GptChannelConfiguration

Parent Container GptChannelConfigSet

Description Configuration of an individual GPT channel.

Configuration Parameters

SWS Item [ECUC_Gpt_00308]

Parameter Name GptChannelId

66 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Parent Container GptChannelConfiguration

Channel Id of the GPT channel. This value will be assigned to the symbolic
Description
name derived of the GptChannelConfiguration container short name.

Multiplicity 1

Type EcucIntegerParamDef (Symbolic Name generated for this parameter)

Range 0 .. 4294967295

Default value --

Post-Build Variant
false
Value

Pre-compile time X All Variants

Value
Configuration Link time --
Class
Post-build time --

Scope /
scope: ECU
Dependency

SWS Item [ECUC_Gpt_00309]

Parameter Name GptChannelMode

Parent Container GptChannelConfiguration

Description Specifies the behavior of the timer channel after the target time is reached.

Multiplicity 1

Type EcucEnumerationParamDef

GPT_CH_MODE_ After reaching the target time, the timer

CONTINUOUS continues running with the value "zero" again.
Range
GPT_CH_MODE_ After reaching the target time, the timer stops
ONESHOT automatically (timer expired).

Post-Build Variant
true
Value

Pre-compile time X VARIANT-PRE-COMPILE

Value
Configuration Link time --
Class
Post-build time X VARIANT-POST-BUILD

Scope /
scope: ECU
Dependency

SWS Item [ECUC_Gpt_00331]

Parameter Name GptChannelTickFrequency

67 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Parent Container GptChannelConfiguration

Description Specifies the tick frequency of the timer channel in Hz.

Multiplicity 1

Type EcucFloatParamDef

Range [0 .. INF]

Default value --

Post-Build Variant Value true

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration Class Link time --

Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: ECU

SWS Item [ECUC_Gpt_00332]

Parameter Name GptChannelTickValueMax

Parent Container GptChannelConfiguration

Maximum value in ticks, the timer channel is able to count. With the next tick,
Description
the timer rolls over to zero.

Multiplicity 1

Type EcucIntegerParamDef

Range 0 .. 18446744073709551615

Default value --

Post-Build Variant
true
Value

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration
Link time --
Class
Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: ECU

SWS Item [ECUC_Gpt_00311]

Parameter Name GptEnableWakeup

Parent Container GptChannelConfiguration

Description Enables wakeup capability of MCU for a channel.

Multiplicity 1
68 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value true

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration Class Link time --

Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00312]

Parameter Name GptNotification

Parent Container GptChannelConfiguration

Description Function pointer to callback function (for non-wakeup notification)

Multiplicity 0..1

Type EcucFunctionNameDef

Default value --

Regular Expression --

Post-Build Variant Multiplicity true

Post-Build Variant Value true

Pre-compile time X VARIANT-PRE-COMPILE

Multiplicity Configuration Class Link time --

Post-build time X VARIANT-POST-BUILD

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration Class Link time --

Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00333]

Parameter Name GptChannelClkSrcRef

Parent Container GptChannelConfiguration

Reference to the GptClockReferencePoint from which the channel clock

Description
is derived.

Multiplicity 1

69 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Type Reference to GptClockReferencePoint

Post-Build Variant
true
Value

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration
Link time --
Class
Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00339]

Parameter Name GptChannelEcucPartitionRef

Parent Container GptChannelConfiguration

Maps a GPT channel to zero or multiple ECUC partitions to limit the access to
Description this channel group. The ECUC partitions referenced are a subset of the ECUC
partitions where the GPT driver is mapped to.

Multiplicity 0..*

Type Reference to EcucPartition

Post-Build Variant
true
Multiplicity

Post-Build Variant
true
Value

Pre-compile time X All Variants

Multiplicity
Configuration Link time --
Class
Post-build time --

Pre-compile time X All Variants

Value
Configuration Link time --
Class
Post-build time --

Scope /
scope: ECU
Dependency

Included Containers

Container Name Multiplicity Scope / Dependency

GptWakeup- Function pointer to callback function (for non-wakeup

0..1
Configuration notification).

70 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

[SWS_Gpt_CONSTR_00002] ⌈The ECUC partitions referenced by

GptGroupEcucPartitionRef shall be a subset of the ECUC partitions referenced by
GptEcucPartitionRef.⌋()
[SWS_Gpt_CONSTR_00004] ⌈If GptEcucPartitionRef references one or more ECUC
partitions, GptKernelEcucPartitionRef shall have a multiplicity of greater than zero
and reference one or several of these ECUC partitions as well.⌋()

10.2.6 GptWakeupConfiguration

SWS Item [ECUC_Gpt_00235]

Container Name GptWakeupConfiguration

Parent Container GptChannelConfiguration

Description Function pointer to callback function (for wakeup notification).

Configuration Parameters

SWS Item [ECUC_Gpt_00313]

Parameter Name GptWakeupSourceRef

Parent Container GptWakeupConfiguration

In case the wakeup-capability is true this value is transmitted to the Ecu

Description State Manager.
Implementation Type: reference to EcuM_WakeupSourceType

Multiplicity 1

Type Symbolic name reference to EcuMWakeupSource

Post-Build Variant
true
Value

Pre-compile time X VARIANT-PRE-COMPILE

Value Configuration
Link time --
Class
Post-build time X VARIANT-POST-BUILD

Scope / Dependency scope: local

No Included Containers

71 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

10.2.7 GptConfigurationOfOptApiServices

SWS Item [ECUC_Gpt_00193]

Container
GptConfigurationOfOptApiServices
Name

Parent
Gpt
Container

This container contains all configuration switches for configuring optional API
Description
services of the GPT driver.

Configuration Parameters

SWS Item [ECUC_Gpt_00314]

Parameter Name GptDeinitApi

Parent Container GptConfigurationOfOptApiServices

Description Adds / removes the service Gpt_DeInit() from the code.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00315]

Parameter Name GptEnableDisableNotificationApi

Parent Container GptConfigurationOfOptApiServices

Adds / removes the services Gpt_EnableNotification() and Gpt_Disable

Description
Notification from the code.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant
false
Value

Value Configuration Pre-compile time X All Variants

72 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00317]

Parameter Name GptTimeElapsedApi

Parent Container GptConfigurationOfOptApiServices

Description Adds / removes the service Gpt_GetTimeElapsed() from the code

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00318]

Parameter Name GptTimeRemainingApi

Parent Container GptConfigurationOfOptApiServices

Description Adds / removes the service Gpt_GetTimeRemaining() from the code.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00319]

Parameter Name GptVersionInfoApi

73 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

Parent Container GptConfigurationOfOptApiServices

Description Adds / removes the service Gpt_GetVersionInfo() from the code.

Multiplicity 1

Type EcucBooleanParamDef

Default value false

Post-Build Variant Value false

Pre-compile time X All Variants

Value Configuration Class Link time --

Post-build time --

Scope / Dependency scope: local

SWS Item [ECUC_Gpt_00320]

Parameter Name GptWakeupFunctionalityApi

Parent Container GptConfigurationOfOptApiServices

Adds / removes the services Gpt_SetMode(), Gpt_EnableWakeup() Gpt_

Description
DisableWakeup() and Gpt_CheckWakeup() from the code.

Multiplicity 1

Type EcucBooleanParamDef

Default value --

Post-Build Variant
false
Value

Pre-compile time X All Variants

Value
Configuration Link time --
Class
Post-build time --

Scope /
scope: local
Dependency

No Included Containers

10.3 Published Information

[SWS_Gpt_00380] ⌈The standardized common published parameters as required by

SRS_BSW_00402 in the SRS General on Basic Software Modules [3] shall be
published within the header file of this module and need to be provided in the BSW
74 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver
 Specification of GPT Driver
AUTOSAR CP R22-11

Module Description. The according module abbreviation can be found in the List of
Basic Software Modules [1]. ⌋ ( )

Additional module-specific published parameters are listed below if applicable.

75 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver

 Specification of GPT Driver
AUTOSAR CP R22-11

11 Not applicable requirements

[SWS_Gpt_NA_00381] ⌈These requirements are not applicable to this
specification.⌋ (SRS_BSW_00344, SRS_BSW_00159, SRS_BSW_00167,
SRS_BSW_00170, SRS_BSW_00398, SRS_BSW_00416, SRS_BSW_00437,
SRS_BSW_00168, SRS_BSW_00423, SRS_BSW_00424, SRS_BSW_00425,
SRS_BSW_00426, SRS_BSW_00427, SRS_BSW_00428, SRS_BSW_00429,
SRS_BSW_00432, SRS_BSW_00433, SRS_BSW_00422, SRS_BSW_00417,
SRS_BSW_00161, SRS_BSW_00162, SRS_BSW_00005, SRS_BSW_00415,
SRS_BSW_00325, SRS_BSW_00342, SRS_BSW_00160, SRS_BSW_00007,
SRS_BSW_00413, SRS_BSW_00347, SRS_BSW_00307, SRS_BSW_00373,
SRS_BSW_00335, SRS_BSW_00348, SRS_BSW_00353, SRS_BSW_00328,
SRS_BSW_00006, SRS_BSW_00439, SRS_BSW_00357, SRS_BSW_00377,
SRS_BSW_00378, SRS_BSW_00306, SRS_BSW_00308, SRS_BSW_00309,
SRS_BSW_00359, SRS_BSW_00360, SRS_BSW_00440, SRS_BSW_00330,
SRS_BSW_00331, SRS_BSW_00009, SRS_BSW_00172, SRS_BSW_00010,
SRS_BSW_00333, SRS_BSW_00321, SRS_BSW_00341, SRS_BSW_00334 ,
SRS_SPAL_12462, SRS_SPAL_12463, SRS_SPAL_12068, SRS_SPAL_12075,
SRS_SPAL_12064, SRS_SPAL_12077, SRS_SPAL_12078, SRS_SPAL_12092,
SRS_SPAL_12265)

76 of 76 Document ID 30: AUTOSAR_SWS_GPTDriver