dali/bacnet_stack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
577ecf8d7f0046e6a8a69455a4e78c251b72fe34
bacnet_stack/apps/server-mini/main.c
T
Steve Karg 3a0878a254 Add API for writable object property lists (#1206) 
Added a new API for writable property lists across all the basic example object types, preparing for the introduction of a Writable_Property_List property in every object in a future BACnet standard revision.

The lists can be used by backup and restore feature to automatically choose the object property values in the backup that can be restored via internal WriteProperty directly from BACnet CreateObject services with  List of Initial Values. 

Updated existing device object examples to include these writable property lists.
2026-01-21 10:02:21 -06:00

341 lines
8.7 KiB
C
Raw Blame History

/**
* @file
* @brief Mini BACnet server example for prototyping
*
* This example provides a minimal BACnet server for prototyping
* with the following default BACnet objects:
* - Two Read-Only Points: (AV-0), (BV-0)
* - Two Commandable (Writable) Points: (AO-0), (BO-0)
*
* If no arguments are provided, it defaults to:
* - Device ID: 260001
* - Device Name: "MiniServer"
*
* Usage on Linux
* $ ./bacmini 54321 MiniDevice
*
* Where:
* - 54321 is the BACnet Device Instance ID
* - "MiniDevice" is the BACnet Device Name
*
* @date 2025
*/
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
/* BACnet Stack includes */
#include "bacnet/apdu.h"
#include "bacnet/bacdcode.h"
#include "bacnet/bacdef.h"
#include "bacnet/bactext.h"
#include "bacnet/basic/binding/address.h"
#include "bacnet/basic/object/ao.h"
#include "bacnet/basic/object/av.h"
#include "bacnet/basic/object/bo.h"
#include "bacnet/basic/object/bv.h"
#include "bacnet/basic/object/device.h"
#include "bacnet/basic/services.h"
#include "bacnet/datalink/datalink.h"
#include "bacnet/datalink/dlenv.h"
#include "bacnet/dcc.h"
#include "bacnet/getevent.h"
#include "bacnet/iam.h"
#include "bacnet/npdu.h"
#include "bacnet/version.h"
#include "bacnet/basic/service/h_apdu.h"
#include "bacnet/basic/service/h_rp.h"
#include "bacnet/basic/service/h_whois.h"
#include "bacnet/basic/service/h_wp.h"
#include "bacnet/basic/service/s_iam.h"
#include "bacnet/basic/sys/platform.h"
/* Buffers */
static uint8_t Rx_Buf[MAX_MPDU] = { 0 };
/* Update interval in seconds */
/* Switches read only point values */
#define INTERVAL 5
typedef struct {
char *binary_state;
float analog_value;
} TestValue;
static TestValue test_values[] = {
{ "active", 1.0 },
{ "inactive", 2.0 },
{ "active", 3.0 },
{ "inactive", 4.0 },
};
/* BACnet Object Instances */
static uint32_t av_instance;
static uint32_t bv_instance;
static uint32_t ao_instance;
static uint32_t bo_instance;
/* Custom Object Table */
static object_functions_t My_Object_Table[] = {
/* device object required for all devices */
{ OBJECT_DEVICE,
NULL,
Device_Count,
Device_Index_To_Instance,
Device_Valid_Object_Instance_Number,
Device_Object_Name,
Device_Read_Property_Local,
Device_Write_Property_Local,
Device_Property_Lists,
DeviceGetRRInfo,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
Device_Writable_Property_List },
/* Analog Value (Read-Only) */
{ OBJECT_ANALOG_VALUE,
Analog_Value_Init,
Analog_Value_Count,
Analog_Value_Index_To_Instance,
Analog_Value_Valid_Instance,
Analog_Value_Object_Name,
Analog_Value_Read_Property,
NULL,
Analog_Value_Property_Lists,
NULL,
NULL,
Analog_Value_Encode_Value_List,
NULL,
NULL,
NULL,
NULL,
NULL,
Analog_Value_Create,
Analog_Value_Delete,
NULL,
Analog_Value_Writable_Property_List },
/* Analog Output (Commandable) */
{ OBJECT_ANALOG_OUTPUT,
Analog_Output_Init,
Analog_Output_Count,
Analog_Output_Index_To_Instance,
Analog_Output_Valid_Instance,
Analog_Output_Object_Name,
Analog_Output_Read_Property,
Analog_Output_Write_Property, /* Allow writes */
Analog_Output_Property_Lists,
NULL,
NULL,
Analog_Output_Encode_Value_List,
NULL,
NULL,
NULL,
NULL,
NULL,
Analog_Output_Create,
Analog_Output_Delete,
NULL,
Analog_Output_Writable_Property_List },
/* Binary Output (Commandable) */
{ OBJECT_BINARY_OUTPUT,
Binary_Output_Init,
Binary_Output_Count,
Binary_Output_Index_To_Instance,
Binary_Output_Valid_Instance,
Binary_Output_Object_Name,
Binary_Output_Read_Property,
Binary_Output_Write_Property, /* Allow writes */
Binary_Output_Property_Lists,
NULL,
NULL,
Binary_Output_Encode_Value_List,
NULL,
NULL,
NULL,
NULL,
NULL,
Binary_Output_Create,
Binary_Output_Delete,
NULL,
Binary_Output_Writable_Property_List },
/* Binary Value (Read-Only) */
{ OBJECT_BINARY_VALUE,
Binary_Value_Init,
Binary_Value_Count,
Binary_Value_Index_To_Instance,
Binary_Value_Valid_Instance,
Binary_Value_Object_Name,
Binary_Value_Read_Property,
NULL,
Binary_Value_Property_Lists,
NULL,
NULL,
Binary_Value_Encode_Value_List,
Binary_Value_Change_Of_Value,
Binary_Value_Change_Of_Value_Clear,
NULL,
NULL,
NULL,
Binary_Value_Create,
Binary_Value_Delete,
NULL,
Binary_Value_Writable_Property_List },
{ MAX_BACNET_OBJECT_TYPE,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL }
};
/**
* @brief Function to update AV-0 and BV-0 values.
*/
static void process_task(void)
{
static size_t test_index = 0;
TestValue next_value = test_values[test_index];
test_index = (test_index + 1) % ARRAY_SIZE(test_values);
if (!Analog_Value_Out_Of_Service(av_instance)) {
Analog_Value_Present_Value_Set(
av_instance, next_value.analog_value, BACNET_NO_PRIORITY);
printf("AV-0 updated to: %.1f\n", next_value.analog_value);
}
if (!Binary_Value_Out_Of_Service(bv_instance)) {
Binary_Value_Present_Value_Set(
bv_instance,
strcmp(next_value.binary_state, "active") == 0 ? 1 : 0);
printf("BV-0 updated to: %s\n", next_value.binary_state);
}
}
/**
* @brief Initializes the BACnet objects (AV-0, AO-0, BO-0, BV-0).
*/
static void Init_Service_Handlers(void)
{
Device_Init(My_Object_Table);
av_instance = Analog_Value_Create(0);
ao_instance = Analog_Output_Create(0);
bo_instance = Binary_Output_Create(0);
bv_instance = Binary_Value_Create(0);
/* Configure read-only Analog Value */
Analog_Value_Name_Set(av_instance, "AV Read Only");
Analog_Value_Units_Set(av_instance, UNITS_DEGREES_CELSIUS);
Analog_Value_Present_Value_Set(av_instance, 22.5, BACNET_MAX_PRIORITY);
/* Configure writable Analog Output */
Analog_Output_Name_Set(ao_instance, "AO Writeable");
Analog_Output_Units_Set(ao_instance, UNITS_PERCENT);
Analog_Output_Present_Value_Set(ao_instance, 50.0, BACNET_MAX_PRIORITY);
/* Configure writable Binary Output */
Binary_Output_Name_Set(bo_instance, "BO Writeable");
Binary_Output_Present_Value_Set(bo_instance, 0, BACNET_MAX_PRIORITY);
/* Configure read-only Binary Value */
Binary_Value_Name_Set(bv_instance, "BV Read Only");
printf("Created AV-0 (Read-Only), AO-0 (Commandable), BO-0 (Commandable), "
"and BV-0 (Read-Only)\n");
/* BACnet service handlers */
apdu_set_unconfirmed_handler(SERVICE_UNCONFIRMED_WHO_IS, handler_who_is);
apdu_set_confirmed_handler(
SERVICE_CONFIRMED_READ_PROPERTY, handler_read_property);
apdu_set_confirmed_handler(
SERVICE_CONFIRMED_WRITE_PROPERTY, handler_write_property);
apdu_set_unrecognized_service_handler_handler(handler_unrecognized_service);
}
/**
* @brief Main entry point for the BACnet server.
*/
int main(int argc, char *argv[])
{
BACNET_ADDRESS src = { 0 };
uint16_t pdu_len = 0;
unsigned timeout = 1000;
time_t last_update_time = 0;
time_t current_time;
const char *device_name = "MiniServer"; /* Default device name */
uint32_t device_instance = 123456; /* Default device instance ID */
printf("Starting BACnet Server...\n");
/* Handle command-line arguments */
if (argc > 1) {
bacnet_string_to_uint32(argv[1], &device_instance);
}
Device_Set_Object_Instance_Number(device_instance);
printf("BACnet Device ID: %u\n", device_instance);
/* Initialize BACnet stack */
dlenv_init();
Init_Service_Handlers();
atexit(datalink_cleanup);
if (argc > 2) {
device_name = argv[2];
}
Device_Object_Name_ANSI_Init(device_name);
printf("BACnet Device Name: %s\n", device_name);
/* Broadcast an I-Am message */
Send_I_Am(&Rx_Buf[0]);
/* Main loop */
while (1) {
pdu_len = datalink_receive(&src, &Rx_Buf[0], MAX_MPDU, timeout);
if (pdu_len) {
npdu_handler(&src, &Rx_Buf[0], pdu_len);
}
current_time = time(NULL);
if (difftime(current_time, last_update_time) >= INTERVAL) {
process_task();
last_update_time = current_time;
}
}
return EXIT_SUCCESS;
}
Reference in New Issue View Git Blame Copy Permalink