BACnetStack_SetBACnetSCHubConnector

bool BACnetStack_SetBACnetSCHubConnector(
  const uint8_t * vmac,
  const uint8_t vmacLength,
  const char * primaryHubUri,
  const uint16_t primaryHubUriLength,
  const char * failoverHubUri,
  const uint16_t failoverHubUriLength);

Configures this device as a BACnet/SC hub connector (initiator), specifying its VMAC and the primary/failover hub URIs to connect to.

Note

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

Note

This function always configures the FIRST BACnet/SC data link instance, regardless of which BACnet/SC Network Port object instance that happens to be. A device with two or more BACnet/SC ports should use BACnetStack_SetBACnetSCHubConnectorForNetworkPort() instead, to name the port explicitly.

Note

Requires the STACK_OPTION_DATA_LINK_LAYER_SC (with STACK_OPTION_DATA_LINK_LAYER_IPV4) build option.

Parameters

Parameter	Direction	Description
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.