PX4 Firmware
PX4 Autopilot Software http://px4.io
CDev.hpp
Go to the documentation of this file.
1 /****************************************************************************
2  *
3  * Copyright (c) 2012-2017 PX4 Development Team. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in
13  * the documentation and/or other materials provided with the
14  * distribution.
15  * 3. Neither the name PX4 nor the names of its contributors may be
16  * used to endorse or promote products derived from this software
17  * without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
23  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
25  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
26  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
29  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  *
32  ****************************************************************************/
33 
34 /**
35  * @file CDev.hpp
36  *
37  * Definitions for the generic base classes in the device framework.
38  */
39 
40 #ifndef _DEVICE_CDEV_HPP
41 #define _DEVICE_CDEV_HPP
42 
43 #include "Device.hpp"
44 #include <lib/cdev/CDev.hpp>
45 
46 #include <px4_platform_common/px4_config.h>
47 #include <px4_platform_common/posix.h>
48 
49 /**
50  * Namespace encapsulating all device framework classes, functions and data.
51  */
52 namespace device
53 {
54 
56 
57 /**
58  * Abstract class for any character device
59  */
60 class __EXPORT CDev : public Device, public cdev::CDev
61 {
62 public:
63  /**
64  * Constructor
65  *
66  * @param name Driver name
67  * @param devname Device node name
68  */
69  CDev(const char *name, const char *devname); // TODO: dagar remove name and Device inheritance
70 
71  virtual ~CDev() = default;
72 
73  virtual int init();
74 
75  /**
76  * Perform an ioctl operation on the device.
77  *
78  * The default implementation handles DIOC_GETPRIV, and otherwise
79  * returns -ENOTTY. Subclasses should call the default implementation
80  * for any command they do not handle themselves.
81  *
82  * @param filep Pointer to the NuttX file structure.
83  * @param cmd The ioctl command value.
84  * @param arg The ioctl argument value.
85  * @return OK on success, or -errno otherwise.
86  */
87  virtual int ioctl(file_t *filep, int cmd, unsigned long arg);
88 
89 protected:
90 
91  bool _pub_blocked{false}; /**< true if publishing should be blocked */
92 
93 private:
94 
95 };
96 
97 } // namespace device
98 
99 // class instance for primary driver of each class
104 };
105 
106 #endif /* _DEVICE_CDEV_HPP */
Definition: I2C.hpp:51
Namespace encapsulating all device framework classes, functions and data.
Definition: CDev.cpp:47
Abstract class for any character device.
Definition: CDev.hpp:60
Definitions for the generic base classes in the device framework.
Abstract class for any character device.
Definition: CDev.hpp:58
CLASS_DEVICE
Definition: CDev.hpp:100
void init()
Activates/configures the hardware registers.
const char * name
Definition: tests_main.c:58
struct file file_t
Fundamental base class for all physical drivers (I2C, SPI).
Definition: Device.hpp:65