mirror of
https://github.com/stargieg/bacnet-stack
synced 2025-10-26 23:35:52 +08:00
219 lines
7.3 KiB
C
219 lines
7.3 KiB
C
/**************************************************************************
|
|
*
|
|
* Copyright (C) 2009 Peter Mc Shane
|
|
*
|
|
* 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.
|
|
*
|
|
*********************************************************************/
|
|
#ifndef TRENDLOG_H
|
|
#define TRENDLOG_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <time.h> /* for time_t */
|
|
#include "bacdef.h"
|
|
#include "cov.h"
|
|
#include "rp.h"
|
|
#include "wp.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/* Error code for Trend Log storage */
|
|
typedef struct tl_error {
|
|
uint16_t usClass;
|
|
uint16_t usCode;
|
|
} TL_ERROR;
|
|
|
|
/* Bit string of up to 32 bits for Trend Log storage */
|
|
|
|
typedef struct tl_bits {
|
|
uint8_t ucLen; /* bytes used in upper nibble/bits free in lower nibble */
|
|
uint8_t ucStore[4];
|
|
} TL_BITS;
|
|
|
|
/* Storage structure for Trend Log data
|
|
*
|
|
* Note. I've tried to minimise the storage requirements here
|
|
* as the memory requirements for logging in embedded
|
|
* implementations are frequently a big issue. For PC or
|
|
* embedded Linux type setupz this may seem like overkill
|
|
* but if you have limited memory and need to squeeze as much
|
|
* logging capacity as possible every little byte counts!
|
|
*/
|
|
|
|
typedef struct tl_data_record {
|
|
time_t tTimeStamp; /* When the event occurred */
|
|
uint8_t ucRecType; /* What type of Event */
|
|
uint8_t ucStatus; /* Optional Status for read value in b0-b2, b7 = 1 if status is used */
|
|
union {
|
|
uint8_t ucLogStatus; /* Change of log state flags */
|
|
uint8_t ucBoolean; /* Stored boolean value */
|
|
float fReal; /* Stored floating point value */
|
|
uint32_t ulEnum; /* Stored enumerated value - max 32 bits */
|
|
uint32_t ulUValue; /* Stored unsigned value - max 32 bits */
|
|
int32_t lSValue; /* Stored signed value - max 32 bits */
|
|
TL_BITS Bits; /* Stored bitstring - max 32 bits */
|
|
TL_ERROR Error; /* Two part error class/code combo */
|
|
float fTime; /* Interval value for change of time - seconds */
|
|
} Datum;
|
|
} TL_DATA_REC;
|
|
|
|
#define TL_T_START_WILD 1 /* Start time is wild carded */
|
|
#define TL_T_STOP_WILD 2 /* Stop Time is wild carded */
|
|
|
|
#define TL_MAX_ENTRIES 1000 /* Entries per datalog */
|
|
#define TL_INIT_ENTRIES 1 /* Entries per datalog */
|
|
|
|
/* Structure containing config and status info for a Trend Log */
|
|
|
|
typedef struct trend_log_descr {
|
|
char Object_Name[64];
|
|
char Object_Description[64];
|
|
bool Disable;
|
|
char Int_type;
|
|
char Int_name;
|
|
bool bEnable; /* Trend log is active when this is true */
|
|
BACNET_DATE_TIME StartTime; /* BACnet format start time */
|
|
time_t tStartTime; /* Local time working copy of start time */
|
|
BACNET_DATE_TIME StopTime; /* BACnet format stop time */
|
|
time_t tStopTime; /* Local time working copy of stop time */
|
|
uint8_t ucTimeFlags; /* Shorthand info on times */
|
|
BACNET_DEVICE_OBJECT_PROPERTY_REFERENCE Source; /* Where the data comes from */
|
|
uint32_t ulLogInterval; /* Time between entries in seconds */
|
|
bool bStopWhenFull; /* Log halts when full if true */
|
|
uint32_t ulRecordCount; /* Count of items currently in the buffer */
|
|
uint32_t ulTotalRecordCount; /* Count of all items that have ever been inserted into the buffer */
|
|
BACNET_LOGGING_TYPE LoggingType; /* Polled/cov/triggered */
|
|
bool bAlignIntervals; /* If true align to the clock */
|
|
uint32_t ulIntervalOffset; /* Offset from start of period for taking reading in seconds */
|
|
bool bTrigger; /* Set to 1 to cause a reading to be taken */
|
|
int iIndex; /* Current insertion point */
|
|
time_t tLastDataTime;
|
|
} TREND_LOG_DESCR;
|
|
|
|
/*
|
|
* Data types associated with a BACnet Log Record. We use these for managing the
|
|
* log buffer but they are also the tag numbers to use when encoding/decoding
|
|
* the log datum field.
|
|
*/
|
|
|
|
#define TL_TYPE_STATUS 0
|
|
#define TL_TYPE_BOOL 1
|
|
#define TL_TYPE_REAL 2
|
|
#define TL_TYPE_ENUM 3
|
|
#define TL_TYPE_UNSIGN 4
|
|
#define TL_TYPE_SIGN 5
|
|
#define TL_TYPE_BITS 6
|
|
#define TL_TYPE_NULL 7
|
|
#define TL_TYPE_ERROR 8
|
|
#define TL_TYPE_DELTA 9
|
|
#define TL_TYPE_ANY 10 /* We don't support this particular can of worms! */
|
|
|
|
|
|
void Trend_Log_Property_Lists(
|
|
const int **pRequired,
|
|
const int **pOptional,
|
|
const int **pProprietary);
|
|
|
|
bool Trend_Log_Valid_Instance(
|
|
uint32_t object_instance);
|
|
|
|
unsigned Trend_Log_Count(
|
|
void);
|
|
|
|
uint32_t Trend_Log_Index_To_Instance(
|
|
unsigned index);
|
|
|
|
unsigned Trend_Log_Instance_To_Index(
|
|
uint32_t instance);
|
|
|
|
bool Trend_Log_Object_Instance_Add(
|
|
uint32_t instance);
|
|
|
|
bool Trend_Log_Object_Name(
|
|
uint32_t object_instance,
|
|
BACNET_CHARACTER_STRING * object_name);
|
|
|
|
int Trend_Log_Read_Property(
|
|
BACNET_READ_PROPERTY_DATA * rpdata);
|
|
|
|
bool Trend_Log_Description_Set(
|
|
uint32_t object_instance,
|
|
char *text_string);
|
|
|
|
bool Trend_Log_Write_Property(
|
|
BACNET_WRITE_PROPERTY_DATA * wp_data);
|
|
|
|
void Trend_Log_Init(
|
|
void);
|
|
|
|
void TL_Insert_Status_Rec(
|
|
int iLog,
|
|
BACNET_LOG_STATUS eStatus,
|
|
bool bState);
|
|
|
|
bool TL_Is_Enabled(
|
|
int iLog);
|
|
|
|
time_t TL_BAC_Time_To_Local(
|
|
BACNET_DATE_TIME * SourceTime);
|
|
|
|
void TL_Local_Time_To_BAC(
|
|
BACNET_DATE_TIME * DestTime,
|
|
time_t SourceTime);
|
|
|
|
int TL_encode_entry(
|
|
uint8_t * apdu,
|
|
int iLog,
|
|
int iEntry);
|
|
|
|
int TL_encode_by_position(
|
|
uint8_t * apdu,
|
|
BACNET_READ_RANGE_DATA * pRequest);
|
|
|
|
int TL_encode_by_sequence(
|
|
uint8_t * apdu,
|
|
BACNET_READ_RANGE_DATA * pRequest);
|
|
|
|
int TL_encode_by_time(
|
|
uint8_t * apdu,
|
|
BACNET_READ_RANGE_DATA * pRequest);
|
|
|
|
bool TrendLogGetRRInfo(
|
|
BACNET_READ_RANGE_DATA * pRequest, /* Info on the request */
|
|
RR_PROP_INFO * pInfo); /* Where to put the information */
|
|
|
|
int rr_trend_log_encode(
|
|
uint8_t * apdu,
|
|
BACNET_READ_RANGE_DATA * pRequest);
|
|
|
|
void TL_fetch_property(
|
|
int i);
|
|
|
|
void trend_log_timer(
|
|
uint16_t uSeconds);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif
|