summaryrefslogtreecommitdiff
path: root/plugins/common/canobserver.h
blob: cf4b4e4ff331e1f2de77f640a498211c44cc5622 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
/*****************************************************************
 * INTEL CONFIDENTIAL
 * Copyright 2011 - 2013 Intel Corporation All Rights Reserved.
 * 
 * The source code contained or described herein and all documents related to the
 * source code("Material") are owned by Intel Corporation or its suppliers or
 * licensors.Title to the Material remains with Intel Corporation or its
 * suppliers and licensors.The Material may contain trade secrets and proprietary
 * and confidential information of Intel Corporation and its suppliers and
 * licensors, and is protected by worldwide copyright and trade secret laws and
 * treaty provisions.No part of the Material may be used, copied, reproduced,
 * modified, published, uploaded, posted, transmitted, distributed, or disclosed
 * in any way without Intels prior express written permission.
 * No license under any patent, copyright, trade secret or other intellectual
 * property right is granted to or conferred upon you by disclosure or delivery
 * of the Materials, either expressly, by implication, inducement, estoppel or
 * otherwise.Any license under such intellectual property rights must be
 * express and approved by Intel in writing. 
 * 
 * Unless otherwise agreed by Intel in writing, you may not remove or alter this
 * notice or any other notice embedded in Materials by Intel or Intels suppliers
 * or licensors in any way.
 *****************************************************************/

#ifndef CANOBSERVER_H
#define CANOBSERVER_H

/**
 *  \addtogroup libcanbus
 *  @{
 */

#include <linux/can.h>

/**
* \brief Interface. Receives notifications about the CAN bus traffic and errors.
*
* CANBus user has to derive from this interface.
* @class CANObserver
*/

class CANObserver
{
public:
    /**
    * General CAN bus error. Currently only GENERAL_ERROR is specified.
    * @enum CANError
    * @public
    */
    enum CANError {
        GENERAL_ERROR = 0
    };

    virtual ~CANObserver(){} /*LCOV_EXCL_LINE*/
    /**
    * Called when error occurred on the bus.
    * @fn errorOccured
    * @param error Bus error code
    */
    virtual void errorOccured(CANObserver::CANError error) = 0;             /* socket error */
    /**
    * Called when standard frame was is received from the bus.
    * @fn standardFrameReceived
    * @param frame Received frame
    */
    virtual void standardFrameReceived(const can_frame& frame) = 0;       /* SFF was present */
    /**
    * Called when extended frame was is received from the bus.
    * @fn extendedFrameReceived
    * @param frame Received frame
    */
    virtual void extendedFrameReceived(const can_frame& frame) = 0;       /* EFF was present */
    /**
    * Called when error frame was received from the bus.
    * @fn errorFrameReceived
    * @param frame Error frame
    */
    virtual void errorFrameReceived(const can_frame& frame) = 0;          /* error frame */
    /**
    * Called when remote transmission frame was received from the bus.
    * @fn remoteTransmissionRequest
    * @param frame RTR frame
    */
    virtual void remoteTransmissionRequest(const can_frame& frame) = 0;   /* remote transmission request (SFF/EFF is still present)*/

};

#endif // CANOBSERVER_H

/** @} */