Goby3 3.2.3
2025.05.13
Loading...
Searching...
No Matches
pty.h
Go to the documentation of this file.
1// Copyright 2019-2023:
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_PTY_H
25#define GOBY_MIDDLEWARE_IO_COBS_PTY_H
26
27#include <istream> // for istream, basic_...
28#include <string> // for string
29
30#include <boost/asio/read_until.hpp> // for async_read_until
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/pty_interface.h" // for PTYThread
37
38namespace goby
39{
40namespace middleware
41{
42class Group;
43}
44} // namespace goby
45namespace goby
46{
47namespace middleware
48{
49namespace protobuf
50{
51class PTYConfig;
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>
71class PTYThreadCOBS : public detail::PTYThread<line_in_group, line_out_group, publish_layer,
72 subscribe_layer, ThreadType, use_indexed_groups>
73{
74 using Base = detail::PTYThread<line_in_group, line_out_group, publish_layer, subscribe_layer,
75 ThreadType, use_indexed_groups>;
76
77 public:
82 : Base(config, index)
83 {
84 }
85
87
88 template <class Thread>
89 friend void cobs_async_write(Thread* this_thread,
90 std::shared_ptr<const goby::middleware::protobuf::IOData> io_msg);
91
92 template <class Thread, class ThreadBase>
93 friend void cobs_async_read(Thread* this_thread, std::shared_ptr<ThreadBase> self);
94
95 private:
96 void async_read() override { cobs_async_read(this); }
97
98 void async_write(std::shared_ptr<const goby::middleware::protobuf::IOData> io_msg) override
99 {
100 cobs_async_write(this, io_msg);
101 }
102
103 private:
104 boost::asio::streambuf buffer_;
105};
106} // namespace io
107} // namespace middleware
108} // namespace goby
109
110#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 pty.h:73
PTYThreadCOBS(const goby::middleware::protobuf::PTYConfig &config, int index=-1)
Constructs the thread.
Definition pty.h:81
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.