Bivrost Gateway Protocol

This document is the communication protocol reference for the Bivrost gateway, version v1.19.7, intended for developers who need to integrate with the gateway programmatically. For instructions on installing and configuring the gateway and using its web management interface, please refer to the Bivrost Gateway Manual (referred to below as the “Manual”).

The gateway supports the following communication methods:

Communication Method	Description
HTTP Communication	Actively read/write machine data, transfer files, analyze data, and configure the gateway via HTTP interfaces. All features have corresponding interfaces
MODBUS Communication	The gateway acts as a MODBUS server (port 502), storing automatic data collection task results in the corresponding address locations
MQTT Communication	The gateway publishes automatic data collection task results as JSON messages to the specified MQTT server, and supports an RPC interface
Database Communication	The gateway writes automatic data collection task results to the specified database (InfluxDB, MySQL, SQL Server, PostgreSQL, etc.)

Suggested reading order: first read 1. Important Notes for the common identifiers, data classes, and variable definitions, then consult the corresponding section based on the communication method you use. If you don’t have an actual machine tool available, you can use the mock machine to quickly test the communication protocol.