communication_core.hpp
Go to the documentation of this file.
1 // *****************************************************************************
2 //
3 // © Copyright 2020, Septentrio NV/SA.
4 // All rights reserved.
5 //
6 // Redistribution and use in source and binary forms, with or without
7 // modification, are permitted provided that the following conditions are met:
8 // 1. Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // 2. Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // 3. Neither the name of the copyright holder nor the names of its
14 // contributors may be used to endorse or promote products derived
15 // from this software without specific prior written permission.
16 //
17 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
21 // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22 // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 // POSSIBILITY OF SUCH DAMAGE.
28 //
29 // *****************************************************************************
30 
31 // *****************************************************************************
32 //
33 // Boost Software License - Version 1.0 - August 17th, 2003
34 //
35 // Permission is hereby granted, free of charge, to any person or organization
36 // obtaining a copy of the software and accompanying documentation covered by
37 // this license (the "Software") to use, reproduce, display, distribute,
38 // execute, and transmit the Software, and to prepare derivative works of the
39 // Software, and to permit third-parties to whom the Software is furnished to
40 // do so, all subject to the following:
41 
42 // The copyright notices in the Software and this entire statement, including
43 // the above license grant, this restriction and the following disclaimer,
44 // must be included in all copies of the Software, in whole or in part, and
45 // all derivative works of the Software, unless such copies or derivative
46 // works are solely in the form of machine-executable object code generated by
47 // a source language processor.
48 //
49 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
50 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
51 // FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
52 // SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
53 // FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
54 // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
55 // DEALINGS IN THE SOFTWARE.
56 //
57 // *****************************************************************************
58 
59 #ifndef COMMUNICATION_CORE_HPP // This block is called a conditional group. The
60  // controlled text will get included in the
61  // preprocessor output iff the macroname is not
62  // defined.
63 #define COMMUNICATION_CORE_HPP // Include guards help to avoid the double inclusion
64  // of header files, by defining a token = macro.
65 
66 // Boost includes
67 #include <boost/asio.hpp>
68 #include <boost/asio/serial_port.hpp>
69 #include <boost/bind.hpp>
70 #include <boost/date_time/posix_time/posix_time.hpp>
71 #include <boost/exception/diagnostic_information.hpp> // dealing with bad file descriptor error
72 #include <boost/function.hpp>
73 // C++ library includes
74 #include <fstream>
75 #include <memory>
76 #include <sstream>
77 #include <unistd.h> // for usleep()
78 // ROSaic includes
81 
93 namespace io_comm_rx {
94 
96  const static uint32_t BAUDRATES[] = {
97  1200, 2400, 4800, 9600, 19200, 38400, 57600,
98  115200, 230400, 460800, 500000, 576000, 921600, 1000000,
99  1152000, 1500000, 2000000, 2500000, 3000000, 3500000, 4000000};
100 
106  class Comm_IO
107  {
108  public:
113  Comm_IO(ROSaicNodeBase* node, Settings* settings);
117  ~Comm_IO();
118 
122  void initializeIO();
123 
129  void configureRx();
130 
135  void defineMessages();
136 
142  void sendVelocity(const std::string& velNmea);
143 
144  private:
148  void resetMainPort();
149 
154  void prepareSBFFileReading(std::string file_name);
155 
160  void preparePCAPFileReading(std::string file_name);
161 
165  void reconnect();
166 
170  void connect();
171 
181  bool initializeSerial(std::string port, uint32_t baudrate = 115200,
182  std::string flowcontrol = "None");
183 
190  bool initializeTCP(std::string host, std::string port);
191 
197  void initializeSBFFileReading(std::string file_name);
198 
205  void initializePCAPFileReading(std::string file_name);
206 
211  void setManager(const boost::shared_ptr<Manager>& manager);
212 
217  void send(const std::string&);
218 
226  bool connected_ = false;
230  boost::mutex connection_mutex_;
234  boost::condition_variable connection_condition_;
236  std::string tcp_host_;
238  std::string tcp_port_;
240  bool serial_;
242  std::string serial_port_;
247  uint32_t baudrate_;
248 
249  bool nmeaActivated_ = false;
250 
252  std::unique_ptr<boost::thread> connectionThread_;
254  std::atomic<bool> stopping_;
255 
256  friend class CallbackHandlers;
257  friend class RxMessage;
258 
260  std::string mainPort_;
261 
263  std::string host_;
265  std::string port_;
269  const static unsigned int SET_BAUDRATE_SLEEP_ = 500000;
270  };
271 } // namespace io_comm_rx
272 
273 #endif // for COMMUNICATION_CORE_HPP
io_comm_rx::Comm_IO::connection_mutex_
boost::mutex connection_mutex_
Definition: communication_core.hpp:230
io_comm_rx::Comm_IO::resetMainPort
void resetMainPort()
Reset main port so it can receive commands.
Definition: communication_core.cpp:191
io_comm_rx::BAUDRATES
const static uint32_t BAUDRATES[]
Possible baudrates for the Rx.
Definition: communication_core.hpp:96
io_comm_rx::Comm_IO::tcp_port_
std::string tcp_port_
TCP port number.
Definition: communication_core.hpp:238
io_comm_rx::Comm_IO::host_
std::string host_
Host currently connected to.
Definition: communication_core.hpp:263
io_comm_rx::Comm_IO::send
void send(const std::string &)
Hands over to the send() method of manager_.
Definition: communication_core.cpp:1192
async_manager.hpp
Implements asynchronous operations for an I/O manager.
boost::shared_ptr
io_comm_rx::Comm_IO::Comm_IO
Comm_IO(ROSaicNodeBase *node, Settings *settings)
Constructor of the class Comm_IO.
Definition: communication_core.cpp:122
io_comm_rx::Comm_IO::prepareSBFFileReading
void prepareSBFFileReading(std::string file_name)
Sets up the stage for SBF file reading.
Definition: communication_core.cpp:268
io_comm_rx::Comm_IO::initializeIO
void initializeIO()
Initializes the I/O handling.
Definition: communication_core.cpp:206
io_comm_rx::Comm_IO::connection_condition_
boost::condition_variable connection_condition_
Definition: communication_core.hpp:234
io_comm_rx::Comm_IO::settings_
Settings * settings_
Settings.
Definition: communication_core.hpp:224
callback_handlers.hpp
Handles callbacks when reading NMEA/SBF messages.
io_comm_rx::Comm_IO::handlers_
CallbackHandlers handlers_
Callback handlers for the inwards streaming messages.
Definition: communication_core.hpp:222
io_comm_rx::Comm_IO::stopping_
std::atomic< bool > stopping_
Indicator for threads to exit.
Definition: communication_core.hpp:254
io_comm_rx::Comm_IO::sendVelocity
void sendVelocity(const std::string &velNmea)
Hands over NMEA velocity message over to the send() method of manager_.
Definition: communication_core.cpp:1203
ROSaicNodeBase
This class is the base class for abstraction.
Definition: typedefs.hpp:174
io_comm_rx::Comm_IO::connectionThread_
std::unique_ptr< boost::thread > connectionThread_
Connection or reading thread.
Definition: communication_core.hpp:252
io_comm_rx
Definition: async_manager.hpp:84
io_comm_rx::Comm_IO::baudrate_
uint32_t baudrate_
Baudrate at the moment, unless InitializeSerial or ResetSerial fail.
Definition: communication_core.hpp:247
io_comm_rx::Comm_IO::nmeaActivated_
bool nmeaActivated_
Definition: communication_core.hpp:249
io_comm_rx::Comm_IO
Handles communication with and configuration of the mosaic (and beyond) receiver(s)
Definition: communication_core.hpp:106
io_comm_rx::Comm_IO::SET_BAUDRATE_SLEEP_
const static unsigned int SET_BAUDRATE_SLEEP_
Definition: communication_core.hpp:269
io_comm_rx::Comm_IO::node_
ROSaicNodeBase * node_
Pointer to Node.
Definition: communication_core.hpp:220
io_comm_rx::Comm_IO::connect
void connect()
Calls the reconnect() method.
Definition: communication_core.cpp:302
io_comm_rx::Comm_IO::initializeSBFFileReading
void initializeSBFFileReading(std::string file_name)
Initializes SBF file reading and reads SBF file by repeatedly calling read_callback_()
Definition: communication_core.cpp:1272
io_comm_rx::CallbackHandlers
Represents ensemble of (to be constructed) ROS messages, to be handled at once by this class.
Definition: callback_handlers.hpp:181
Settings
Settings struct.
Definition: settings.h:103
io_comm_rx::Comm_IO::tcp_host_
std::string tcp_host_
Host name of TCP server.
Definition: communication_core.hpp:236
io_comm_rx::Comm_IO::setManager
void setManager(const boost::shared_ptr< Manager > &manager)
Set the I/O manager.
Definition: communication_core.cpp:1550
io_comm_rx::Comm_IO::preparePCAPFileReading
void preparePCAPFileReading(std::string file_name)
Sets up the stage for PCAP file reading.
Definition: communication_core.cpp:285
io_comm_rx::Comm_IO::serial_port_
std::string serial_port_
Saves the port description.
Definition: communication_core.hpp:242
io_comm_rx::Comm_IO::reconnect
void reconnect()
Attempts to (re)connect every reconnect_delay_s_ seconds.
Definition: communication_core.cpp:324
io_comm_rx::Comm_IO::mainPort_
std::string mainPort_
Communication ports.
Definition: communication_core.hpp:260
io_comm_rx::Comm_IO::initializeSerial
bool initializeSerial(std::string port, uint32_t baudrate=115200, std::string flowcontrol="None")
Initializes the serial port.
Definition: communication_core.cpp:1380
io_comm_rx::Comm_IO::initializePCAPFileReading
void initializePCAPFileReading(std::string file_name)
Initializes PCAP file reading and reads PCAP file by repeatedly calling read_callback_()
Definition: communication_core.cpp:1327
io_comm_rx::Comm_IO::configureRx
void configureRx()
Configures Rx: Which SBF/NMEA messages it should output and later correction settings.
Definition: communication_core.cpp:389
io_comm_rx::Comm_IO::serial_
bool serial_
Whether yet-to-be-established connection to Rx will be serial or TCP.
Definition: communication_core.hpp:240
io_comm_rx::Comm_IO::initializeTCP
bool initializeTCP(std::string host, std::string port)
Initializes the TCP I/O.
Definition: communication_core.cpp:1209
io_comm_rx::Comm_IO::port_
std::string port_
Port over which TCP/IP connection is currently established.
Definition: communication_core.hpp:265
io_comm_rx::RxMessage
Can search buffer for messages, read/parse them, and so on.
Definition: rx_message.hpp:201
io_comm_rx::Comm_IO::manager_
boost::shared_ptr< Manager > manager_
Definition: communication_core.hpp:245
io_comm_rx::Comm_IO::~Comm_IO
~Comm_IO()
Default destructor of the class Comm_IO.
Definition: communication_core.cpp:131
io_comm_rx::Comm_IO::connected_
bool connected_
Whether connecting to Rx was successful.
Definition: communication_core.hpp:226
io_comm_rx::Comm_IO::defineMessages
void defineMessages()
Defines which Rx messages to read and which ROS messages to publish.
Definition: communication_core.cpp:985


septentrio_gnss_driver
Author(s): Tibor Dome
autogenerated on Fri Mar 10 2023 04:02:30