VMX-pi C++ HAL Library for Raspberry Pi
VMX-pi Robotics Controller & Vision/Motion Processor
VMXPi.h
1 /* ============================================
2 VMX-pi HAL source code is placed under the MIT license
3 Copyright (c) 2017 Kauai Labs
4 Permission is hereby granted, free of charge, to any person obtaining a copy
5 of this software and associated documentation files (the "Software"), to deal
6 in the Software without restriction, including without limitation the rights
7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 copies of the Software, and to permit persons to whom the Software is
9 furnished to do so, subject to the following conditions:
10 The above copyright notice and this permission notice shall be included in
11 all copies or substantial portions of the Software.
12 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
14 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
15 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
16 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
17 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
18 THE SOFTWARE.
19 ===============================================
20 */
21 
22 #ifndef VMXPI_H_
23 #define VMXPI_H_
24 
25 #include <stdint.h>
26 #include "AHRS.h"
27 #include "VMXCAN.h"
28 #include "VMXIO.h"
29 #include "VMXPower.h"
30 #include "VMXTime.h"
31 #include "VMXVersion.h"
32 #include "VMXThread.h"
33 
34 #define MAX_NUM_TERMINATION_FUNCS 5
35 
36 class VMXPiImpl;
37 class VMXRemoteServer;
38 
40 class VMXPi {
41 
42  VMXPiImpl* p_impl;
43  bool initialized;
44  void Cleanup();
45  static void Terminate(void);
46  void (*termination_func[MAX_NUM_TERMINATION_FUNCS])(void);
47  uint8_t num_termination_funcs;
48  void (*final_termination_func)(void);
49  VMXRemoteServer *p_remote_server;
50 
51 #ifndef SWIG /* NOTE: direct structure access is only available in C++ HAL */
52 public:
53 #endif
54 
69 
70 public:
71  VMXPi(bool realtime, uint8_t ahrs_update_rate_hz);
72  virtual ~VMXPi();
73 
74  static VMXPi *getInstance();
75 
76  bool IsOpen();
78  vmx::AHRS& getAHRS() {return ahrs;}
80  VMXTime& getTime() {return time;}
82  VMXIO& getIO() {return io;}
84  VMXCAN& getCAN() {return can;}
86  VMXPower& getPower() {return power;}
90  VMXThread& getThread() {return thread;}
93  bool registerShutdownHandler(void (*termination_func)(void));
96  bool registerFinalShutdownHandler(void (*termination_func)(void));
98  bool getPerformanceLogging();
99  void setPerformanceLogging(bool enable);
100 };
101 
102 #endif /* VMXPI_H_ */
VMXCAN can
The VMXCAN object providing access to VMX-pi CAN functionality.
Definition: VMXPi.h:62
Top-level Library Class providing access to all VMX-pi functionality.
Definition: VMXPi.h:40
VMXTime & getTime()
Returns a reference to the singleton VMXTime object providing access to VMX-pi Time functionality...
Definition: VMXPi.h:80
VMXCAN & getCAN()
Returns a reference to the singleton VMXCAN object providing access to VMX-pi CAN functionality...
Definition: VMXPi.h:84
VMXVersion version
The VMXVersion object providing access to VMX-pi Version functionality.
Definition: VMXPi.h:66
VMXThread & getThread()
Returns a reference to the singleton VMXThread object providing access to VMX-pi Threading functional...
Definition: VMXPi.h:90
The VMXPower class provides access to VMX power management functions.
Definition: VMXPower.h:30
void setPerformanceLogging(bool enable)
Sets the current state of Performance Logging.
Definition: VMXPi.cpp:136
VMXPower & getPower()
Returns a reference to the singleton VMXPower object providing access to VMX-pi Power functionality...
Definition: VMXPi.h:86
The VMXThread class provides thread management functions.
Definition: VMXThread.h:32
bool IsOpen()
Returns true if the communication with the VMX-pi firmware has been established.
Definition: VMXPi.cpp:125
vmx::AHRS & getAHRS()
Returns a reference to the singleton AHRS object providing access to VMX-pi IMU functionality.
Definition: VMXPi.h:78
vmx::AHRS ahrs
The AHRS object providing access to VMX-pi IMU functionality.
Definition: VMXPi.h:56
The VMXVersion class provides library version management functions.
Definition: VMXVersion.h:29
The AHRS class provides accesst to the VMX-pi IMU and Attitude/Heading Reference System functionality...
Definition: AHRS.h:59
VMXPower power
The VMXPower object providing access to VMX-pi Power functionality.
Definition: VMXPi.h:64
VMXPi(bool realtime, uint8_t ahrs_update_rate_hz)
Constructs the VMXPi object using the specified parameters.
Definition: VMXPi.cpp:34
VMXTime time
The VMXTime object providing access to VMX-pi Time functionality.
Definition: VMXPi.h:58
bool registerShutdownHandler(void(*termination_func)(void))
Registers a termination handler, invoked when VMXPi instance is terminated, but before resources are ...
Definition: VMXPi.cpp:69
The VMXTime class provides time management functions, including system timestamps, VMX Real-time Clock access, timer notifications and current thread time-delay.
Definition: VMXTime.h:38
The VMXIO class provides access to VMX Analog/Digital IO functions, including VMX Channel and VMX Res...
Definition: VMXIO.h:47
VMXVersion & getVersion()
Returns a reference to the singleton VMXVersion object providing access to VMX-pi Version functionali...
Definition: VMXPi.h:88
bool getPerformanceLogging()
Selective Enabling/Disabling of Summary Performance statistics.
Definition: VMXPi.cpp:130
VMXIO & getIO()
Returns a reference to the singleton VMXIO object providing access to VMX-pi IO functionality.
Definition: VMXPi.h:82
The VMXCAN class provides a hardware-abstraction of the VMX-pi CAN functionality. ...
Definition: VMXCAN.h:122
bool registerFinalShutdownHandler(void(*termination_func)(void))
Registers a termination handler, invoked when VMXPi instance is terminated, but only after all resour...
Definition: VMXPi.cpp:78
VMXIO io
The VMXIO object providing access to VMX-pi IO functionality.
Definition: VMXPi.h:60
VMXThread thread
The VMXThread object providing access to VMX-pi Threading functionality.
Definition: VMXPi.h:68