#ifndef OBN_PLUGIN_RUNNER_PLUGIN_LOADER_HPP #define OBN_PLUGIN_RUNNER_PLUGIN_LOADER_HPP #include #include "obn/bambu_networking.hpp" namespace obn::plugin_runner { // Function-pointer aliases mirror Studio's NetworkAgent.hpp typedefs // 1:1 — the per-ABI snapshots under tools/abi_snapshot/v/ // NetworkAgent.hpp are the canonical record. Only the subset we // actually call is declared. using func_check_debug_consistent = int (*)(void* agent); using func_get_version = std::string (*)(); using func_create_agent = void* (*)(std::string log_dir); using func_destroy_agent = int (*)(void* agent); using func_init_log = int (*)(void* agent); using func_set_config_dir = int (*)(void* agent, std::string config_dir); using func_set_cert_file = int (*)(void* agent, std::string folder, std::string filename); using func_set_country_code = int (*)(void* agent, std::string country_code); using func_start = int (*)(void* agent); using func_set_on_printer_connected_fn = int (*)(void* agent, BBL::OnPrinterConnectedFn fn); using func_set_on_server_connected_fn = int (*)(void* agent, BBL::OnServerConnectedFn fn); using func_set_on_http_error_fn = int (*)(void* agent, BBL::OnHttpErrorFn fn); using func_set_get_country_code_fn = int (*)(void* agent, BBL::GetCountryCodeFn fn); using func_set_on_subscribe_failure_fn = int (*)(void* agent, BBL::GetSubscribeFailureFn fn); using func_set_on_message_fn = int (*)(void* agent, BBL::OnMessageFn fn); using func_set_on_user_message_fn = int (*)(void* agent, BBL::OnMessageFn fn); using func_set_on_local_connect_fn = int (*)(void* agent, BBL::OnLocalConnectedFn fn); using func_set_on_local_message_fn = int (*)(void* agent, BBL::OnMessageFn fn); using func_set_queue_on_main_fn = int (*)(void* agent, BBL::QueueOnMainFn fn); using func_start_subscribe = int (*)(void* agent, std::string module); using func_send_message_to_printer = int (*)(void* agent, std::string dev_id, std::string json_str, int qos, int flag); using func_set_on_ssdp_msg_fn = int (*)(void* agent, BBL::OnMsgArrivedFn fn); using func_set_server_callback = int (*)(void* agent, BBL::OnServerErrFn fn); using func_set_extra_http_header = int (*)(void* agent, std::map extra_headers); using func_enable_multi_machine = void (*)(void* agent, bool enable); using func_start_discovery = bool (*)(void* agent, bool start, bool sending); using func_connect_printer = int (*)(void* agent, std::string dev_id, std::string dev_ip, std::string username, std::string password, bool use_ssl); using func_disconnect_printer = int (*)(void* agent); using func_change_user = int (*)(void* agent, std::string user_info); using func_is_user_login = bool (*)(void* agent); using func_bind_detect = int (*)(void* agent, std::string dev_ip, std::string sec_link, BBL::detectResult& detect); // Provisions the per-printer device certificate the plugin uses to RSA-sign // privileged MQTT commands (project_file, etc.). Studio calls this from // set_on_printer_connected_fn right after command_request_push_all; without // it bambu_network_send_message_to_printer rejects any payload whose // top-level key is `print` / `upgrade` / `liveview` with rc=-4 — the same // error start_local_print surfaces as -4030 ("send msg failed") on the // Sending stage. using func_install_device_cert = void (*)(void* agent, std::string dev_id, bool lan_only); using func_start_send_gcode_to_sdcard = int (*)(void* agent, BBL::PrintParams params, BBL::OnUpdateStatusFn update_fn, BBL::WasCancelledFn cancel_fn, BBL::OnWaitFn wait_fn); using func_start_local_print = int (*)(void* agent, BBL::PrintParams params, BBL::OnUpdateStatusFn update_fn, BBL::WasCancelledFn cancel_fn); using func_start_sdcard_print = int (*)(void* agent, BBL::PrintParams params, BBL::OnUpdateStatusFn update_fn, BBL::WasCancelledFn cancel_fn); using func_start_local_print_with_record = int (*)(void* agent, BBL::PrintParams params, BBL::OnUpdateStatusFn update_fn, BBL::WasCancelledFn cancel_fn, BBL::OnWaitFn wait_fn); // Resolved entry points. Required pointers are validated by load(); optional // pointers stay null if absent so the caller can branch on availability // without crashing on older plugins. struct PluginExports { void* dl_handle = nullptr; std::string so_path; std::string version; // Required for any meaningful use: func_create_agent create_agent = nullptr; func_destroy_agent destroy_agent = nullptr; func_init_log init_log = nullptr; func_set_config_dir set_config_dir = nullptr; func_set_cert_file set_cert_file = nullptr; func_set_country_code set_country_code = nullptr; func_start start = nullptr; func_get_version get_version = nullptr; func_connect_printer connect_printer = nullptr; func_disconnect_printer disconnect_printer = nullptr; // Callback installers (all required by stock plugins, even if we hand // them no-op lambdas — calling start() before they're set tends to // crash on null std::function invocation): func_set_on_printer_connected_fn set_on_printer_connected_fn = nullptr; func_set_on_server_connected_fn set_on_server_connected_fn = nullptr; func_set_on_http_error_fn set_on_http_error_fn = nullptr; func_set_get_country_code_fn set_get_country_code_fn = nullptr; func_set_on_subscribe_failure_fn set_on_subscribe_failure_fn = nullptr; func_set_on_message_fn set_on_message_fn = nullptr; func_set_on_user_message_fn set_on_user_message_fn = nullptr; func_set_on_local_connect_fn set_on_local_connect_fn = nullptr; func_set_on_local_message_fn set_on_local_message_fn = nullptr; func_set_queue_on_main_fn set_queue_on_main_fn = nullptr; func_start_subscribe start_subscribe = nullptr; // Direct MQTT publish onto device//request. The killer // primitive for reverse-engineering the print command JSON shape: // hand-craft a payload, observe what the printer reports back via // local_message, iterate. qos=1 / flag=0 mirror the values Studio // uses for printer commands (MessageFlag::MSG_FLAG_NONE). func_send_message_to_printer send_message_to_printer = nullptr; func_set_on_ssdp_msg_fn set_on_ssdp_msg_fn = nullptr; func_set_server_callback set_server_callback = nullptr; // X-BBL-* HTTP headers Studio installs before start(); the plugin // attaches them to every outgoing HTTP request, including the LAN // /info ping inside bind_detect and the cloud auth flow. Some // builds gate critical paths on at least X-BBL-Client-Type being // present. func_set_extra_http_header set_extra_http_header = nullptr; // Multi-machine + SSDP discovery — Studio always wires both up // before start(). Most LAN-only print actions don't strictly need // them, but stock plugins still query their state during the MQTT // handshake; missing wires can leave the plugin in a half-init // state where local_connect fires status=Failed without an // underlying network error. func_enable_multi_machine enable_multi_machine = nullptr; func_start_discovery start_discovery = nullptr; // User session — all stock plugins refuse LAN print until change_user() // has been called once (even with an empty payload to mark "logged out"): func_change_user change_user = nullptr; func_is_user_login is_user_login = nullptr; func_check_debug_consistent check_debug_consistent = nullptr; func_install_device_cert install_device_cert = nullptr; // bind_detect is the LAN /info ping Studio runs before connect_printer. // The stock plugin uses its result (connect_type, bind_state) to decide // whether to attempt MQTT and which credentials path to wire up. Skip // it and connect_printer can return success but the actual MQTT // connect ends up status=ConnectStatusFailed without a clear error // (msg="-1"). Required for any LAN flow. func_bind_detect bind_detect = nullptr; // Print actions. At least one of the four must be present for the // wanted --action; main.cpp validates per-action. func_start_send_gcode_to_sdcard start_send_gcode_to_sdcard = nullptr; func_start_local_print start_local_print = nullptr; func_start_sdcard_print start_sdcard_print = nullptr; func_start_local_print_with_record start_local_print_with_record = nullptr; }; // Loads `so_path`, resolves all entry points listed above. Throws // std::runtime_error with a descriptive message if dlopen fails or any // *required* entry point is missing. Optional entry points (the four // start_*_print* family) only fail at action-dispatch time. PluginExports load(const std::string& so_path); // Releases the dl handle and zeroes pointers. Safe on a default-constructed // PluginExports. void unload(PluginExports& exports); } // namespace obn::plugin_runner #endif // OBN_PLUGIN_RUNNER_PLUGIN_LOADER_HPP