include/Gpt.h

   1 /* -------------------------------- Arctic Core ------------------------------\r
   2  * Arctic Core - the open source AUTOSAR platform http://arccore.com\r
   3  *\r
   4  * Copyright (C) 2009  ArcCore AB <contact@arccore.com>\r
   5  *\r
   6  * This source code is free software; you can redistribute it and/or modify it\r
   7  * under the terms of the GNU General Public License version 2 as published by the\r
   8  * Free Software Foundation; See <http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt>.\r
   9  *\r
  10  * This program is distributed in the hope that it will be useful, but\r
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\r
  12  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License\r
  13  * for more details.\r
  14  * -------------------------------- Arctic Core ------------------------------*/\r
  15 \r
  16 /** @addtogroup Gpt GPT Driver\r
  17  *  @{ */\r
  18 \r
  19 /** @file Gpt.h\r
  20  * API and type definitions for GPT Driver.\r
  21  */\r
  22 \r
  23 #ifndef GPT_H_\r
  24 #define GPT_H_\r
  25 \r
  26 #include "Std_Types.h"\r
  27 //#include "EcuM.h"  mahi: What for ???\r
  28 \r
  29 /** @name Error Codes */\r
  30 //@{\r
  31 #define GPT_E_UNINIT                        0x0a\r
  32 #define GPT_E_BUSY                                                0x0b\r
  33 #define GPT_E_NOT_STARTED                                   0x0c\r
  34 #define GPT_E_ALREADY_INITIALIZED           0x0d\r
  35 #define GPT_E_PARAM_CHANNEL                 0x14\r
  36 #define GPT_E_PARAM_VALUE                                   0x15\r
  37 #define GPT_E_PARAM_MODE                                      0x1f\r
  38 #define GPT_E_PARAM_CONFIG                  0x0e // TODO: Not in spec. Find real value\r
  39 //@}\r
  40 \r
  41 /** @name Service id's */\r
  42 //@{\r
  43 #define GPT_INIT_SERVICE_ID                 0x01\r
  44 #define GPT_DEINIT_SERVICE_ID               0x02\r
  45 #define GPT_GETTIMEELAPSED_SERVICE_ID       0x03\r
  46 #define GPT_GETTIMEREMAINING_SERVICE_ID     0x04\r
  47 #define GPT_STARTTIMER_SERVICE_ID           0x05\r
  48 #define GPT_STOPTIMER_SERVICE_ID            0x06\r
  49 #define GPT_ENABLENOTIFICATION_SERVICE_ID   0x07\r
  50 #define GPT_DISABLENOTIFICATION_SERVICE_ID  0x08\r
  51 #define GPT_SETMODE_SERVIVCE_ID             0x09\r
  52 #define GPT_DISABLEWAKEUP_SERVICE_ID        0x0a\r
  53 #define GPT_ENABLEWAKEUP_SERVICE_ID         0x0b\r
  54 #define GPT_CBK_CHECKWAKEUP_SERVICE_ID      0x0c\r
  55 //@}\r
  56 \r
  57 /** Channel id type */\r
  58 typedef uint8_t Gpt_ChannelType;\r
  59 \r
  60 /** Channel time value type */\r
  61 typedef uint32_t Gpt_ValueType;\r
  62 \r
  63 /** Channel behavior */\r
  64 typedef enum\r
  65 {\r
  66   GPT_MODE_ONESHOT=0,\r
  67   GPT_MODE_CONTINUOUS\r
  68 } Gpt_ChannelMode;\r
  69 \r
  70 typedef enum\r
  71 {\r
  72   GPT_MODE_NORMAL=0,\r
  73   GPT_MODE_SLEEP\r
  74 } Gpt_ModeType;\r
  75 \r
  76 \r
  77 #define GPT_VENDOR_ID             1\r
  78 #define GPT_MODULE_ID                    1\r
  79 \r
  80 #define GPT_SW_MAJOR_VERSION    1\r
  81 #define GPT_SW_MINOR_VERSION    0\r
  82 #define GPT_SW_PATCH_VERSION    1\r
  83 \r
  84 #define GPT_AR_MAJOR_VERSION     2\r
  85 #define GPT_AR_MINOR_VERSION     2\r
  86 #define GPT_AR_PATCH_VERSION     1\r
  87 \r
  88 #include "Gpt_Cfg.h"\r
  89 \r
  90 #if (GPT_VERSION_INFO_API == STD_ON)\r
  91 #define Gpt_GetVersionInfo(_vi) STD_GET_VERSION_INFO(_vi,GPT)\r
  92 #endif\r
  93 \r
  94 void Gpt_Init( const Gpt_ConfigType * );\r
  95 \r
  96 #if GPT_DEINIT_API == STD_ON\r
  97 void Gpt_DeInit( void );\r
  98 #endif\r
  99 \r
 100 #if ( GPT_TIME_ELAPSED_API == STD_ON )\r
 101 Gpt_ValueType Gpt_GetTimeElapsed(Gpt_ChannelType channel);\r
 102 #endif\r
 103 \r
 104 #if ( GPT_TIME_REMAINING_API == STD_ON )\r
 105 Gpt_ValueType Gpt_GetTimeRemaining( Gpt_ChannelType channel );\r
 106 #endif\r
 107 \r
 108 void Gpt_StartTimer(Gpt_ChannelType channel, Gpt_ValueType value);\r
 109 \r
 110 void Gpt_StopTimer(Gpt_ChannelType channel);\r
 111 \r
 112 #if ( GPT_ENABLE_DISABLE_NOTIFICATION_API == STD_ON )\r
 113 void Gpt_EnableNotification( Gpt_ChannelType channel);\r
 114 \r
 115 void Gpt_DisableNotification( Gpt_ChannelType channel);\r
 116 #endif\r
 117 \r
 118 #if ( GPT_WAKEUP_FUNCTIONALITY_API == STD_ON )\r
 119 void Gpt_SetMode( Gpt_ModeType mode );\r
 120 \r
 121 void Gpt_DisableWakeup( Gpt_ChannelType channel );\r
 122 \r
 123 void Gpt_EnableWakeup( Gpt_ChannelType channel );\r
 124 \r
 125 void Gpt_Cbk_CheckWakeup( EcuM_WakeupSourceType wakeupSource );\r
 126 #endif\r
 127 \r
 128 /** GPT292 */\r
 129 extern void Gpt_Notification_0( void );\r
 130 extern void Gpt_Notification_1( void );\r
 131 extern void Gpt_Notification_2( void );\r
 132 extern void Gpt_Notification_3( void );\r
 133 \r
 134 #endif /*GPT_H_*/\r
 135 /** @} */\r