1
0
Fork 0
CANopenNode/stack/LPC177x_8x/CO_driver_target.h
Olivier Desenfans 07c61316b3 Single project-wide header for driver functions
Created a single header file (`CO_driver.h`) to declare the functions
of the drivers API. This forces drivers to use a common API.

Previously, each driver declared these functions in its specific
`CO_driver.h` file. This causes two issues:
1. while these functions are used in target-independent code,
   the declarations could be target specific, leading to API/ABI
   compatibility issues.
2. the declarations were duplicated for each driver.

The `CO_driver.h` files for each driver were renamed to
`CO_driver_target.h`. This file is included from `CO_driver.h`.

Added a new header for types: `CO_types.h`. This file currently
holds the definition of `CO_ReturnError_t` that was previously
duplicated for all drivers. Added a few enum values to support
the `neuberger-socketCAN` code.
2019-11-13 13:28:21 +01:00

154 lines
5.3 KiB
C

/*
* CAN module object for NXP LPC177x (Cortex M3) and FreeRTOS.
*
* This file is a template for other microcontrollers.
*
* @file CO_driver_target.h
* @author Janez Paternoster
* @author Amit H
* @copyright 2004 - 2014 Janez Paternoster
*
* This file is part of CANopenNode, an opensource CANopen Stack.
* Project home page is <https://github.com/CANopenNode/CANopenNode>.
* For more information on CANopen see <http://www.can-cia.org/>.
*
* CANopenNode is free and open source software: you can redistribute
* it and/or modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, either version 2 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Following clarification and special exception to the GNU General Public
* License is included to the distribution terms of CANopenNode:
*
* Linking this library statically or dynamically with other modules is
* making a combined work based on this library. Thus, the terms and
* conditions of the GNU General Public License cover the whole combination.
*
* As a special exception, the copyright holders of this library give
* you permission to link this library with independent modules to
* produce an executable, regardless of the license terms of these
* independent modules, and to copy and distribute the resulting
* executable under terms of your choice, provided that you also meet,
* for each linked independent module, the terms and conditions of the
* license of that module. An independent module is a module which is
* not derived from or based on this library. If you modify this
* library, you may extend this exception to your version of the
* library, but you are not obliged to do so. If you do not wish
* to do so, delete this exception statement from your version.
*/
#ifndef CO_DRIVER_TARGET_H
#define CO_DRIVER_TARGET_H
#include "FreeRTOS.h"
#include "task.h"
#include "board.h"
#include <stddef.h> /* for 'NULL' */
#include <stdint.h> /* for 'int8_t' to 'uint64_t' */
/* Endianness */
#define CO_LITTLE_ENDIAN
/* CAN module base address */
#define ADDR_CAN1 0
#define ADDR_CAN2 1
#define CAN_NODE_ID_0_PORT 1
#define CAN_NODE_ID_0_PIN 23
#define CAN_NODE_ID_1_PORT 1
#define CAN_NODE_ID_1_PIN 24
#define CAN_NODE_ID_2_PORT 1
#define CAN_NODE_ID_2_PIN 25
#define CAN_NODE_ID_3_PORT 1
#define CAN_NODE_ID_3_PIN 26
#define CAN_NODE_ID_4_PORT 1
#define CAN_NODE_ID_4_PIN 28
#define CAN_RUN_LED_PORT 1
#define CAN_RUN_LED_PIN 20
/* Critical sections */
#define CO_LOCK_CAN_SEND() taskENTER_CRITICAL()
#define CO_UNLOCK_CAN_SEND() taskEXIT_CRITICAL()
#define CO_LOCK_EMCY() taskENTER_CRITICAL()
#define CO_UNLOCK_EMCY() taskEXIT_CRITICAL()
#define CO_LOCK_OD() taskENTER_CRITICAL()
#define CO_UNLOCK_OD() taskEXIT_CRITICAL()
/* Data types */
/* int8_t to uint64_t are defined in stdint.h */
typedef unsigned char bool_t;
typedef float float32_t;
typedef long double float64_t;
typedef char char_t;
typedef unsigned char oChar_t;
typedef unsigned char domain_t;
/* CAN receive message structure as aligned in CAN module. */
typedef struct{
/** CAN identifier. It must be read through CO_CANrxMsg_readIdent() function. */
uint32_t ident; /*!< Message Identifier. If 30th-bit is set, this is 29-bit ID, othewise 11-bit ID */
uint32_t Type; /*!< Message Type. which can include: - CAN_REMOTE_MSG type*/
uint32_t DLC; /*!< Message Data Length: 0~8 */
uint8_t data[CAN_MSG_MAX_DATA_LEN];/*!< Message Data */
}CO_CANrxMsg_t;
/* Received message object */
typedef struct{
uint16_t ident;
uint16_t mask;
void *object;
void (*pFunct)(void *object, const CO_CANrxMsg_t *message);
}CO_CANrx_t;
/* Transmit message object. */
typedef struct{
uint32_t ident; /*!< Message Identifier. If 30th-bit is set, this is 29-bit ID, othewise 11-bit ID */
uint32_t Type; /*!< Message Type. which can include: - CAN_REMOTE_MSG type*/
uint32_t DLC; /*!< Message Data Length: 0~8 */
uint8_t data[CAN_MSG_MAX_DATA_LEN];/*!< Message Data */
volatile bool_t bufferFull;
volatile bool_t syncFlag;
}CO_CANtx_t;
/* CAN module object. */
typedef struct{
void *CANdriverState;
CO_CANrx_t *rxArray;
uint16_t rxSize;
CO_CANtx_t *txArray;
uint16_t txSize;
volatile bool_t CANnormal;
volatile bool_t useCANrxFilters;
volatile bool_t bufferInhibitFlag;
volatile bool_t firstCANtxMessage;
volatile uint16_t CANtxCount;
uint32_t errOld;
void *em;
}CO_CANmodule_t;
/* CAN interrupt receives and transmits CAN messages. */
void CO_CANinterrupt(CO_CANmodule_t *CANmodule);
#endif /* CO_DRIVER_TARGET_H */