BACnetStack_SetBACnetSCHubConnectorForNetworkPort

bool BACnetStack_SetBACnetSCHubConnectorForNetworkPort(
  const uint32_t deviceInstance,
  const uint32_t scPortInstance,
  const uint8_t * vmac,
  const uint8_t vmacLength,
  const char * primaryHubUri,
  const uint16_t primaryHubUriLength,
  const char * failoverHubUri,
  const uint16_t failoverHubUriLength);

Configures the BACnet/SC hub connector of one named BACnet/SC Network Port object.

The per-port sibling of BACnetStack_SetBACnetSCHubConnector() above, matching BACnetStack_SetBACnetSCHubFunctionConfig()’s deviceInstance/scPortInstance shape. Configures the BACnet/SC data link instance serving the NAMED BACnet/SC Network Port object as a hub connector.

Note

URI lengths are limited to BACnetSCConstants::BACNET_SC_MAX_URI_LENGTH (255); longer URIs are rejected.

Note

Requires the STACK_OPTION_DATA_LINK_LAYER_SC (with STACK_OPTION_DATA_LINK_LAYER_IPV4) build option.

Parameters

Parameter	Direction	Description
deviceInstance	in	The BACnet device instance that owns the Network Port object.
scPortInstance	in	The object instance of the BACnet/SC Network Port object this configuration belongs to.
vmac, vmacLength	in	The 6-byte Virtual MAC address and its length. It is the port’s one VMAC, also presented by its hub function and on direct connections. NULL (or a length of 0) uses the default derived from the UUID; see BACnetStack_SetBACnetSCUuid().
primaryHubUri, primaryHubUriLength	in	The WebSocket URI of the primary hub.
failoverHubUri, failoverHubUriLength	in	The WebSocket URI of the failover hub (may be empty if none).

Returns

True if successfully configured, otherwise false.

Topic: BACnet/SC. Declared in CASBACnetStackDLL.h.