raphael
95ebcc3aac
Adds the five GEM event-subscription primitives the host needs to drive
the equipment's data-collection lifecycle (E30 §6.11):
S1F3/F4 selected status data
S1F11/F12 status variable namelist
S2F33/F34 define reports
S2F35/F36 link event reports
S2F37/F38 enable/disable events
Each is a one-line wrapper over the codegen builders + Connection's
send_request, surfacing the codegen-generated DefineReportEntry /
LinkEventEntry structs to callers behind a {id, [vids]} pair API.
This is the minimum surface a host needs to walk a fresh equipment
through "define report -> link CEID -> enable" and start receiving
S6F11 event reports — the same pattern the existing demo client does
inline. B3 lands the RCMD / recipe / job / terminal senders that
build on top.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
120 lines
4.8 KiB
C++
120 lines
4.8 KiB
C++
#pragma once
|
|
|
|
#include <array>
|
|
#include <cstdint>
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <system_error>
|
|
#include <vector>
|
|
|
|
#include "secsgem/gem/store/event_reports.hpp"
|
|
#include "secsgem/hsms/connection.hpp"
|
|
#include "secsgem/secs2/message.hpp"
|
|
|
|
// GEM host-side message handler. Wraps an HSMS Connection (Active mode)
|
|
// and provides:
|
|
//
|
|
// - Inbound dispatch with sensible automatic acks for the messages a
|
|
// host is expected to accept passively (S5F1 alarms, S6F11 event
|
|
// reports, S9F* errors, S10F1 terminal text). Each gets a
|
|
// user-settable observer callback.
|
|
//
|
|
// - High-level workflow shortcuts: establish_communication() (S1F13)
|
|
// and go_remote() (S1F17) are the standard GEM host startup pair.
|
|
//
|
|
// - Convenience senders for the GEM/E40/E94 message surface
|
|
// (see host_handler_senders.hpp for the full menu in B2/B3).
|
|
//
|
|
// Mirrors secsgem-py's `GemHostHandler` in `gem/hosthandler.py`. Equipment-
|
|
// side behaviour lives in the existing server app; pulling it into a
|
|
// matching `EquipmentHandler` class is a separate refactor.
|
|
namespace secsgem::gem {
|
|
|
|
class HostHandler : public std::enable_shared_from_this<HostHandler> {
|
|
public:
|
|
using ReplyHandler = std::function<void(std::error_code, const secs2::Message&)>;
|
|
using EventHandler = std::function<void(uint32_t dataid, uint32_t ceid,
|
|
const std::vector<ReportData>& reports)>;
|
|
using AlarmHandler = std::function<void(uint32_t alid, uint8_t alcd,
|
|
const std::string& altx)>;
|
|
using TerminalHandler = std::function<void(uint32_t tid, const std::string& text)>;
|
|
using S9Handler = std::function<void(uint8_t function,
|
|
const std::array<uint8_t, 10>& mhead)>;
|
|
using LogHandler = std::function<void(const std::string&)>;
|
|
|
|
explicit HostHandler(std::shared_ptr<hsms::Connection> conn);
|
|
|
|
// Inbound observers. Each is optional; if unset, the message is acked
|
|
// (where required) and otherwise ignored.
|
|
void set_event_handler(EventHandler h) { on_event_ = std::move(h); }
|
|
void set_alarm_handler(AlarmHandler h) { on_alarm_ = std::move(h); }
|
|
void set_terminal_handler(TerminalHandler h) { on_terminal_ = std::move(h); }
|
|
void set_s9_handler(S9Handler h) { on_s9_ = std::move(h); }
|
|
void set_log_handler(LogHandler h) { on_log_ = std::move(h); }
|
|
|
|
// Wire the inbound message handler into the underlying Connection.
|
|
// Call once before Connection::start() so the dispatch table is live
|
|
// when the first inbound primary arrives.
|
|
void install();
|
|
|
|
// ---- Workflow shortcuts ------------------------------------------------
|
|
|
|
// S1F13/F14 Establish Communication. Resolves `cb` with the equipment's
|
|
// S1F14 reply (or a timeout / error).
|
|
void establish_communication(ReplyHandler cb);
|
|
|
|
// S1F17/F18 Request Online. Equipment may reply Accepted / NotAllowed /
|
|
// AlreadyOnline; the raw S1F18 message is forwarded to `cb`.
|
|
void go_remote(ReplyHandler cb);
|
|
|
|
// S1F15/F16 Request Offline. Counterpart to go_remote().
|
|
void go_offline(ReplyHandler cb);
|
|
|
|
// ---- Status + subscription senders (B2) -------------------------------
|
|
|
|
// S1F3/F4 Selected Status Data: empty `svids` requests every SVID.
|
|
void send_selected_status(const std::vector<uint32_t>& svids, ReplyHandler cb);
|
|
|
|
// S1F11/F12 Status Variable Namelist: empty `svids` requests every name.
|
|
void send_status_namelist(const std::vector<uint32_t>& svids, ReplyHandler cb);
|
|
|
|
// S2F33/F34 Define Report. `reports[i] = {rptid, [vids]}`; an empty
|
|
// rptid list per request resets that report (per E30 §6.11).
|
|
void send_define_reports(
|
|
uint32_t dataid,
|
|
const std::vector<std::pair<uint32_t, std::vector<uint32_t>>>& reports,
|
|
ReplyHandler cb);
|
|
|
|
// S2F35/F36 Link Event Reports. `links[i] = {ceid, [rptids]}`.
|
|
void send_link_event_reports(
|
|
uint32_t dataid,
|
|
const std::vector<std::pair<uint32_t, std::vector<uint32_t>>>& links,
|
|
ReplyHandler cb);
|
|
|
|
// S2F37/F38 Enable/Disable Events. Empty `ceids` = all.
|
|
void send_enable_events(bool enable, const std::vector<uint32_t>& ceids,
|
|
ReplyHandler cb);
|
|
|
|
// ---- Low-level: forward a primary verbatim ----------------------------
|
|
void send_request(secs2::Message msg, ReplyHandler cb);
|
|
|
|
// Access to the underlying connection (sample apps and tests need it).
|
|
hsms::Connection& connection() { return *conn_; }
|
|
|
|
protected:
|
|
// Single inbound dispatch entry point — installed on Connection.
|
|
std::optional<secs2::Message> handle_inbound(const secs2::Message& msg);
|
|
|
|
void log(const std::string& msg);
|
|
|
|
std::shared_ptr<hsms::Connection> conn_;
|
|
EventHandler on_event_;
|
|
AlarmHandler on_alarm_;
|
|
TerminalHandler on_terminal_;
|
|
S9Handler on_s9_;
|
|
LogHandler on_log_;
|
|
};
|
|
|
|
} // namespace secsgem::gem
|