candev_linux.h 2.37 KB
/*
 * Copyright (C) 2016 OTA keys S.A.
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */

/**
 * @defgroup    drivers_candev_linux SocketCAN driver
 * @ingroup     drivers_can
 * @brief       Implementation of simulated CAN controller driver using SocketCAN on Linux
 * @{
 *
 * @file
 * @brief       Implementation of simulated CAN controller driver using SocketCAN on Linux
 *
 * @author      Hermann Lelong <hermann@otakeys.com>
 * @author      Aurelien Gonce <aurelien.gonce@altran.com>
 * @author      Vincent Dupont <vincent@otakeys.com>
 */

#ifndef CANDEV_LINUX_H
#define CANDEV_LINUX_H

#ifdef __cplusplus
extern "C" {
#endif

#if defined(__linux__) /* SocketCAN is supported only on Linux */ || defined(DOXYGEN)

#include <stdbool.h>

#include "can/candev.h"
#include "mutex.h"

/**
 * Maximum size of an interface name
 */
#define CAN_MAX_SIZE_INTERFACE_NAME (5)

/**
 * Linux candev configuration
 */
typedef struct candev_linux_conf {
    /** local interface name */
    char interface_name[CAN_MAX_SIZE_INTERFACE_NAME + 1];
} candev_linux_conf_t;

#ifndef CANDEV_LINUX_MAX_FILTERS_RX
/**
 * Max number of rx filters which can be set
 */
#define CANDEV_LINUX_MAX_FILTERS_RX  (16)
#endif

#ifndef CANDEV_LINUX_DEFAULT_BITRATE
/**
 * Default bitrate setup
 */
#define CANDEV_LINUX_DEFAULT_BITRATE (500000)
#endif

#ifndef CANDEV_LINUX_DEFAULT_SPT
/**
 * Default sampling point setup
 */
#define CANDEV_LINUX_DEFAULT_SPT (875)
#endif

/**
 * @brief The candev_linux struct
 */
typedef struct candev_linux {
    candev_t candev;                  /**< candev base structure */
    int sock;                         /**< local socket id */
    const candev_linux_conf_t *conf;  /**< device configuration */
    /** filter list */
    struct can_filter filters[CANDEV_LINUX_MAX_FILTERS_RX];
} candev_linux_t;

/**
 * @brief Device specific initialization function
 *
 * @param[inout] dev   the device to initialize
 * @param[in] conf     the device configuration
 *
 * @return 0 on success
 */
int candev_linux_init(candev_linux_t *dev, const candev_linux_conf_t *conf);

/**
 * @brief Array containing socketCAN device names
 */
extern candev_linux_conf_t candev_linux_conf[CAN_DLL_NUMOF];

#endif /* defined(__linux__) */

#ifdef __cplusplus
}
#endif

#endif /* CANDEV_LINUX_H */
/** @} */