mirror of
https://github.com/stargieg/bacnet-stack
synced 2025-10-26 23:35:52 +08:00
499 lines
18 KiB
C
499 lines
18 KiB
C
/*************************************************************************
|
|
* Copyright (C) 2008 Steve Karg <skarg@users.sourceforge.net>
|
|
*
|
|
* 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.
|
|
*
|
|
*********************************************************************/
|
|
|
|
/* command line tool that sends a BACnet service, and displays the reply */
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <errno.h>
|
|
#include <time.h> /* for time */
|
|
|
|
#define PRINT_ENABLED 1
|
|
|
|
#include "bacdef.h"
|
|
#include "config.h"
|
|
#include "bactext.h"
|
|
#include "bacerror.h"
|
|
#include "iam.h"
|
|
#include "arf.h"
|
|
#include "tsm.h"
|
|
#include "address.h"
|
|
#include "npdu.h"
|
|
#include "apdu.h"
|
|
#include "device.h"
|
|
#include "net.h"
|
|
#include "datalink.h"
|
|
#include "whois.h"
|
|
#include "version.h"
|
|
/* some demo stuff needed */
|
|
#include "rpm.h"
|
|
#include "filename.h"
|
|
#include "handlers.h"
|
|
#include "client.h"
|
|
#include "txbuf.h"
|
|
#include "dlenv.h"
|
|
|
|
/* buffer used for receive */
|
|
static uint8_t Rx_Buf[MAX_MPDU] = { 0 };
|
|
|
|
/* global variables used in this file */
|
|
static uint32_t Target_Device_Object_Instance = BACNET_MAX_INSTANCE;
|
|
static BACNET_READ_ACCESS_DATA *Read_Access_Data;
|
|
/* needed to filter incoming messages */
|
|
static uint8_t Request_Invoke_ID = 0;
|
|
static BACNET_ADDRESS Target_Address;
|
|
/* needed for return value of main application */
|
|
static bool Error_Detected = false;
|
|
|
|
static void MyErrorHandler(
|
|
BACNET_ADDRESS * src,
|
|
uint8_t invoke_id,
|
|
BACNET_ERROR_CLASS error_class,
|
|
BACNET_ERROR_CODE error_code)
|
|
{
|
|
if (address_match(&Target_Address, src) &&
|
|
(invoke_id == Request_Invoke_ID)) {
|
|
printf("BACnet Error: %s: %s\n",
|
|
bactext_error_class_name((int) error_class),
|
|
bactext_error_code_name((int) error_code));
|
|
Error_Detected = true;
|
|
}
|
|
}
|
|
|
|
void MyAbortHandler(
|
|
BACNET_ADDRESS * src,
|
|
uint8_t invoke_id,
|
|
uint8_t abort_reason,
|
|
bool server)
|
|
{
|
|
(void) server;
|
|
if (address_match(&Target_Address, src) &&
|
|
(invoke_id == Request_Invoke_ID)) {
|
|
printf("BACnet Abort: %s\n",
|
|
bactext_abort_reason_name((int) abort_reason));
|
|
Error_Detected = true;
|
|
}
|
|
}
|
|
|
|
void MyRejectHandler(
|
|
BACNET_ADDRESS * src,
|
|
uint8_t invoke_id,
|
|
uint8_t reject_reason)
|
|
{
|
|
/* FIXME: verify src and invoke id */
|
|
if (address_match(&Target_Address, src) &&
|
|
(invoke_id == Request_Invoke_ID)) {
|
|
printf("BACnet Reject: %s\n",
|
|
bactext_reject_reason_name((int) reject_reason));
|
|
Error_Detected = true;
|
|
}
|
|
}
|
|
|
|
/** Handler for a ReadPropertyMultiple ACK.
|
|
* @ingroup DSRPM
|
|
* For each read property, print out the ACK'd data,
|
|
* and free the request data items from linked property list.
|
|
*
|
|
* @param service_request [in] The contents of the service request.
|
|
* @param service_len [in] The length of the service_request.
|
|
* @param src [in] BACNET_ADDRESS of the source of the message
|
|
* @param service_data [in] The BACNET_CONFIRMED_SERVICE_DATA information
|
|
* decoded from the APDU header of this message.
|
|
*/
|
|
void My_Read_Property_Multiple_Ack_Handler(
|
|
uint8_t * service_request,
|
|
uint16_t service_len,
|
|
BACNET_ADDRESS * src,
|
|
BACNET_CONFIRMED_SERVICE_ACK_DATA * service_data)
|
|
{
|
|
int len = 0;
|
|
BACNET_READ_ACCESS_DATA *rpm_data;
|
|
BACNET_READ_ACCESS_DATA *old_rpm_data;
|
|
BACNET_PROPERTY_REFERENCE *rpm_property;
|
|
BACNET_PROPERTY_REFERENCE *old_rpm_property;
|
|
BACNET_APPLICATION_DATA_VALUE *value;
|
|
BACNET_APPLICATION_DATA_VALUE *old_value;
|
|
|
|
if (address_match(&Target_Address, src) &&
|
|
(service_data->invoke_id == Request_Invoke_ID)) {
|
|
rpm_data = calloc(1, sizeof(BACNET_READ_ACCESS_DATA));
|
|
if (rpm_data) {
|
|
len =
|
|
rpm_ack_decode_service_request(service_request, service_len,
|
|
rpm_data);
|
|
}
|
|
if (len > 0) {
|
|
while (rpm_data) {
|
|
rpm_ack_print_data(rpm_data);
|
|
rpm_property = rpm_data->listOfProperties;
|
|
while (rpm_property) {
|
|
value = rpm_property->value;
|
|
while (value) {
|
|
old_value = value;
|
|
value = value->next;
|
|
free(old_value);
|
|
}
|
|
old_rpm_property = rpm_property;
|
|
rpm_property = rpm_property->next;
|
|
free(old_rpm_property);
|
|
}
|
|
old_rpm_data = rpm_data;
|
|
rpm_data = rpm_data->next;
|
|
free(old_rpm_data);
|
|
}
|
|
} else {
|
|
fprintf(stderr, "RPM Ack Malformed! Freeing memory...\n");
|
|
while (rpm_data) {
|
|
rpm_property = rpm_data->listOfProperties;
|
|
while (rpm_property) {
|
|
value = rpm_property->value;
|
|
while (value) {
|
|
old_value = value;
|
|
value = value->next;
|
|
free(old_value);
|
|
}
|
|
old_rpm_property = rpm_property;
|
|
rpm_property = rpm_property->next;
|
|
free(old_rpm_property);
|
|
}
|
|
old_rpm_data = rpm_data;
|
|
rpm_data = rpm_data->next;
|
|
free(old_rpm_data);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void Init_Service_Handlers(
|
|
void)
|
|
{
|
|
Device_Init(NULL);
|
|
/* we need to handle who-is
|
|
to support dynamic device binding to us */
|
|
apdu_set_unconfirmed_handler(SERVICE_UNCONFIRMED_WHO_IS, handler_who_is);
|
|
/* handle i-am to support binding to other devices */
|
|
apdu_set_unconfirmed_handler(SERVICE_UNCONFIRMED_I_AM, handler_i_am_bind);
|
|
/* set the handler for all the services we don't implement
|
|
It is required to send the proper reject message... */
|
|
apdu_set_unrecognized_service_handler_handler
|
|
(handler_unrecognized_service);
|
|
/* we must implement read property - it's required! */
|
|
apdu_set_confirmed_handler(SERVICE_CONFIRMED_READ_PROPERTY,
|
|
handler_read_property);
|
|
/* handle the data coming back from confirmed requests */
|
|
apdu_set_confirmed_ack_handler(SERVICE_CONFIRMED_READ_PROP_MULTIPLE,
|
|
My_Read_Property_Multiple_Ack_Handler);
|
|
/* handle any errors coming back */
|
|
apdu_set_error_handler(SERVICE_CONFIRMED_READ_PROPERTY, MyErrorHandler);
|
|
apdu_set_abort_handler(MyAbortHandler);
|
|
apdu_set_reject_handler(MyRejectHandler);
|
|
}
|
|
|
|
void cleanup(
|
|
void)
|
|
{
|
|
BACNET_READ_ACCESS_DATA *rpm_object;
|
|
BACNET_READ_ACCESS_DATA *old_rpm_object;
|
|
BACNET_PROPERTY_REFERENCE *rpm_property;
|
|
BACNET_PROPERTY_REFERENCE *old_rpm_property;
|
|
|
|
rpm_object = Read_Access_Data;
|
|
old_rpm_object = rpm_object;
|
|
while (rpm_object) {
|
|
rpm_property = rpm_object->listOfProperties;
|
|
while (rpm_property) {
|
|
old_rpm_property = rpm_property;
|
|
rpm_property = rpm_property->next;
|
|
free(old_rpm_property);
|
|
}
|
|
old_rpm_object = rpm_object;
|
|
rpm_object = rpm_object->next;
|
|
free(old_rpm_object);
|
|
}
|
|
}
|
|
|
|
static void print_usage(char *filename)
|
|
{
|
|
printf("Usage: %s device-instance object-type object-instance "
|
|
"property[index][,property[index]] [object-type ...]\n",
|
|
filename);
|
|
printf(" [--version][--help]\n");
|
|
}
|
|
|
|
static void print_help(char *filename)
|
|
{
|
|
printf("Read one or more properties from one or more objects\n"
|
|
"in a BACnet device and print the value(s).\n"
|
|
"device-instance:\n"
|
|
"BACnet Device Object Instance number that you are\n"
|
|
"trying to communicate to. This number will be used\n"
|
|
"to try and bind with the device using Who-Is and\n"
|
|
"I-Am services. For example, if you were reading\n"
|
|
"Device Object 123, the device-instance would be 123.\n"
|
|
"\nobject-type:\n"
|
|
"The object type is the integer value of the enumeration\n"
|
|
"BACNET_OBJECT_TYPE in bacenum.h. It is the object\n"
|
|
"that you are reading. For example if you were\n"
|
|
"reading Analog Output 2, the object-type would be 1.\n"
|
|
"\nobject-instance:\n"
|
|
"This is the object instance number of the object that\n"
|
|
"you are reading. For example, if you were reading\n"
|
|
"Analog Output 2, the object-instance would be 2.\n"
|
|
"\nproperty:\n"
|
|
"The property is an integer value of the enumeration\n"
|
|
"BACNET_PROPERTY_ID in bacenum.h. It is the property\n"
|
|
"you are reading. For example, if you were reading the\n"
|
|
"Present Value property, use 85 as the property.\n"
|
|
"\n[index]:\n"
|
|
"This optional integer parameter is the index number of \n"
|
|
"an array property. Individual elements of an array can\n"
|
|
"be read. If this parameter is missing and the property\n"
|
|
"is an array, the entire array will be read.\n"
|
|
"\nExample:\n"
|
|
"If you want read the PRESENT_VALUE property and various\n"
|
|
"array elements of the PRIORITY_ARRAY in Device 123\n"
|
|
"Analog Output object 99, use the following command:\n"
|
|
"%s 123 1 99 85,87[0],87\n"
|
|
"If you want read the PRESENT_VALUE property in objects\n"
|
|
"Analog Input 77 and Analog Input 78 in Device 123\n"
|
|
"use the following command:\n" "%s 123 0 77 85 0 78 85\n"
|
|
"If you want read the ALL property in\n"
|
|
"Device object 123, you would use the following command:\n"
|
|
"%s 123 8 123 8\n"
|
|
"If you want read the OPTIONAL property in\n"
|
|
"Device object 123, you would use the following command:\n"
|
|
"%s 123 8 123 80\n"
|
|
"If you want read the REQUIRED property in\n"
|
|
"Device object 123, you would use the following command:\n"
|
|
"%s 123 8 123 105\n", filename, filename, filename, filename,
|
|
filename);
|
|
}
|
|
|
|
int main(
|
|
int argc,
|
|
char *argv[])
|
|
{
|
|
BACNET_ADDRESS src = {
|
|
0
|
|
}; /* address where message came from */
|
|
uint16_t pdu_len = 0;
|
|
unsigned timeout = 100; /* milliseconds */
|
|
unsigned max_apdu = 0;
|
|
int args_remaining = 0, tag_value_arg = 0, arg_sets = 0;
|
|
time_t elapsed_seconds = 0;
|
|
time_t last_seconds = 0;
|
|
time_t current_seconds = 0;
|
|
time_t timeout_seconds = 0;
|
|
bool found = false;
|
|
uint8_t buffer[MAX_PDU] = {
|
|
0
|
|
};
|
|
BACNET_READ_ACCESS_DATA *rpm_object;
|
|
BACNET_PROPERTY_REFERENCE *rpm_property;
|
|
char *property_token = NULL;
|
|
unsigned property_id = 0;
|
|
unsigned property_array_index = 0;
|
|
int scan_count = 0;
|
|
int argi = 0;
|
|
char *filename = NULL;
|
|
|
|
filename = filename_remove_path(argv[0]);
|
|
for (argi = 1; argi < argc; argi++) {
|
|
if (strcmp(argv[argi], "--help") == 0) {
|
|
print_usage(filename);
|
|
print_help(filename);
|
|
return 0;
|
|
}
|
|
if (strcmp(argv[argi], "--version") == 0) {
|
|
printf("%s %s\n", filename, BACNET_VERSION_TEXT);
|
|
printf("Copyright (C) 2014 by Steve Karg and others.\n"
|
|
"This is free software; see the source for copying conditions.\n"
|
|
"There is NO warranty; not even for MERCHANTABILITY or\n"
|
|
"FITNESS FOR A PARTICULAR PURPOSE.\n");
|
|
return 0;
|
|
}
|
|
}
|
|
if (argc < 5) {
|
|
print_usage(filename);
|
|
return 0;
|
|
}
|
|
/* decode the command line parameters */
|
|
Target_Device_Object_Instance = strtol(argv[1], NULL, 0);
|
|
if (Target_Device_Object_Instance >= BACNET_MAX_INSTANCE) {
|
|
fprintf(stderr, "device-instance=%u - it must be less than %u\n",
|
|
Target_Device_Object_Instance, BACNET_MAX_INSTANCE);
|
|
return 1;
|
|
}
|
|
atexit(cleanup);
|
|
Read_Access_Data = calloc(1, sizeof(BACNET_READ_ACCESS_DATA));
|
|
rpm_object = Read_Access_Data;
|
|
args_remaining = (argc - 2);
|
|
arg_sets = 0;
|
|
while (rpm_object) {
|
|
tag_value_arg = 2 + (arg_sets * 3);
|
|
rpm_object->object_type = strtol(argv[tag_value_arg], NULL, 0);
|
|
tag_value_arg++;
|
|
args_remaining--;
|
|
if (args_remaining <= 0) {
|
|
fprintf(stderr, "Error: not enough object property triples.\n");
|
|
return 1;
|
|
}
|
|
if (rpm_object->object_type >= MAX_BACNET_OBJECT_TYPE) {
|
|
fprintf(stderr, "object-type=%u - it must be less than %u\n",
|
|
rpm_object->object_type, MAX_BACNET_OBJECT_TYPE);
|
|
return 1;
|
|
}
|
|
rpm_object->object_instance = strtol(argv[tag_value_arg], NULL, 0);
|
|
tag_value_arg++;
|
|
args_remaining--;
|
|
if (args_remaining <= 0) {
|
|
fprintf(stderr, "Error: not enough object property triples.\n");
|
|
return 1;
|
|
}
|
|
if (rpm_object->object_instance > BACNET_MAX_INSTANCE) {
|
|
fprintf(stderr, "object-instance=%u - it must be less than %u\n",
|
|
rpm_object->object_instance, BACNET_MAX_INSTANCE + 1);
|
|
return 1;
|
|
}
|
|
rpm_property = calloc(1, sizeof(BACNET_PROPERTY_REFERENCE));
|
|
rpm_object->listOfProperties = rpm_property;
|
|
property_token = strtok(argv[tag_value_arg], ",");
|
|
/* add all the properties and optional index to our list */
|
|
while (rpm_property) {
|
|
scan_count =
|
|
sscanf(property_token, "%u[%u]", &property_id,
|
|
&property_array_index);
|
|
if (scan_count > 0) {
|
|
rpm_property->propertyIdentifier = property_id;
|
|
if (rpm_property->propertyIdentifier > MAX_BACNET_PROPERTY_ID) {
|
|
fprintf(stderr,
|
|
"property=%u - it must be less than %u\n",
|
|
rpm_property->propertyIdentifier,
|
|
MAX_BACNET_PROPERTY_ID + 1);
|
|
return 1;
|
|
}
|
|
}
|
|
if (scan_count > 1) {
|
|
rpm_property->propertyArrayIndex = property_array_index;
|
|
} else {
|
|
rpm_property->propertyArrayIndex = BACNET_ARRAY_ALL;
|
|
}
|
|
/* is there another property? */
|
|
property_token = strtok(NULL, ",");
|
|
if (property_token) {
|
|
rpm_property->next =
|
|
calloc(1, sizeof(BACNET_PROPERTY_REFERENCE));
|
|
rpm_property = rpm_property->next;
|
|
} else {
|
|
rpm_property->next = NULL;
|
|
break;
|
|
}
|
|
}
|
|
/* used up another arg */
|
|
tag_value_arg++;
|
|
args_remaining--;
|
|
if (args_remaining) {
|
|
arg_sets++;
|
|
rpm_object->next = calloc(1, sizeof(BACNET_READ_ACCESS_DATA));
|
|
rpm_object = rpm_object->next;
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
/* setup my info */
|
|
Device_Set_Object_Instance_Number(BACNET_MAX_INSTANCE);
|
|
address_init();
|
|
Init_Service_Handlers();
|
|
dlenv_init();
|
|
atexit(datalink_cleanup);
|
|
/* configure the timeout values */
|
|
last_seconds = time(NULL);
|
|
timeout_seconds = (apdu_timeout() / 1000) * apdu_retries();
|
|
/* try to bind with the device */
|
|
found =
|
|
address_bind_request(Target_Device_Object_Instance, &max_apdu,
|
|
&Target_Address);
|
|
if (!found) {
|
|
Send_WhoIs(Target_Device_Object_Instance,
|
|
Target_Device_Object_Instance);
|
|
}
|
|
/* loop forever */
|
|
for (;;) {
|
|
/* increment timer - exit if timed out */
|
|
current_seconds = time(NULL);
|
|
|
|
/* at least one second has passed */
|
|
if (current_seconds != last_seconds)
|
|
tsm_timer_milliseconds(((current_seconds - last_seconds) * 1000));
|
|
if (Error_Detected)
|
|
break;
|
|
/* wait until the device is bound, or timeout and quit */
|
|
if (!found) {
|
|
found =
|
|
address_bind_request(Target_Device_Object_Instance, &max_apdu,
|
|
&Target_Address);
|
|
}
|
|
if (found) {
|
|
if (Request_Invoke_ID == 0) {
|
|
Request_Invoke_ID =
|
|
Send_Read_Property_Multiple_Request(&buffer[0],
|
|
sizeof(buffer), Target_Device_Object_Instance,
|
|
Read_Access_Data);
|
|
} else if (tsm_invoke_id_free(Request_Invoke_ID))
|
|
break;
|
|
else if (tsm_invoke_id_failed(Request_Invoke_ID)) {
|
|
fprintf(stderr, "\rError: TSM Timeout!\n");
|
|
tsm_free_invoke_id(Request_Invoke_ID);
|
|
Error_Detected = true;
|
|
/* try again or abort? */
|
|
break;
|
|
}
|
|
} else {
|
|
/* increment timer - exit if timed out */
|
|
elapsed_seconds += (current_seconds - last_seconds);
|
|
if (elapsed_seconds > timeout_seconds) {
|
|
printf("\rError: APDU Timeout!\n");
|
|
Error_Detected = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* returns 0 bytes on timeout */
|
|
pdu_len = datalink_receive(&src, &Rx_Buf[0], MAX_MPDU, timeout);
|
|
|
|
/* process */
|
|
if (pdu_len) {
|
|
npdu_handler(&src, &Rx_Buf[0], pdu_len);
|
|
}
|
|
|
|
/* keep track of time for next check */
|
|
last_seconds = current_seconds;
|
|
}
|
|
|
|
if (Error_Detected)
|
|
return 1;
|
|
return 0;
|
|
}
|