Route Configuration

​

Why Configure Routes in the Coreflux HUB?

You need to adjust route settings—connection parameters, events, mappings, and tags—without editing files or publishing MQTT commands. The Route Configuration in the HUB lets you edit routes with a form-based Visual Mode or switch to LoT Mode to modify the raw LoT code by hand.

​

When to Use It

• Updating connection settings — Change IP, port, credentials, or other config fields
• Adding events or mappings — Extend a route with new events, mappings, or tags
• Switching modes — Use Visual Mode for guided editing or LoT Mode for full control

For an overview of how to add routes, select route types, and use templates, see Routes Overview.

---

​

Visual Mode vs LoT Mode

Toggle between modes using the Visual Mode / LoT Mode toggle at the top of the route configuration panel. Changes in either mode are applied when you click Save Changes.

​

LoT Mode

Switch to LoT Mode to view and edit the full route definition as LoT code. This gives you direct control over the syntax and is useful for copying configurations or making bulk changes.

​

Renaming Elements

You can rename routes, events, mappings, and tags directly from the configuration panel. Click the pencil icon next to any element name to turn it into an editable text field, type the new name, and press Enter to confirm. A Renamed badge appears briefly to confirm the change. This works the same way for all element types:

• Route name — Displayed at the top of the configuration panel
• Event name — Displayed in the Events tab header for each event
• Mapping name — Displayed in the Mappings tab header for each mapping
• Tag name — Displayed in the tag header within a mapping

---

​

Configuration Tab

The Configuration tab shows the route’s connection and protocol settings (e.g., S7_CONFIG, SQL_CONFIG, MODBUS_CONFIG). Each field displays its name, whether it is required or optional, its data type, and a description.

• View fields — See all configuration fields with their types and descriptions
• Edit field — Change values in the input fields
• Add field — Click + Add Field to add optional fields from a list of available parameters
• Delete field — Use the delete icon on a field to remove it

​

Adding a Configuration Field

Click + Add Field to open the Add Configuration Field modal. This shows all optional fields available for the route type, along with their data types and descriptions.

---

​

Events Tab

The Events tab manages event definitions for the route. Events define how the route reacts to MQTT messages—typically by reading from or writing to the connected device or service.

• Add Event — Click + Add Event to create a new event with a name and fields
• Rename event — Click the pencil icon next to the event name to rename it
• Edit event — Expand an event to view and edit its fields (e.g., SOURCE_TOPIC, DESTINATION_TOPIC, QUERY)
• Add field — Use + Add Field within an event to add optional fields

​

Adding an Event Field

Click + Add Field inside an event to open the Add Event Field modal. This shows the optional fields available for the event.

---

​

Mappings Tab

The Mappings tab manages mapping definitions and tags. Mappings define periodic data polling from a connected device—reading tags at a set interval and publishing the data to MQTT topics.

• Add Mapping — Click + Add Mapping to create a new mapping with a name, mapping fields, and tags
• Rename mapping — Click the pencil icon next to the mapping name to rename it
• Edit mapping — Expand a mapping to edit its configuration (e.g., EVERY, SOURCE_TOPIC) and tags
• Add Tag — Use + Add Tag within a mapping to add tags with address, data type, and other properties

​

Adding a New Mapping

Click + Add Mapping to open the Add New Mapping modal. Enter a mapping name, then use + Add Field and + Add Tag to build the mapping.

​

Adding a Mapping Field

Click + Add Field inside a mapping to open the Add Mapping Field modal. This shows the optional fields available for the mapping, such as DESTINATION_TOPIC and QUERY.

​

Tags

Tags are defined inside mappings. Each tag represents a data point to read from the connected device. You can add, edit, rename, and remove tags and their properties (address, address type, data type, scaling, unit, etc.) from the Mappings tab. To rename a tag, click the pencil icon next to the tag name.

​

Saving and Canceling

• Save Changes — Applies all edits to the broker
• Cancel — Discards unsaved changes and closes the configuration panel

---

​

Next Steps