Goby3 3.2.3
2025.05.13
Loading...
Searching...
No Matches
serial.h
Go to the documentation of this file.
1// Copyright 2019-2022:
2// GobySoft, LLC (2013-)
3// Community contributors (see AUTHORS file)
4// File authors:
5// Toby Schneider <toby@gobysoft.org>
6//
7//
8// This file is part of the Goby Underwater Autonomy Project Libraries
9// ("The Goby Libraries").
10//
11// The Goby Libraries are free software: you can redistribute them and/or modify
12// them under the terms of the GNU Lesser General Public License as published by
13// the Free Software Foundation, either version 2.1 of the License, or
14// (at your option) any later version.
15//
16// The Goby Libraries are distributed in the hope that they will be useful,
17// but WITHOUT ANY WARRANTY; without even the implied warranty of
18// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19// GNU Lesser General Public License for more details.
20//
21// You should have received a copy of the GNU Lesser General Public License
22// along with Goby. If not, see <http://www.gnu.org/licenses/>.
23
24#ifndef GOBY_MIDDLEWARE_IO_COBS_SERIAL_H
25#define GOBY_MIDDLEWARE_IO_COBS_SERIAL_H
26
27#include <istream> // for istream, bas...
28#include <string> // for string
29
30#include <boost/asio/read_until.hpp> // for async_read_u...
31#include <boost/asio/streambuf.hpp> // for streambuf
32#include <boost/system/error_code.hpp> // for error_code
33
35#include "goby/middleware/io/detail/io_interface.h" // for PubSubLayer
36#include "goby/middleware/io/detail/serial_interface.h" // for SerialThread
37
38namespace goby
39{
40namespace middleware
41{
42class Group;
43}
44} // namespace goby
45namespace goby
46{
47namespace middleware
48{
49namespace protobuf
50{
51class SerialConfig;
52}
53} // namespace middleware
54} // namespace goby
55
56namespace goby
57{
58namespace middleware
59{
60namespace io
61{
65template <const goby::middleware::Group& line_in_group,
66 const goby::middleware::Group& line_out_group,
68 PubSubLayer subscribe_layer = PubSubLayer::INTERTHREAD,
69 template <class> class ThreadType = goby::middleware::SimpleThread,
70 bool use_indexed_groups = false>
72 : public detail::SerialThread<line_in_group, line_out_group, publish_layer, subscribe_layer,
73 ThreadType, use_indexed_groups>
74{
75 using Base = detail::SerialThread<line_in_group, line_out_group, publish_layer, subscribe_layer,
76 ThreadType, use_indexed_groups>;
77
78 public:
83 : Base(config, index)
84 {
85 }
86
88
89 template <class Thread>
90 friend void cobs_async_write(Thread* this_thread,
91 std::shared_ptr<const goby::middleware::protobuf::IOData> io_msg);
92
93 template <class Thread, class ThreadBase>
94 friend void cobs_async_read(Thread* this_thread, std::shared_ptr<ThreadBase> self);
95
96 private:
97 void async_read() override { cobs_async_read(this); }
98
99 void async_write(std::shared_ptr<const goby::middleware::protobuf::IOData> io_msg) override
100 {
101 cobs_async_write(this, io_msg);
102 }
103
104 private:
105 boost::asio::streambuf buffer_;
106};
107} // namespace io
108} // namespace middleware
109} // namespace goby
110
111#endif
Class for grouping publications in the Goby middleware. Analogous to "topics" in ROS,...
Definition group.h:60
Implements Thread for a three layer middleware setup ([ intervehicle [ interprocess [ interthread ] ]...
Represents a thread of execution within the Goby middleware, interleaving periodic events (loop()) wi...
Definition thread.h:61
Reads/Writes strings from/to serial port using a line-based (typically ASCII) protocol with a defined...
Definition serial.h:74
SerialThreadCOBS(const goby::middleware::protobuf::SerialConfig &config, int index=-1)
Constructs the thread.
Definition serial.h:82
friend void cobs_async_write(Thread *this_thread, std::shared_ptr< const goby::middleware::protobuf::IOData > io_msg)
Definition common.h:44
friend void cobs_async_read(Thread *this_thread, std::shared_ptr< ThreadBase > self)
Definition common.h:90
The global namespace for the Goby project.