include/Dio.h

   1 /* -------------------------------- Arctic Core ------------------------------
   2  * Arctic Core - the open source AUTOSAR platform http://arccore.com
   3  *
   4  * Copyright (C) 2009  ArcCore AB <contact@arccore.com>
   5  *
   6  * This source code is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License version 2 as published by the
   8  * Free Software Foundation; See <http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt>.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  12  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13  * for more details.
  14  * -------------------------------- Arctic Core ------------------------------*/
  15
  16
  17
  18
  19
  20
  21
  22
  23 #ifndef DIO_H_
  24 #define DIO_H_
  25
  26 #include "Modules.h"
  27 #include "Std_Types.h" /** @req DIO131 */
  28
  29 // API Service ID's
  30 #define DIO_READCHANNEL_ID                      0x00
  31 #define DIO_WRITECHANNEL_ID                     0x01
  32 #define DIO_READPORT_ID                         0x02
  33 #define DIO_WRITEPORT_ID                        0x03
  34 #define DIO_READCHANNELGROUP_ID         0x04
  35 #define DIO_WRITECHANNELGROUP_ID        0x05
  36 #define DIO_GETVERSIONINFO_ID           0x12
  37
  38 #define DIO_E_PARAM_INVALID_CHANNEL_ID          10
  39 #define DIO_E_PARAM_INVALID_PORT_ID             20
  40 #define DIO_E_PARAM_INVALID_GROUP_ID            31
  41
  42 #if defined(CFG_HC1X) || defined(CFG_TMS570)
  43 typedef uint8 Dio_ChannelType;
  44 typedef uint8 Dio_PortType;
  45
  46 /** @req DIO021 */
  47 /** @req DIO022 */
  48 typedef struct
  49 {
  50   Dio_PortType port;
  51   uint8 offset;
  52   uint8 mask;
  53 } Dio_ChannelGroupType;
  54
  55 /** @req DIO023 */
  56 typedef uint8 Dio_LevelType;
  57
  58 /** @req DIO024 */
  59 typedef uint8 Dio_PortLevelType;
  60
  61 #else   // CFG_PPC, CFG_STM32_STAMP and others
  62 typedef uint32 Dio_ChannelType;
  63 typedef uint32 Dio_PortType;
  64 typedef struct
  65 {
  66   Dio_PortType port;
  67   uint8 offset;
  68   uint32 mask;
  69 } Dio_ChannelGroupType;
  70
  71 typedef uint32 Dio_LevelType;
  72
  73 typedef uint16 Dio_PortLevelType;
  74 #endif
  75
  76
  77 #define DIO_MODULE_ID                   MODULE_ID_DIO
  78 #define DIO_VENDOR_ID                   1
  79
  80 #define DIO_SW_MAJOR_VERSION    1
  81 #define DIO_SW_MINOR_VERSION    0
  82 #define DIO_SW_PATCH_VERSION    0
  83
  84 #define DIO_AR_MAJOR_VERSION    2
  85 #define DIO_AR_MINOR_VERSION    2
  86 #define DIO_AR_PATCH_VERSION    1
  87
  88 #include "Dio_Cfg.h"
  89
  90 /** @req DIO124 */
  91 #if ( DIO_VERSION_INFO_API == STD_ON)
  92 /** @req DIO139 */
  93 #define Dio_GetVersionInfo(_vi) STD_GET_VERSION_INFO(_vi,DIO)
  94 #endif
  95
  96 /** @req DIO133 */
  97 /** @req DIO027 */
  98 Dio_LevelType Dio_ReadChannel(Dio_ChannelType channelId);
  99
 100 /** @req DIO134 */
 101 void Dio_WriteChannel(Dio_ChannelType channelId, Dio_LevelType level);
 102
 103 /** @req DIO135 */
 104 /** @req DIO031 */
 105 Dio_PortLevelType Dio_ReadPort(Dio_PortType portId);
 106
 107 /** @req DIO136 */
 108 void Dio_WritePort(Dio_PortType portId, Dio_PortLevelType level);
 109
 110 /** @req DIO137 */
 111 Dio_PortLevelType Dio_ReadChannelGroup( const Dio_ChannelGroupType *channelGroupIdPtr );
 112
 113 /** @req DIO138 */
 114 void Dio_WriteChannelGroup(const Dio_ChannelGroupType *channelGroupIdPtr, Dio_PortLevelType level);
 115
 116 #endif /*DIO_H_*/