/** * @file * @author Steve Karg * @date 2014 * @brief The Integer Value object is an object with a present-value that * uses an INTEGER data type. * @copyright SPDX-License-Identifier: MIT */ #include #include #include #include #include #include /* BACnet Stack defines - first */ #include "bacnet/bacdef.h" /* BACnet Stack API */ #include "bacnet/bacdcode.h" #include "bacnet/bacapp.h" #include "bacnet/bactext.h" #include "bacnet/proplist.h" /* basic objects and services */ #include "bacnet/basic/object/device.h" #include "bacnet/basic/services.h" #include "bacnet/basic/sys/debug.h" #include "bacnet/basic/sys/keylist.h" /* me! */ #include "bacnet/basic/object/iv.h" /* Key List for storing the object data sorted by instance number */ static OS_Keylist Object_List = NULL; /* common object type */ static const BACNET_OBJECT_TYPE Object_Type = OBJECT_INTEGER_VALUE; /* callback for present value writes */ static integer_value_write_present_value_callback Integer_Value_Write_Present_Value_Callback; struct integer_object { bool Out_Of_Service : 1; bool Changed : 1; int32_t Present_Value; int32_t Prior_Value; uint32_t COV_Increment; uint16_t Units; uint32_t Instance; const char *Object_Name; const char *Description; } INTERGER_VALUE_DESCR; /* These three arrays are used by the ReadPropertyMultiple handler */ static const int Integer_Value_Properties_Required[] = { PROP_OBJECT_IDENTIFIER, PROP_OBJECT_NAME, PROP_OBJECT_TYPE, PROP_PRESENT_VALUE, PROP_STATUS_FLAGS, PROP_UNITS, -1 }; static const int Integer_Value_Properties_Optional[] = { PROP_OUT_OF_SERVICE, PROP_DESCRIPTION, PROP_COV_INCREMENT, -1 }; static const int Integer_Value_Properties_Proprietary[] = { -1 }; /** * Returns the list of required, optional, and proprietary properties. * Used by ReadPropertyMultiple service. * * @param pRequired - pointer to list of int terminated by -1, of * BACnet required properties for this object. * @param pOptional - pointer to list of int terminated by -1, of * BACnet optkional properties for this object. * @param pProprietary - pointer to list of int terminated by -1, of * BACnet proprietary properties for this object. */ void Integer_Value_Property_Lists( const int **pRequired, const int **pOptional, const int **pProprietary) { if (pRequired) { *pRequired = Integer_Value_Properties_Required; } if (pOptional) { *pOptional = Integer_Value_Properties_Optional; } if (pProprietary) { *pProprietary = Integer_Value_Properties_Proprietary; } return; } /** * @brief Gets an object from the list using an instance number as the key * @param object_instance - object-instance number of the object * @return object found in the list, or NULL if not found */ static struct integer_object *Integer_Value_Object(uint32_t object_instance) { return Keylist_Data(Object_List, object_instance); } /** * Determines if a given Integer Value instance is valid * * @param object_instance - object-instance number of the object * * @return true if the instance is valid, and false if not */ bool Integer_Value_Valid_Instance(uint32_t object_instance) { struct integer_object *pObject = Integer_Value_Object(object_instance); return (pObject != NULL); } /** * Determines the number of Integer Value objects * * @return Number of Integer Value objects */ unsigned Integer_Value_Count(void) { return Keylist_Count(Object_List); } /** * Determines the object instance-number for a given 0..N index * of Integer Value objects where N is Integer_Value_Count(). * * @param index - 0..MAX_INTEGER_VALUES value * * @return object instance-number for the given index */ uint32_t Integer_Value_Index_To_Instance(unsigned index) { KEY key = UINT32_MAX; Keylist_Index_Key(Object_List, index, &key); return key; } /** * For a given object instance-number, determines a 0..N index * of Integer Value objects where N is Integer_Value_Count(). * * @param object_instance - object-instance number of the object * * @return index for the given instance-number, or MAX_INTEGER_VALUES * if not valid. */ unsigned Integer_Value_Instance_To_Index(uint32_t object_instance) { return Keylist_Index(Object_List, object_instance); } /** * For a given object instance-number, determines the present-value * * @param object_instance - object-instance number of the object * * @return present-value of the object */ int32_t Integer_Value_Present_Value(uint32_t object_instance) { int32_t value = 0; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { value = pObject->Present_Value; } return value; } /** * This function is used to detect a value change, * using the new value compared against the prior * value, using a delta as threshold. * * This method will update the COV-changed attribute. * * @param index Object index * @param value Given present value. */ static void Integer_Value_COV_Detect(struct integer_object *pObject, int32_t value) { if (pObject) { int32_t prior_value = pObject->Prior_Value; uint32_t cov_increment = pObject->COV_Increment; uint32_t cov_delta = (uint32_t)abs(prior_value - value); if (cov_delta >= cov_increment) { pObject->Changed = true; pObject->Prior_Value = value; } } } /** * For a given object instance-number, sets the present-value * * @param object_instance - object-instance number of the object * @param value - integer value * * @return true if values are within range and present-value is set. */ bool Integer_Value_Present_Value_Set( uint32_t object_instance, int32_t value, uint8_t priority) { bool status = false; struct integer_object *pObject = Integer_Value_Object(object_instance); (void)priority; if (pObject) { Integer_Value_COV_Detect(pObject, value); pObject->Present_Value = value; status = true; } return status; } /** * For a given object instance-number, loads the object-name into * a characterstring. Note that the object name must be unique * within this device. * * @param object_instance - object-instance number of the object * @param object_name - holds the object-name retrieved * * @return true if object-name was retrieved */ bool Integer_Value_Object_Name( uint32_t object_instance, BACNET_CHARACTER_STRING *object_name) { char text[32] = ""; bool status = false; struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { if (pObject->Object_Name) { status = characterstring_init_ansi(object_name, pObject->Object_Name); } else { snprintf( text, sizeof(text), "INTEGER-VALUE-%lu", (unsigned long)object_instance); status = characterstring_init_ansi(object_name, text); } } return status; } /** * @brief For a given object instance-number, sets the object-name * @param object_instance - object-instance number of the object * @param new_name - holds the object-name to be set * @return true if object-name was set */ bool Integer_Value_Name_Set(uint32_t object_instance, const char *new_name) { bool status = false; struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { status = true; pObject->Object_Name = new_name; } return status; } /** * @brief Return the object name C string * @param object_instance [in] BACnet object instance number * @return object name or NULL if not found */ const char *Integer_Value_Name_ASCII(uint32_t object_instance) { const char *name = NULL; struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { name = pObject->Object_Name; } return name; } /** * For a given object instance-number, return the description. * * Note: the object name must be unique within this device. * * @param object_instance - object-instance number of the object * @param description - description pointer * * @return true/false */ bool Integer_Value_Description( uint32_t object_instance, BACNET_CHARACTER_STRING *description) { bool status = false; struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { if (pObject->Description) { status = characterstring_init_ansi(description, pObject->Description); } else { status = characterstring_init_ansi(description, ""); } } return status; } /** * @brief For a given object instance-number, sets the description * @param object_instance - object-instance number of the object * @param new_name - holds the description to be set * @return true if object-name was set */ bool Integer_Value_Description_Set( uint32_t object_instance, const char *new_name) { bool status = false; /* return value */ struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { status = true; pObject->Description = new_name; } return status; } /** * @brief For a given object instance-number, returns the description * @param object_instance - object-instance number of the object * @return description text or NULL if not found */ const char *Integer_Value_Description_ANSI(uint32_t object_instance) { const char *name = NULL; struct integer_object *pObject; pObject = Integer_Value_Object(object_instance); if (pObject) { if (pObject->Description == NULL) { name = ""; } else { name = pObject->Description; } } return name; } /** * For a given object instance-number, returns the units property value * * @param object_instance - object-instance number of the object * * @return units property value */ uint16_t Integer_Value_Units(uint32_t object_instance) { uint16_t units = UNITS_NO_UNITS; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { units = pObject->Units; } return units; } /** * For a given object instance-number, sets the units property value * * @param object_instance - object-instance number of the object * @param units - units property value * * @return true if the units property value was set */ bool Integer_Value_Units_Set(uint32_t object_instance, uint16_t units) { bool status = false; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { pObject->Units = units; status = true; } return status; } /** * For a given object instance-number, returns the out-of-service * property value * * @param object_instance - object-instance number of the object * * @return out-of-service property value */ bool Integer_Value_Out_Of_Service(uint32_t object_instance) { struct integer_object *pObject = Integer_Value_Object(object_instance); bool value = false; if (pObject) { value = pObject->Out_Of_Service; } return value; } /** * For a given object instance-number, sets the out-of-service property value * * @param object_instance - object-instance number of the object * @param value - boolean out-of-service value * * @return true if the out-of-service property value was set */ void Integer_Value_Out_Of_Service_Set(uint32_t object_instance, bool value) { struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { pObject->Out_Of_Service = value; } } /** * ReadProperty handler for this object. For the given ReadProperty * data, the application_data is loaded or the error flags are set. * * @param rpdata - BACNET_READ_PROPERTY_DATA data, including * requested data and space for the reply, or error response. * * @return number of APDU bytes in the response, or * BACNET_STATUS_ERROR on error. */ int Integer_Value_Read_Property(BACNET_READ_PROPERTY_DATA *rpdata) { int apdu_len = 0; /* return value */ BACNET_BIT_STRING bit_string; BACNET_CHARACTER_STRING char_string; uint8_t *apdu = NULL; uint32_t units = 0; int32_t integer_value = 0; bool state = false; if ((rpdata == NULL) || (rpdata->application_data == NULL) || (rpdata->application_data_len == 0)) { return 0; } apdu = rpdata->application_data; switch (rpdata->object_property) { case PROP_OBJECT_IDENTIFIER: apdu_len = encode_application_object_id( &apdu[0], Object_Type, rpdata->object_instance); break; case PROP_OBJECT_NAME: Integer_Value_Object_Name(rpdata->object_instance, &char_string); apdu_len = encode_application_character_string(&apdu[0], &char_string); break; case PROP_OBJECT_TYPE: apdu_len = encode_application_enumerated(&apdu[0], Object_Type); break; case PROP_DESCRIPTION: if (Integer_Value_Description( rpdata->object_instance, &char_string)) { apdu_len = encode_application_character_string(&apdu[0], &char_string); } break; case PROP_PRESENT_VALUE: integer_value = Integer_Value_Present_Value(rpdata->object_instance); apdu_len = encode_application_signed(&apdu[0], integer_value); break; case PROP_STATUS_FLAGS: bitstring_init(&bit_string); bitstring_set_bit(&bit_string, STATUS_FLAG_IN_ALARM, false); bitstring_set_bit(&bit_string, STATUS_FLAG_FAULT, false); bitstring_set_bit(&bit_string, STATUS_FLAG_OVERRIDDEN, false); state = Integer_Value_Out_Of_Service(rpdata->object_instance); bitstring_set_bit(&bit_string, STATUS_FLAG_OUT_OF_SERVICE, state); apdu_len = encode_application_bitstring(&apdu[0], &bit_string); break; case PROP_OUT_OF_SERVICE: state = Integer_Value_Out_Of_Service(rpdata->object_instance); apdu_len = encode_application_boolean(&apdu[0], state); break; case PROP_UNITS: units = Integer_Value_Units(rpdata->object_instance); apdu_len = encode_application_enumerated(&apdu[0], units); break; case PROP_COV_INCREMENT: apdu_len = encode_application_unsigned( &apdu[0], Integer_Value_COV_Increment(rpdata->object_instance)); break; default: rpdata->error_class = ERROR_CLASS_PROPERTY; rpdata->error_code = ERROR_CODE_UNKNOWN_PROPERTY; apdu_len = BACNET_STATUS_ERROR; break; } return apdu_len; } /** * WriteProperty handler for this object. For the given WriteProperty * data, the application_data is loaded or the error flags are set. * * @param wp_data - BACNET_WRITE_PROPERTY_DATA data, including * requested data and space for the reply, or error response. * * @return false if an error is loaded, true if no errors */ bool Integer_Value_Write_Property(BACNET_WRITE_PROPERTY_DATA *wp_data) { bool status = false; /* return value */ int len = 0; int32_t old_value = 0; BACNET_APPLICATION_DATA_VALUE value = { 0 }; /* decode the some of the request */ len = bacapp_decode_application_data( wp_data->application_data, wp_data->application_data_len, &value); /* FIXME: len < application_data_len: more data? */ if (len < 0) { /* error while decoding - a value larger than we can handle */ wp_data->error_class = ERROR_CLASS_PROPERTY; wp_data->error_code = ERROR_CODE_VALUE_OUT_OF_RANGE; return false; } switch (wp_data->object_property) { case PROP_PRESENT_VALUE: status = write_property_type_valid( wp_data, &value, BACNET_APPLICATION_TAG_SIGNED_INT); if (status) { old_value = Integer_Value_Present_Value(wp_data->object_instance); Integer_Value_Present_Value_Set( wp_data->object_instance, value.type.Signed_Int, wp_data->priority); if (Integer_Value_Write_Present_Value_Callback) { Integer_Value_Write_Present_Value_Callback( wp_data->object_instance, old_value, Integer_Value_Present_Value(wp_data->object_instance)); } } break; case PROP_COV_INCREMENT: status = write_property_type_valid( wp_data, &value, BACNET_APPLICATION_TAG_UNSIGNED_INT); if (status) { Integer_Value_COV_Increment_Set( wp_data->object_instance, value.type.Unsigned_Int); } break; case PROP_OUT_OF_SERVICE: status = write_property_type_valid( wp_data, &value, BACNET_APPLICATION_TAG_BOOLEAN); if (status) { Integer_Value_Out_Of_Service_Set( wp_data->object_instance, value.type.Boolean); } break; case PROP_UNITS: status = write_property_type_valid( wp_data, &value, BACNET_APPLICATION_TAG_ENUMERATED); if (status) { if (value.type.Enumerated <= UINT16_MAX) { Integer_Value_Units_Set( wp_data->object_instance, value.type.Enumerated); } else { status = false; wp_data->error_class = ERROR_CLASS_PROPERTY; wp_data->error_code = ERROR_CODE_VALUE_OUT_OF_RANGE; } } break; default: if (property_lists_member( Integer_Value_Properties_Required, Integer_Value_Properties_Optional, Integer_Value_Properties_Proprietary, wp_data->object_property)) { wp_data->error_class = ERROR_CLASS_PROPERTY; wp_data->error_code = ERROR_CODE_WRITE_ACCESS_DENIED; } else { wp_data->error_class = ERROR_CLASS_PROPERTY; wp_data->error_code = ERROR_CODE_UNKNOWN_PROPERTY; } break; } return status; } /** * @brief Sets a callback used when present-value is written from BACnet * @param cb - callback used to provide indications */ void Integer_Value_Write_Present_Value_Callback_Set( integer_value_write_present_value_callback cb) { Integer_Value_Write_Present_Value_Callback = cb; } /** * @brief For a given object instance-number, determines the COV status * @param object_instance - object-instance number of the object * @return true if the COV flag is set */ bool Integer_Value_Change_Of_Value(uint32_t object_instance) { bool changed = false; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { changed = pObject->Changed; } return changed; } /** * @brief For a given object instance-number, clears the COV flag * @param object_instance - object-instance number of the object */ void Integer_Value_Change_Of_Value_Clear(uint32_t object_instance) { struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { pObject->Changed = false; } } /** * @brief For a given object instance-number, returns the COV-Increment value * @param object_instance - object-instance number of the object * @return COV-Increment value */ uint32_t Integer_Value_COV_Increment(uint32_t object_instance) { uint32_t value = 0; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { value = pObject->COV_Increment; } return value; } /** * For a given object instance-number, loads the value_list with the COV data. * * @param object_instance - object-instance number of the object * @param value_list - list of COV data * * @return true if the value list is encoded */ bool Integer_Value_Encode_Value_List( uint32_t object_instance, BACNET_PROPERTY_VALUE *value_list) { bool status = false; struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { bool out_of_service = pObject->Out_Of_Service; uint32_t present_value = pObject->Present_Value; const bool in_alarm = false; const bool fault = false; const bool overridden = false; status = cov_value_list_encode_signed_int( value_list, present_value, in_alarm, fault, overridden, out_of_service); } return status; } /** * @brief For a given object instance-number, sets the COV-Increment value * @param object_instance - object-instance number of the object * @param value - COV-Increment value */ void Integer_Value_COV_Increment_Set(uint32_t object_instance, uint32_t value) { struct integer_object *pObject = Integer_Value_Object(object_instance); if (pObject) { pObject->COV_Increment = value; Integer_Value_COV_Detect(pObject, pObject->Present_Value); } } /** * @brief Creates a Integer Value object * @param object_instance - object-instance number of the object * @return the object-instance that was created, or BACNET_MAX_INSTANCE */ uint32_t Integer_Value_Create(uint32_t object_instance) { struct integer_object *pObject = NULL; if (object_instance > BACNET_MAX_INSTANCE) { return BACNET_MAX_INSTANCE; } else if (object_instance == BACNET_MAX_INSTANCE) { /* wildcard instance */ /* the Object_Identifier property of the newly created object shall be initialized to a value that is unique within the responding BACnet-user device. The method used to generate the object identifier is a local matter.*/ object_instance = Keylist_Next_Empty_Key(Object_List, 1); } pObject = Keylist_Data(Object_List, object_instance); if (!pObject) { pObject = calloc(1, sizeof(struct integer_object)); if (pObject) { int index = Keylist_Data_Add(Object_List, object_instance, pObject); if (index < 0) { free(pObject); return BACNET_MAX_INSTANCE; } pObject->Object_Name = NULL; pObject->Description = NULL; pObject->COV_Increment = 1; pObject->Present_Value = 0; pObject->Prior_Value = 0; pObject->Units = UNITS_PERCENT; pObject->Out_Of_Service = false; pObject->Changed = false; /* add to list */ } else { return BACNET_MAX_INSTANCE; } } return object_instance; } /** * @brief Deletes an Integer Value object * @param object_instance - object-instance number of the object * @return true if the object-instance was deleted */ bool Integer_Value_Delete(uint32_t object_instance) { bool status = false; struct integer_object *pObject = Keylist_Data_Delete(Object_List, object_instance); if (pObject) { free(pObject); status = true; } return status; } /** * @brief Deletes all the Integer Values and their data */ void Integer_Value_Cleanup(void) { if (Object_List) { struct integer_object *pObject; do { pObject = Keylist_Data_Pop(Object_List); if (pObject) { free(pObject); } } while (pObject); Keylist_Delete(Object_List); Object_List = NULL; } } /** * Initializes the Integer Value object data */ void Integer_Value_Init(void) { if (!Object_List) { Object_List = Keylist_Create(); } }