ORE Studio 0.0.4
Loading...
Searching...
No Matches
heartbeat_protocol.hpp
1/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
2 *
3 * Copyright (C) 2025 Marco Craveiro <marco.craveiro@gmail.com>
4 *
5 * This program is free software; you can redistribute it and/or modify it under
6 * the terms of the GNU General Public License as published by the Free Software
7 * Foundation; either version 3 of the License, or (at your option) any later
8 * version.
9 *
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
12 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
13 * details.
14 *
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc., 51
17 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 *
19 */
20#ifndef ORES_COMMS_MESSAGING_HEARTBEAT_PROTOCOL_HPP
21#define ORES_COMMS_MESSAGING_HEARTBEAT_PROTOCOL_HPP
22
23#include <vector>
24#include <cstdint>
25#include <expected>
26#include "ores.comms/messaging/frame.hpp"
27
28namespace ores::comms::messaging {
29
35struct ping final {
39 static std::vector<std::byte> serialize(ping v);
40
44 static std::expected<ping, error_code>
45 deserialize(std::span<const std::byte> data);
46};
47
53struct pong final {
57 static std::vector<std::byte> serialize(pong v);
58
62 static std::expected<pong, error_code>
63 deserialize(std::span<const std::byte> data);
64};
65
69frame create_ping_frame(std::uint32_t sequence, std::uint32_t correlation_id = 0);
70
74frame create_pong_frame(std::uint32_t sequence, std::uint32_t correlation_id = 0);
75
76}
77
78#endif
Contains messaging related infrastructure in the comms library.
Definition compression.hpp:29
frame create_ping_frame(std::uint32_t sequence, std::uint32_t correlation_id=0)
Create a ping frame.
Definition heartbeat.cpp:68
frame create_pong_frame(std::uint32_t sequence, std::uint32_t correlation_id=0)
Create a pong frame.
Definition heartbeat.cpp:73
Complete frame with header and payload.
Definition frame.hpp:77
Ping message sent by client to check connection liveness.
Definition heartbeat_protocol.hpp:35
static std::expected< ping, error_code > deserialize(std::span< const std::byte > data)
Deserialize from frame payload.
Definition heartbeat.cpp:37
static std::vector< std::byte > serialize(ping v)
Serialize to frame payload.
Definition heartbeat.cpp:28
Pong message sent by server in response to ping.
Definition heartbeat_protocol.hpp:53
static std::expected< pong, error_code > deserialize(std::span< const std::byte > data)
Deserialize from frame payload.
Definition heartbeat.cpp:57
static std::vector< std::byte > serialize(pong v)
Serialize to frame payload.
Definition heartbeat.cpp:48