Added additional examples for TS, UTCTS, RD, and DCC

Author: afontaine-chipkin

BACnetClientExample/BACnetClientExample.cpp

@@ -71,6 +71,7 @@ const uint32_t SETTING_CLIENT_DEVICE_INSTANCE = 389002;
 const uint16_t SETTING_DOWNSTREAM_DEVICE_PORT = SETTING_BACNET_IP_PORT;
 const uint32_t SETTING_DOWNSTREAM_DEVICE_INSTANCE = 389999; 
 const std::string SETTING_DEFAULT_DOWNSTREAM_DEVICE_IP_ADDRESS = "192.168.2.217";
+const std::string SETTING_DEFAULT_DEVICE_PASSWORD = "12345";
 
 // Downstream IP Initialization
 // =======================================
@@ -128,6 +129,9 @@ void ExampleWriteProperty();
 void ExampleSubscribeCOV();
 void ExampleSubscribeCOVProperty();
 void ExampleConfirmedTextMessage();
+void ExampleTimeSynchronizationMessage();
+void ExampleReinitializeDevice();
+void ExampleDeviceCommunicationControl(bool enable);
 
 int main(int argc, char ** argv )
 {
@@ -288,18 +292,35 @@ bool DoUserInput()
 			ExampleWriteProperty();
 			break; 
 		}
-		case 'c': {
+		case 's': {
 			ExampleSubscribeCOV();
 			break;
 		}
 		case 'p': {
 			ExampleSubscribeCOVProperty();
 			break;
 		}
-		case 't': {
+		case 'm': {
 			ExampleConfirmedTextMessage();
 			break;
 		}
+		case 't': {
+			ExampleTimeSynchronizationMessage();
+			break;
+		}
+		case 'i': {
+			ExampleReinitializeDevice();
+			break;
+		}
+		case 'd': {
+			ExampleDeviceCommunicationControl(false);
+			break;
+		}
+		case 'e': {
+			ExampleDeviceCommunicationControl(true);
+			break;
+		}
+		case 'h':
 		default: {
 			// Print the Help
 			std::cout << std::endl << std::endl;
@@ -310,12 +331,18 @@ bool DoUserInput()
 			std::cout << "Example: BACnetClient 192.168.1.126" << std::endl << std::endl;
 
 			std::cout << "Help: " << std::endl;
-			std::cout << "- Q - Quit" << std::endl;
 			std::cout << "- W - Send WhoIs message" << std::endl;
-			std::cout << "- R - Send Read property messages" << std::endl;
-			std::cout << "- U - Send Write property messages" << std::endl;
-			std::cout << "- C - Send Subscribe COV Request" << std::endl;
-			std::cout << "- T - Send Confirmed Text Message Request" << std::endl;
+			std::cout << "- R - Send ReadProperty messages" << std::endl;
+			std::cout << "- U - Send WriteProperty messages" << std::endl;
+			std::cout << "- S - Send SubscribeCOV Request" << std::endl;
+			std::cout << "- P - Send SubscribeCOVProperty Request" << std::endl;
+			std::cout << "- M - Send ConfirmedTextMessage Request" << std::endl;
+			std::cout << "- T - Send TimeSynchronization Request" << std::endl;
+			std::cout << "- R - Send ReinitializedDevice Request" << std::endl;
+			std::cout << "- D - Send DeviceCommunicationControl Request to Disable" << std::endl;
+			std::cout << "- E - Send DeviceCommunicationControl Request to Enable" << std::endl;
+			std::cout << "- H - Display Help information" << std::endl;
+			std::cout << "- Q - Quit" << std::endl;
 			std::cout << std::endl;
 			break;
 		}
@@ -481,6 +508,59 @@ void ExampleConfirmedTextMessage() {
 	WaitForResponse();
 }
 
+void ExampleTimeSynchronizationMessage() {
+	// Time Synchronization Settings
+	uint8_t year = 2024 - 1900;
+	uint8_t month = 8;
+	uint8_t day = 15;
+	uint8_t weekday = 3;
+	uint8_t hour = 8;
+	uint8_t minute = 8;
+	uint8_t seconds = 8;
+	uint8_t hundrethSeconds = 0;
+
+	// Send TimeSynchronization request
+	// C++ server example configured to handle
+	std::cout << "Sending TimeSynchronization Message";
+	fpSendTimeSynchronization(year, month, day, weekday, hour, minute, seconds, hundrethSeconds, downstreamConnectionString, 6, 0, false, 0, NULL, 0);
+
+	WaitForResponse();	
+	// Note: TimeSynchronization is an unconfirmed request, which means the downstream device will not response.
+	// The WaitForResponse is called here just to wait for some cycles before continuing.
+
+	// Send UtcTimeSynchronization request
+	// C++ server example configured to handle
+	std::cout << "Sending UTCTimeSynchronization Message";
+	fpSendUTCTimeSynchronization(year, month, day, weekday, hour, minute, seconds, hundrethSeconds, downstreamConnectionString, 6, 0, false, 0, NULL, 0);
+
+	WaitForResponse();
+}
+
+void ExampleReinitializeDevice() {
+	// ReinitializeDevice Settings
+	uint8_t reinitializedState = CASBACnetStackExampleConstants::REINITIALIZED_STATE_ACTIVATE_CHANGES;
+
+	// Send ReinitializeDevice request
+	// C++ server example configured to handle
+	std::cout << "Sending ReinitializeDevice Message to activate changes";
+	fpSendReinitializeDevice(&invokeId, reinitializedState, SETTING_DEFAULT_DEVICE_PASSWORD.c_str(), SETTING_DEFAULT_DEVICE_PASSWORD.length(), downstreamConnectionString, 6, 0, 0, NULL, 0);
+}
+
+void ExampleDeviceCommunicationControl(bool enable) {
+	if (enable) {
+		// Send DeviceCommunicationControl request
+		// C++ server example configured to handle
+		std::cout << "Sending DeviceCommunicationControl Message to enable BACnet communication";
+		fpSendDeviceCommunicationControl(&invokeId, CASBACnetStackExampleConstants::ENABLEDISABLE_ENABLE, false, 0, SETTING_DEFAULT_DEVICE_PASSWORD.c_str(), SETTING_DEFAULT_DEVICE_PASSWORD.length(), downstreamConnectionString, 6, 0, 0, NULL, 0);
+	}
+	else {
+		// Send DeviceCommunicationControl request
+		// C++ server example configured to handle
+		std::cout << "Sending DeviceCommunicationControl Message to disable BACnet communication";
+		fpSendDeviceCommunicationControl(&invokeId, CASBACnetStackExampleConstants::ENABLEDISABLE_DISABLE, false, 0, SETTING_DEFAULT_DEVICE_PASSWORD.c_str(), SETTING_DEFAULT_DEVICE_PASSWORD.length(), downstreamConnectionString, 6, 0, 0, NULL, 0);
+	}
+}
+
 
 // ================================================================================================
 // Callbacks 

BACnetClientExample/CASBACnetStackExampleConstants.h

@@ -166,6 +166,16 @@ class CASBACnetStackExampleConstants {
 	static const uint32_t DATA_TYPE_DATE = 10;
 	static const uint32_t DATA_TYPE_TIME = 11;
 	static const uint32_t DATA_TYPE_BACNET_OBJECT_IDENTIFIER = 12;
+
+	// Reinitialzed States (Used for ReinitializeDevice)
+	static const uint8_t REINITIALIZED_STATE_COLDSTART = 0;
+	static const uint8_t REINITIALIZED_STATE_WARMSTART = 1;
+	static const uint8_t REINITIALIZED_STATE_ACTIVATE_CHANGES = 7;
+
+	// Enable/Disable Enumerations  (Used for DeviceCommunicationControl)
+	static const uint8_t ENABLEDISABLE_ENABLE = 0;
+	static const uint8_t ENABLEDISABLE_DISABLE = 1;
+	static const uint8_t ENABLEDISABLE_DISABLE_INITIATION = 2;
 };
 
 #endif // __CASBACnetStackExampleConstants_h__

CHANGELOG.md

@@ -5,6 +5,9 @@
 ### 1.0.0 (2024-Oct-29)
 
 - Updated example to use with BACnetStack version 5.1.2.0
+- Added TimeSynchronization example
+- Added ReinitializeDevice example
+- Added DeviceCommunicationControl example
 
 ## Version 0.0.x