VMX-pi C++ HAL Library for Raspberry Pi
VMX-pi Robotics Controller & Vision/Motion Processor
VMXZero.h
1 /* ============================================
2 VMX-pi HAL header files are placed under the MIT license
3 Copyright (c) 2022 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 VMXZERO_H_
23 #define VMXZERO_H_
24 
25 #include <stdint.h>
26 #include "AHRS.h"
27 #include "VMXTeddy.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 VMXZeroImpl;
37 class VMXRemoteServer;
38 
40 class VMXZero {
41 
42  VMXZeroImpl* 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  VMXZero(bool realtime, uint8_t ahrs_update_rate_hz);
72  virtual ~VMXZero();
73 
74  static VMXZero *getInstance();
75 
76  bool IsOpen();
78  vmx::AHRS& getAHRS() {return ahrs;}
80  VMXTime& getTime() {return time;}
82  VMXIO& getIO() {return io;}
84  VMXTeddy& getTeddy() {return teddy;}
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 /* VMXZERO_H_ */
The VMXTeddy class provides access to VMX power management functions.
Definition: VMXTeddy.h:31
VMXPower & getPower()
Returns a reference to the singleton VMXPower object providing access to VMXzero Power functionality...
Definition: VMXZero.h:86
VMXTeddy & getTeddy()
Returns a reference to the singleton VMXTeddy object providing access to VMXzero Teddy functionality...
Definition: VMXZero.h:84
VMXPower power
The VMXPower object providing access to VMXzero Power functionality.
Definition: VMXZero.h:64
bool registerFinalShutdownHandler(void(*termination_func)(void))
Registers a termination handler, invoked when VMXPi instance is terminated, but only after all resour...
vmx::AHRS ahrs
The AHRS object providing access to VMXzero IMU functionality.
Definition: VMXZero.h:56
The VMXPower class provides access to VMX power management functions.
Definition: VMXPower.h:30
The VMXThread class provides thread management functions.
Definition: VMXThread.h:32
bool getPerformanceLogging()
Selective Enabling/Disabling of Summary Performance statistics.
VMXTime & getTime()
Returns a reference to the singleton VMXTime object providing access to VMXzero Time functionality...
Definition: VMXZero.h:80
vmx::AHRS & getAHRS()
Returns a reference to the singleton AHRS object providing access to VMXzero IMU functionality.
Definition: VMXZero.h:78
VMXVersion version
The VMXVersion object providing access to VMXzero Version functionality.
Definition: VMXZero.h:66
VMXIO & getIO()
Returns a reference to the singleton VMXIO object providing access to VMXzero IO functionality.
Definition: VMXZero.h:82
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
VMXVersion & getVersion()
Returns a reference to the singleton VMXVersion object providing access to VMXzero Version functional...
Definition: VMXZero.h:88
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
VMXTeddy teddy
The VMXTeddy object providing access to VMXzero Teddy functionality.
Definition: VMXZero.h:62
VMXThread & getThread()
Returns a reference to the singleton VMXThread object providing access to VMXzero Threading functiona...
Definition: VMXZero.h:90
Top-level Library Class providing access to all VMXzero functionality.
Definition: VMXZero.h:40
VMXIO io
The VMXIO object providing access to VMXzero IO functionality.
Definition: VMXZero.h:60
bool registerShutdownHandler(void(*termination_func)(void))
Registers a termination handler, invoked when VMXPi instance is terminated, but before resources are ...
VMXThread thread
The VMXThread object providing access to VMXzero Threading functionality.
Definition: VMXZero.h:68
VMXTime time
The VMXTime object providing access to VMXzero Time functionality.
Definition: VMXZero.h:58