--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/bacnet/runtime/device.h Mon Jun 18 12:12:57 2018 +0300
@@ -0,0 +1,369 @@
+/**************************************************************************
+*
+* Copyright (C) 2005 Steve Karg <skarg@users.sourceforge.net>
+* Copyright (C) 2017 Mario de Sousa <msousa@fe.up.pt>
+*
+* Permission is hereby granted, free of charge, to any person obtaining
+* a copy of this software and associated documentation files (the
+* "Software"), to deal in the Software without restriction, including
+* without limitation the rights to use, copy, modify, merge, publish,
+* distribute, sublicense, and/or sell copies of the Software, and to
+* permit persons to whom the Software is furnished to do so, subject to
+* the following conditions:
+*
+* The above copyright notice and this permission notice shall be included
+* in all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*
+*********************************************************************/
+
+/** device.h Defines functions for handling all BACnet objects belonging
+ * to a BACnet device, as well as Device-specific properties. */
+
+#ifndef DEVICE_H
+#define DEVICE_H
+
+#include <stdbool.h>
+#include <stdint.h>
+#include "bacdef.h"
+#include "bacenum.h"
+#include "wp.h"
+#include "rd.h"
+#include "rp.h"
+#include "rpm.h"
+#include "readrange.h"
+
+/** Called so a BACnet object can perform any necessary initialization.
+ */
+typedef void (
+ *object_init_function) (
+ void);
+
+/** Counts the number of objects of this type.
+ * return: Count of implemented objects of this type.
+ */
+typedef unsigned (
+ *object_count_function) (
+ void);
+
+/** Maps an object index position to its corresponding BACnet object instance number.
+ * param: index [in] The index of the object, in the array of objects of its type.
+ * return: The BACnet object instance number to be used in a BACNET_OBJECT_ID.
+ */
+typedef uint32_t(
+ *object_index_to_instance_function)
+ (
+ unsigned index);
+
+/** Provides the BACnet Object_Name for a given object instance of this type.
+ * param: object_instance [in] The object instance number to be looked up.
+ * param: object_name [in,out] Pointer to a character_string structure that
+ * will hold a copy of the object name if this is a valid object_instance.
+ * return: True if the object_instance is valid and object_name has been
+ * filled with a copy of the Object's name.
+ */
+typedef bool(
+ *object_name_function)
+ (
+ uint32_t object_instance,
+ BACNET_CHARACTER_STRING * object_name);
+
+/** Look in the table of objects of this type, and see if this is a valid
+ * instance number.
+ * param: [in] The object instance number to be looked up.
+ * return: True if the object instance refers to a valid object of this type.
+ */
+typedef bool(
+ *object_valid_instance_function) (
+ uint32_t object_instance);
+
+/** Helper function to step through an array of objects and find either the
+ * first one or the next one of a given type. Used to step through an array
+ * of objects which is not necessarily contiguious for each type i.e. the
+ * index for the 'n'th object of a given type is not necessarily 'n'.
+ * param: [in] The index of the current object or a value of ~0 to indicate
+ * start at the beginning.
+ * return: The index of the next object of the required type or ~0 (all bits
+ * == 1) to indicate no more objects found.
+ */
+typedef unsigned (
+ *object_iterate_function) (
+ unsigned current_index);
+
+/** Look in the table of objects of this type, and get the COV Value List.
+ * param: [in] The object instance number to be looked up.
+ * param: [out] The value list
+ * return: True if the object instance supports this feature, and has changed.
+ */
+typedef bool(
+ *object_value_list_function) (
+ uint32_t object_instance,
+ BACNET_PROPERTY_VALUE * value_list);
+
+/** Look in the table of objects for this instance to see if value changed.
+ * param: [in] The object instance number to be looked up.
+ * return: True if the object instance has changed.
+ */
+typedef bool(
+ *object_cov_function) (
+ uint32_t object_instance);
+
+/** Look in the table of objects for this instance to clear the changed flag.
+ * param: [in] The object instance number to be looked up.
+ */
+typedef void (
+ *object_cov_clear_function) (
+ uint32_t object_instance);
+
+/** Intrinsic Reporting funcionality.
+ * param: [in] Object instance.
+ */
+typedef void (
+ *object_intrinsic_reporting_function) (
+ uint32_t object_instance);
+
+
+/** Defines the group of object helper functions for any supported Object.
+ * Each Object must provide some implementation of each of these helpers
+ * in order to properly support the handlers. Eg, the ReadProperty handler
+ * handler_read_property() relies on the instance of Object_Read_Property
+ * for each Object type, or configure the function as NULL.
+ * In both appearance and operation, this group of functions acts like
+ * they are member functions of a C++ Object base class.
+ */
+typedef struct object_functions {
+ BACNET_OBJECT_TYPE Object_Type;
+ object_init_function Object_Init;
+ object_count_function Object_Count;
+ object_index_to_instance_function Object_Index_To_Instance;
+ object_valid_instance_function Object_Valid_Instance;
+ object_name_function Object_Name;
+ read_property_function Object_Read_Property;
+ write_property_function Object_Write_Property;
+ rpm_property_lists_function Object_RPM_List;
+ rr_info_function Object_RR_Info;
+ object_iterate_function Object_Iterator;
+ object_value_list_function Object_Value_List;
+ object_cov_function Object_COV;
+ object_cov_clear_function Object_COV_Clear;
+ object_intrinsic_reporting_function Object_Intrinsic_Reporting;
+} object_functions_t;
+
+/* String Lengths for Device Object properties that may be changed
+ * (written to) over the BACnet network.
+ * Maximum sizes excluding nul terminator .
+ */
+#define STRLEN_X(minlen, str) (((minlen)>sizeof(str))?(minlen):sizeof(str))
+#define MAX_DEV_NAME_LEN STRLEN_X(32, "%(BACnet_Device_Name)s") /* Device name */
+#define MAX_DEV_LOC_LEN STRLEN_X(64, BACNET_DEVICE_LOCATION) /* Device location */
+#define MAX_DEV_MOD_LEN STRLEN_X(32, BACNET_DEVICE_MODEL_NAME) /* Device model name */
+#define MAX_DEV_VER_LEN STRLEN_X(16, BACNET_DEVICE_APPSOFT_VER) /* Device application software version */
+#define MAX_DEV_DESC_LEN STRLEN_X(64, BACNET_DEVICE_DESCRIPTION) /* Device description */
+
+/** Structure to define the Object Properties common to all Objects. */
+typedef struct commonBacObj_s {
+
+ /** The BACnet type of this object (ie, what class is this object from?).
+ * This property, of type BACnetObjectType, indicates membership in a
+ * particular object type class. Each inherited class will be of one type.
+ */
+ BACNET_OBJECT_TYPE mObject_Type;
+
+ /** The instance number for this class instance. */
+ uint32_t Object_Instance_Number;
+
+ /** Object Name; must be unique.
+ * This property, of type CharacterString, shall represent a name for
+ * the object that is unique within the BACnet Device that maintains it.
+ */
+ char Object_Name[MAX_DEV_NAME_LEN];
+
+} COMMON_BAC_OBJECT;
+
+
+/** Structure to define the Properties of Device Objects which distinguish
+ * one instance from another.
+ * This structure only defines fields for properties that are unique to
+ * a given Device object. The rest may be fixed in device.c or hard-coded
+ * into the read-property encoding.
+ * This may be useful for implementations which manage multiple Devices,
+ * eg, a Gateway.
+ */
+typedef struct devObj_s {
+ /** The BACnet Device Address for this device; ->len depends on DLL type. */
+ BACNET_ADDRESS bacDevAddr;
+
+ /** Structure for the Object Properties common to all Objects. */
+ COMMON_BAC_OBJECT bacObj;
+
+ /** Device Description. */
+ char Description[MAX_DEV_DESC_LEN];
+
+ /** The upcounter that shows if the Device ID or object structure has changed. */
+ uint32_t Database_Revision;
+} DEVICE_OBJECT_DATA;
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+ void Device_Init(
+ const char * Device_Object_Name);
+
+ bool Device_Reinitialize(
+ BACNET_REINITIALIZE_DEVICE_DATA * rd_data);
+
+ BACNET_REINITIALIZED_STATE Device_Reinitialized_State(
+ void);
+
+ rr_info_function Device_Objects_RR_Info(
+ BACNET_OBJECT_TYPE object_type);
+
+ void Device_getCurrentDateTime(
+ BACNET_DATE_TIME * DateTime);
+ int32_t Device_UTC_Offset(void);
+ bool Device_Daylight_Savings_Status(void);
+
+ void Device_Property_Lists(
+ const int **pRequired,
+ const int **pOptional,
+ const int **pProprietary);
+ void Device_Objects_Property_List(
+ BACNET_OBJECT_TYPE object_type,
+ struct special_property_list_t *pPropertyList);
+ /* functions to support COV */
+ bool Device_Encode_Value_List(
+ BACNET_OBJECT_TYPE object_type,
+ uint32_t object_instance,
+ BACNET_PROPERTY_VALUE * value_list);
+ bool Device_Value_List_Supported(
+ BACNET_OBJECT_TYPE object_type);
+ bool Device_COV(
+ BACNET_OBJECT_TYPE object_type,
+ uint32_t object_instance);
+ void Device_COV_Clear(
+ BACNET_OBJECT_TYPE object_type,
+ uint32_t object_instance);
+
+ uint32_t Device_Object_Instance_Number(
+ void);
+ bool Device_Set_Object_Instance_Number(
+ uint32_t object_id);
+ bool Device_Valid_Object_Instance_Number(
+ uint32_t object_id);
+ unsigned Device_Object_List_Count(
+ void);
+ bool Device_Object_List_Identifier(
+ unsigned array_index,
+ int *object_type,
+ uint32_t * instance);
+
+ unsigned Device_Count(
+ void);
+ uint32_t Device_Index_To_Instance(
+ unsigned index);
+
+ bool Device_Object_Name(
+ uint32_t object_instance,
+ BACNET_CHARACTER_STRING * object_name);
+ bool Device_Set_Object_Name(
+ BACNET_CHARACTER_STRING * object_name);
+ /* Copy a child object name, given its ID. */
+ bool Device_Object_Name_Copy(
+ BACNET_OBJECT_TYPE object_type,
+ uint32_t object_instance,
+ BACNET_CHARACTER_STRING * object_name);
+ bool Device_Object_Name_ANSI_Init(const char * value);
+
+ BACNET_DEVICE_STATUS Device_System_Status(
+ void);
+ int Device_Set_System_Status(
+ BACNET_DEVICE_STATUS status,
+ bool local);
+
+ const char *Device_Vendor_Name(
+ void);
+
+ uint16_t Device_Vendor_Identifier(
+ void);
+ void Device_Set_Vendor_Identifier(
+ uint16_t vendor_id);
+
+ const char *Device_Model_Name(
+ void);
+ bool Device_Set_Model_Name(
+ const char *name,
+ size_t length);
+
+ const char *Device_Firmware_Revision(
+ void);
+
+ const char *Device_Application_Software_Version(
+ void);
+ bool Device_Set_Application_Software_Version(
+ const char *name,
+ size_t length);
+
+ const char *Device_Description(
+ void);
+ bool Device_Set_Description(
+ const char *name,
+ size_t length);
+
+ const char *Device_Location(
+ void);
+ bool Device_Set_Location(
+ const char *name,
+ size_t length);
+
+ /* some stack-centric constant values - no set methods */
+ uint8_t Device_Protocol_Version(
+ void);
+ uint8_t Device_Protocol_Revision(
+ void);
+ BACNET_SEGMENTATION Device_Segmentation_Supported(
+ void);
+
+ uint32_t Device_Database_Revision(
+ void);
+ void Device_Set_Database_Revision(
+ uint32_t revision);
+ void Device_Inc_Database_Revision(
+ void);
+
+ bool Device_Valid_Object_Name(
+ BACNET_CHARACTER_STRING * object_name,
+ int *object_type,
+ uint32_t * object_instance);
+ bool Device_Valid_Object_Id(
+ int object_type,
+ uint32_t object_instance);
+
+ int Device_Read_Property(
+ BACNET_READ_PROPERTY_DATA * rpdata);
+ bool Device_Write_Property(
+ BACNET_WRITE_PROPERTY_DATA * wp_data);
+
+ bool DeviceGetRRInfo(
+ BACNET_READ_RANGE_DATA * pRequest, /* Info on the request */
+ RR_PROP_INFO * pInfo); /* Where to put the information */
+
+ int Device_Read_Property_Local(
+ BACNET_READ_PROPERTY_DATA * rpdata);
+ bool Device_Write_Property_Local(
+ BACNET_WRITE_PROPERTY_DATA * wp_data);
+
+
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+#endif