Microcontrollers
AURIX
Microcontroller Infineon Software Architecture
User’s Manual
GTM Driver
Released V3.8
2015-08
Edition 2015-08
Published by
Infineon Technologies AG
81726 Munich, Germany
© 2016 Infineon Technologies AG
All Rights Reserved.
LEGAL DISCLAIMER
THE INFORMATION GIVEN IN THIS DOCUMENT IS GIVEN AS A HINT FOR THE IMPLEMENTATION OF
THE INFINEON TECHNOLOGIES COMPONENT ONLY AND SHALL NOT BE REGARDED AS ANY
DESCRIPTION OR WARRANTY OF A CERTAIN FUNCTIONALITY, CONDITION OR QUALITY OF THE
INFINEON TECHNOLOGIES COMPONENT. THE RECIPIENT OF THIS DOCUMENT MUST VERIFY ANY
FUNCTION DESCRIBED HEREIN IN THE REAL APPLICATION. INFINEON TECHNOLOGIES HEREBY
DISCLAIMS ANY AND ALL WARRANTIES AND LIABILITIES OF ANY KIND (INCLUDING WITHOUT
LIMITATION WARRANTIES OF NON-INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OF ANY
THIRD PARTY) WITH RESPECT TO ANY AND ALL INFORMATION GIVEN IN THIS DOCUMENT.
Information
For further information on technology, delivery terms and conditions and prices, please contact the nearest
Infineon Technologies Office (www.infineon.com).
Warnings
Due to technical requirements, components may contain dangerous substances. For information on the
types in question, please contact the nearest Infineon Technologies Office.
Infineon Technologies components may be used in life-support devices or systems only with the express
written approval of Infineon Technologies, if a failure of such components can reasonably be expected to
cause the failure of that life-support device or system or to affect the safety or effectiveness of that device or
system. Life support devices or systems are intended to be implanted in the human body or to support and/or
maintain and sustain and/or protect human life. If they fail, it is reasonable to assume that the health of the
user or other persons may be endangered.
MC-ISAR
AURIX
CONFIDENTIAL
User’s Manual 3 Released V3.8, 2015-08
GTM Driver
Date
Version
Change Description
2016-08-10
3.8
Updated based on review comments RE_010594.
2016-08-04
3.7
Updated limitation section for Mcfg configuration.
2016-06-09
3.6
Updated based on review comments Rev_010071
2016-05-11
3.5
Updated based on JIRA 0000051261-231
- Updated File structure in section 3
- Updated I/O mode in section 5.2
- Updated the source for API’s in section 5.2
2015-11-20
3.4
Modified section 4.2.10, 4.2.11, 5.2.54, 5.2.55, 5.2.66 for
0000051100-202. Modified the multiplicity for TC29x and added
ModuleNumber input parameter for all FIFO APIs.
2015-10-08
3.3
Added recommended mode of interrupt to all sub peripheral
interrupt mode.
Modified IO mode for APIs for user-1 mode/ supervisory mode
implementation.
Modified Service ID and SAFE MCAL ERROR for
Gtm_IsrTomModule, Gtm_IsrAtomModule and Gtm_IsrTimModule.
2015-09-07
3.2
Modified return type of Gtm_Init.
2015-05-28
3.1
Updated caveats for Gtm_FlushFifo, Gtm_InitDpllRam,
Gtm_ClearMcsRam and Gtm_Init.
2015-05-18
3.0
Added limitation for GtmConfiguration container name.
2015-04-22
2.9
Supported features for Gtm_DeInit and McuDeInitApi.
2014-11-06
2.8
Inserted I/O Mode for all the API functions.
2014-08-26
2.7
Changes as per REV_006124.
2014-08-12
2.6
Added changes specific to AI00238938. (Separate configurability
supported for ATOM ccu0 and ccu1)
2014-07-14
2.5
Removed reference for software safety information document.
2014-03-26
2.4
Modified reference for software safety information document.
2014-02-28
2.3
Added EP changes.
2014-02-07
2.2
Modified TIM/TOM/ATOM notifications (added 4
th
param). UTP
(AI00237990)
2013-11-14
2.1
Added modified SFR’s to the configuration parameters.
2013-09-25
2.0
Modified ISR’s, InitCheck and Changed assumptions and
deviations sections.
Changes for UTP [AI00231910]
2013-08-23
1.9
Added ISR’s to the section 5.3
2013-08-22
1.8
Changed assumptions and deviations sections.
2013-08-20
1.7
changes as per AI00172352
Added safety changes.
2013-06-27
1.6
Updated for TC26x changes.
2013-04-02
1.5
Modified as per review [REV_004404 ]
2013-03-19
1.4
Added B-step changes
2012-04-07
1.3
Errata information updated
2012-12-06
1.2
Minor formal changes
2012-14-05
1.1
Updated for TC27x
New API’s included
MC-ISAR
AURIX
CONFIDENTIAL
User’s Manual 4 Released V3.8, 2015-08
GTM Driver
Date
Version
Change Description
Few API’s removed
ISR concept modified. Channel Notification concept introduced.
2011-13-10
1.0
Document Refined
2011-03-22
0.1
Initial Version
We Listen to Your Comments
Is there any information in this document that you feel is wrong, unclear or missing?
Your feedback will help us to continuously improve the quality of this document.
Please send your proposal (including a reference to this document) to:
mcdocu.comments@infineon.com
MC-ISAR
AURIX
Table of Contents Page
User’s Manual 5 Released V3.8, 2015-08
GTM Driver
1 Introduction ................................................................................................................................. 20
1.1 Scope ............................................................................................................................................ 20
1.2 Abbreviations................................................................................................................................. 20
1.3 References .................................................................................................................................... 21
2 GTM Driver Overview .................................................................................................................. 21
2.1 Hardware Software Mapping ......................................................................................................... 21
2.1.1 GTM .............................................................................................................................................. 22
2.1.2 Multiplexer Programming .............................................................................................................. 24
2.1.2.1 Multiplexing for On-Chip Trigger and Inter Module connections ................................................... 24
2.1.3 System Clock ................................................................................................................................ 25
2.1.4 Port ................................................................................................................................................ 25
2.1.5 Irq .................................................................................................................................................. 25
2.2 Software Driver Description .......................................................................................................... 25
3 File Structure ............................................................................................................................... 33
4 Configuration Documentation ................................................................................................... 35
4.1 Configuration Concept .................................................................................................................. 35
4.1.1 Configuration Class ....................................................................................................................... 35
4.1.2 Configuration Variant .................................................................................................................... 35
4.1.3 How to read the Configuration Class field ..................................................................................... 35
4.2 Container:GtmConfiguration ......................................................................................................... 36
4.2.1 Container: GtmGeneral ................................................................................................................. 36
4.2.1.1 GtmGeneral ................................................................................................................................... 36
4.2.1.2 GtmGlobalClkDivNumerator .......................................................................................................... 37
4.2.1.3 GtmGlobalClkDivDenominator ...................................................................................................... 37
4.2.1.4 GtmEnRstAndForceIntFunctionality .............................................................................................. 38
4.2.2 Container: GtmAeiInterface ........................................................................................................... 38
4.2.2.1 GtmAeiTimeOutMode ................................................................................................................... 38
4.2.2.2 GtmAeiTimeOutValue ................................................................................................................... 39
4.2.2.3 GtmAeiTimeoutExceptionIntEn ..................................................................................................... 39
4.2.2.4 GtmAeiUnsupportedAddressIntEn ................................................................................................ 40
4.2.2.5 GtmAeiIllegalModuleAddIntEn ...................................................................................................... 40
4.2.2.6 GtmAeiUnsupportedByteEnIntEn.................................................................................................. 41
4.2.2.7 GtmAeiInterruptMode .................................................................................................................... 43
4.2.3 Container: Cmu ............................................................................................................................. 44
4.2.3.1 Container: CmuFixedClock ........................................................................................................... 44
4.2.3.2 Container: CmuConfigurableClock ............................................................................................... 46
4.2.3.3 Container: CmuExternalClock ....................................................................................................... 54
4.2.4 Container: Tbu............................................................................................................................... 58
4.2.4.1 Container: TbuChannel ................................................................................................................. 58
4.2.5 Container: Tom.............................................................................................................................. 61
4.2.5.1 Container: TomTriggersForTgc ..................................................................................................... 61
4.2.5.2 Container: TomChannel ................................................................................................................ 66
4.2.6 Container: Atom ............................................................................................................................ 81
4.2.6.1 Container: AtomTriggerForAgc ..................................................................................................... 81
4.2.6.2 Container: AtomChannel ............................................................................................................... 86
4.2.7 Container: Tim ............................................................................................................................. 105
4.2.7.1 Container: TimChannel ............................................................................................................... 105
4.2.8 Container: Aru ............................................................................................................................. 125
4.2.8.1 Container: AruInterrupt ................................................................................................................ 125
4.2.9 Container: Brc ............................................................................................................................. 127
4.2.9.1 Container: BrcChannel ................................................................................................................ 127
4.2.9.2 Container: BrcInterrupt ................................................................................................................ 138
4.2.9.3 Container: BrcErrorInterrupt ........................................................................................................ 144
4.2.10 Container: Fifo ............................................................................................................................. 150
4.2.10.1 Container: FifoChannel ............................................................................................................... 150
4.2.11 Container: F2a............................................................................................................................. 160