* Changed header file include guards to unique namespace. Updated file headers comments with SPDX [issue #55] (#666)

.mailmap

@@ -5,7 +5,7 @@ root <root@users.sourceforge.net> <root@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 Steve Karg <skarg@users.sourceforge.net> <skarg@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 Tom Brennan <tbrennan3@users.sourceforge.net> <tbrennan3@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 John Minack <minack@users.sourceforge.net> <minack@1e814d3a-8a88-4260-be86-c0dc25669c1e>
-Peter McShane <petermcs@users.sourceforge.net> <petermcs@1e814d3a-8a88-4260-be86-c0dc25669c1e>
+Peter Mc Shane <petermcs@users.sourceforge.net> <petermcs@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 Edward Hague <bitstest@users.sourceforge.net> <ekh@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 Edward Hague <bitstest@users.sourceforge.net> <bitstest@1e814d3a-8a88-4260-be86-c0dc25669c1e>
 Tom Pacheco <netp@users.sourceforge.net> <netp@1e814d3a-8a88-4260-be86-c0dc25669c1e>

apps/abort/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2016 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service Abort message 
- *
+ * to the network
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2016
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/ack-alarm/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2021 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service to the network:
- *
+ *  Ack-Alarm message
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2021
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/blinkt/device.c

@@ -1,31 +1,12 @@
-/**************************************************************************
+/** 
- *
+ * @file 
- * Copyright (C) 2005,2006,2009 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Base "class" for handling all BACnet objects belonging
- *
+ * to a BACnet device, as well as Device-specific properties.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2005,2006,2009
- * "Software"), to deal in the Software without restriction, including
+ * @date 2021
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
-
-/** @file device.c Base "class" for handling all BACnet objects belonging
- *                 to a BACnet device, as well as Device-specific properties. */
-
 #include <stdbool.h>
 #include <stdint.h>
 #include <string.h>

apps/blinkt/main.c

@@ -1,27 +1,11 @@
-/**************************************************************************
+/** 
- *
+ * @file 
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Example application using the BACnet Stack on a Raspberry Pi 
- *
+ * with Blinkt! LEDs.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2023
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -61,8 +45,6 @@
 #include "bacport.h"
 #include "blinkt.h"
 
-/** @file blinkt/main.c  Example application using the BACnet Stack. */
-
 /* (Doxygen note: The next two lines pull all the following Javadoc
  *  into the ServerDemo module.) */
 /** @addtogroup ServerDemo */

apps/dcc/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service to the network:
- *
+ *  DeviceCommunicationControl message
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2006
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 demo for BACnet stack */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/epics/bacepics.h

@@ -1,33 +1,14 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool to generate EPICS-usable output acquired from
-*
+ * a BACnet device on the network.
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @author Tom Brennan <tbrennan3@users.sourceforge.net>
-* "Software"), to deal in the Software without restriction, including
+ * @date 2006
-* without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
-* distribute, sublicense, and/or sell copies of the Software, and to
+ */
-* permit persons to whom the Software is furnished to do so, subject to
+#ifndef BACNET_BACEPICS_H_
-* the following conditions:
+#define BACNET_BACEPICS_H_
-*
-* 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 BACEPICS_H_
-#define BACEPICS_H_
-
-/** @file epics/bacepics.h  Header for tool to generate EPICS-usable output. */
-
 
 /** @defgroup BACEPICS Tool to generate EPICS-usable output.
  * @ingroup Demos

apps/epics/main.c

@@ -1,31 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool to generate EPICS-usable output acquired from
- *
+ * a BACnet device on the network.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2006
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
-
-/** @file epics/main.c  Command line tool to build a full VTS3 EPICS file,
- *                          including the heading information. */
-
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/error/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2016 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service to the network:
- *
+ * BACnet Error message 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2016
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/event/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2021 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service to the network:
- *
+ * BACnet EventNotification message
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2021
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/fuzz-afl/main.c

@@ -1,32 +1,9 @@
 /**
  * @file
- * @author Steve Karg, Anthony Delorenzo
+ * @brief command line fuzz (data scrambling) interface for security testing
- * @date 2020
+ * @author Anthony Delorenzo <anthony@crystalpeaksecurity.com>
- * @brief
+ * @date 2023
- *
+ * @copyright SPDX-License-Identifier: MIT
- * @section LICENSE
- *
- * Copyright (C) 2020 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.
- *
  */
 #include <stddef.h>
 #include <stdint.h>

apps/fuzz-libfuzzer/main.c

@@ -1,32 +1,9 @@
 /**
  * @file
- * @author Steve Karg, Anthony Delorenzo
+ * @brief command line fuzz (data scrambling) interface for security testing
- * @date 2020
+ * @author Anthony Delorenzo <anthony@crystalpeaksecurity.com>
- * @brief
+ * @date 2023
- *
+ * @copyright SPDX-License-Identifier: MIT
- * @section LICENSE
- *
- * Copyright (C) 2020 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.
- *
  */
 #include <stddef.h>
 #include <stdint.h>

apps/gateway/gateway.h

@@ -1,33 +1,13 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Header for example gateway (ie, BACnet Router and Devices) 
-*
+ * using the BACnet Stack.
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Tom Brennan <tbrennan3@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2010
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* without limitation the rights to use, copy, modify, merge, publish,
+ */
-* distribute, sublicense, and/or sell copies of the Software, and to
+#ifndef BACNET_GATEWAY_H_
-* permit persons to whom the Software is furnished to do so, subject to
+#define BACNET_GATEWAY_H_
-* 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 GATEWAY_H_
-#define GATEWAY_H_
-
-/** @file gateway/gateway.h  Header for example gateway (ie, BACnet Router 
- *        and Devices) using the BACnet Stack. */
 
 /** @defgroup GatewayDemo Demo of a BACnet virtual gateway (multiple Device).
  * @ingroup Demos
@@ -43,6 +23,4 @@
 #define DEV_DESCR_GATEWAY "Gateway Device and Router"
 #define DEV_DESCR_REMOTE  "Routed Remote Device"
 
-
+#endif
-
-#endif /* GATEWAY_H_ */

apps/gateway/main.c

@@ -1,32 +1,12 @@
-/**************************************************************************
- *
- * Copyright (C) 2006 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.
- *
- *********************************************************************/
 /**
+ * @file
+ * @brief Example virtual gateway application using the BACnet Stack.
  * Code for this project began with code from the demo/server project and
  * Paul Chapman's vmac project.
+ * @author Tom Brennan <tbrennan3@users.sourceforge.net>
+ * @date 2010
+ * @copyright SPDX-License-Identifier: MIT
  */
-
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -60,9 +40,6 @@
 /* me! */
 #include "gateway.h"
 
-/** @file gateway/main.c  Example virtual gateway application using the BACnet
- * Stack. */
-
 /* Prototypes */
 
 /* (Doxygen note: The next two lines pull all the following Javadoc

apps/getevent/main.c

@@ -1,28 +1,12 @@
-/*************************************************************************
+/**
- * Copyright (C) 2015 B Weitsch
+ * @file
- *
+ * @brief command line tool that sends a BACnet service to the network -
- * Permission is hereby granted, free of charge, to any person obtaining
+ * GetEventInformation message - and displays the reply.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @author Boris Weitsch <bow2@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2015
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/iam/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2016 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet service to the network:
- *
+ * I-Am message
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2016
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/iamrouter/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2008 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet I-Am-Router-To-Network message 
- *
+ * for one or more networks.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2008
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/initrouter/main.c

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2008 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet Initialize-Routing-Table 
- *
+ * message to a network and waits for responses.  Displays their network 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * information from the response.  This is a router-to-router message.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2008
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/piface/device.c

@@ -1,31 +1,12 @@
-/**************************************************************************
+/** 
- *
+ * @file 
- * Copyright (C) 2005,2006,2009 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Base "class" for handling all BACnet objects belonging
- *
+ * to a BACnet device, as well as Device-specific properties.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2005,2006,2009
- * "Software"), to deal in the Software without restriction, including
+ * @date 2021
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
-
-/** @file device.c Base "class" for handling all BACnet objects belonging
- *                 to a BACnet device, as well as Device-specific properties. */
-
 #include <stdbool.h>
 #include <stdint.h>
 #include <string.h>

apps/ptransfer/h_pt.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2005 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Handler for a BACnet ConfirmedPrivateTransfer-Request example
- *
+ * @author Peter Mc Shane <petermcs@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2005
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -38,8 +21,6 @@
 #include "bacnet/basic/services.h"
 #include "bacnet/basic/tsm/tsm.h"
 
-/** @file h_pt.c  Handles Confirmed Private Transfer requests. */
-
 #define MYMAXSTR 32
 #define MYMAXBLOCK 8
 

apps/ptransfer/h_pt_a.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2005 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Handler for a BACnet ConfirmedPrivateTransfer Acknowledgment example
- *
+ * @author Peter Mc Shane <petermcs@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2005
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -38,8 +21,6 @@
 #include "bacnet/basic/services.h"
 #include "bacnet/basic/tsm/tsm.h"
 
-/** @file h_pt_a.c  Handles Confirmed Private Transfer Acknowledgment. */
-
 extern uint8_t IOBufferPT[300]; /* Somewhere to build the encoded result block
                                    for Private Transfers */
 

apps/ptransfer/main.c

@@ -1,28 +1,11 @@
-/*************************************************************************
+/**
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line application for a BACnet ConfirmedPrivateTransfer
- * Permission is hereby granted, free of charge, to any person obtaining
+ * service.  This application is a test program for the BACnet stack.
- * a copy of this software and associated documentation files (the
+ * @author Peter Mc Shane <petermcs@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2005
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/ptransfer/s_ptransfer.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief Sends a BACnet service to the network: PrivateTransfer-Request
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2006
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stdlib.h>
 #include <stddef.h>
 #include <stdint.h>
@@ -42,8 +25,6 @@
 #include "bacnet/datalink/datalink.h"
 #include "bacnet/basic/services.h"
 
-/** @file s_ptransfer.c  Send a Private Transfer request. */
-
 uint8_t Send_Private_Transfer_Request(uint32_t device_id,
     uint16_t vendor_id,
     uint32_t service_number,

apps/readbdt/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet BVLC message, and displays 
- *
+ * the reply, for a Read-Broadcast-Distribution-Table message to a peer BBMD.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2012
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 BVLC message, and displays the reply */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/readfdt/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet BVLC message, and displays 
- *
+ * the reply, for a Read-Foreign-Device-Table message to a peer BBMD.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2012
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 BVLC message, and displays the reply */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/readfile/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that uses BACnet AtomicReadFile service messages
- *
+ * to read a file object contents from another device, and save it locally.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2006
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/readprop/main.c

@@ -1,28 +1,12 @@
-/*************************************************************************
+/**
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that uses BACnet ReadProperty service message
- * Permission is hereby granted, free of charge, to any person obtaining
+ * to read object property value from another device on the network
- * a copy of this software and associated documentation files (the
+ * and prints the value to the console.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2006
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/readpropm/main.c

@@ -1,28 +1,12 @@
-/*************************************************************************
+/**
- * Copyright (C) 2008 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that uses BACnet ReadPropertyMultiple service 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * message to read object property values from another device on 
- * a copy of this software and associated documentation files (the
+ * the network and prints the values to the console.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2008
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/readrange/main.c

@@ -1,30 +1,13 @@
-/*************************************************************************
+/**
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that uses BACnet ReadRange service 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * message to read device object BACnetList or BACnetARRAY property values 
- * a copy of this software and associated documentation files (the
+ * from another device on the network and prints the values to the console.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2006
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
-
 #define PRINT_ENABLED 1
-
-/* command line tool that sends a BACnet service, and displays the reply */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/reinit/main.c

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that uses BACnet ReinitializeDevice service
- *
+ * message to reinitialize another device on the network and prints an
- * Permission is hereby granted, free of charge, to any person obtaining
+ * acknowledgment or error response of this confirmed service request.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2006
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/router-ipv6/main.c

@@ -1,32 +1,9 @@
 /**
  * @file
- * @author Steve Karg
+ * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2016
  * @brief Simple BACnet/IP to BACnet/IPv6 router
- *
+ * @copyright SPDX-License-Identifier: MIT
- * @section LICENSE
- *
- * Copyright (C) 2016 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.
- *
  */
 #include <stddef.h>
 #include <stdint.h>

apps/router-mstp/main.c

@@ -3,30 +3,7 @@
  * @author Steve Karg
  * @date 2020
  * @brief Simple BACnet/IP to MS/TP router
- *
+ * @copyright SPDX-License-Identifier: MIT
- * @section LICENSE
- *
- * Copyright (C) 2020 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.
- *
  */
 #include <stddef.h>
 #include <stdint.h>

apps/scov/main.c

@@ -1,28 +1,13 @@
-/*************************************************************************
+/**
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that uses BACnet SubscribeCOV service 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * message to subscribe to a BACnet object for Change-of-Value notifications
- * a copy of this software and associated documentation files (the
+ * in a BACnet device and print the Change-of-Value notifications values 
- * "Software"), to deal in the Software without restriction, including
+ * to the console.
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @date 2006
- * permit persons to whom the Software is furnished to do so, subject to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>
@@ -185,6 +170,8 @@ static void print_usage(char *filename)
 
 static void print_help(char *filename)
 {
+    printf("Subscribe to a BACnet object for Change-of-Value notifications\n"
+        "in a BACnet device and print the Change-of-Value notifications.\n");
     printf("\n");
     printf("device-id:\n"
         "The subscriber BACnet Device Object Instance number.\n");

apps/server/main.c

@@ -1,27 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that simulates a BACnet server device on the 
- *
+ * network using the BACnet Stack and all the example object types.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2006
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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.
- *
- *********************************************************************/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -71,8 +55,6 @@
 #include "bacnet/basic/ucix/ucix.h"
 #endif /* defined(BAC_UCI) */
 
-/** @file server/main.c  Example server application using the BACnet Stack. */
-
 /* (Doxygen note: The next two lines pull all the following Javadoc
  *  into the ServerDemo module.) */
 /** @addtogroup ServerDemo */

apps/timesync/main.c

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet TimeSynchronization service
- *
+ *  message with the local or arbitrary time and date to sync another device 
- * Permission is hereby granted, free of charge, to any person obtaining
+ *  on the network.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2006
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/ucov/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet Unconfirmed Change-of-Value 
- *
+ * Notification to the network
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2006
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>
@@ -67,6 +49,9 @@ static void Init_Service_Handlers(void)
 
 static void print_usage(char *filename)
 {
+    printf("Sends a BACnet Unconfirmed Change-of-Value Notification\n"
+        "to the network.\n");
+    printf("\n");
     printf("Usage: %s pid device-id object-type object-instance "
         "time property tag value [priority] [index]\n", filename);
     printf("\n");

apps/uevent/main.c

@@ -1,29 +1,11 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2016 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet UnconfirmedEventNotification
- *
+ * to the network
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * a copy of this software and associated documentation files (the
+ * @date 2016
- * "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
- * 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 */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/uptransfer/main.c

@@ -1,28 +1,11 @@
-/*************************************************************************
+/**
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that sends a BACnet UnconfirmedPrivateTransfer
- * Permission is hereby granted, free of charge, to any person obtaining
+ * message to the network
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2016
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>
@@ -143,6 +126,7 @@ static void print_usage(char *filename)
 
 static void print_help(char *filename)
 {
+    printf("Send BACnet UnconfirmedPrivateTransfer message to the network.\n");
     printf("device-instance:\n"
         "BACnet Device Object Instance number that you are\n"
         "trying to communicate to.  This number will be used\n"

apps/whohas/main.c

@@ -1,29 +1,13 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet Who-Has request to devices,
- *
+ * and prints any I-Have responses received.  This is useful for finding
- * Permission is hereby granted, free of charge, to any person obtaining
+ * devices on the network, or for finding devices that support a particular
- * a copy of this software and associated documentation files (the
+ * object type and instance range.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2006
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/whois/main.c

@@ -1,29 +1,13 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet Who-Is request to devices,
- *
+ * and prints any I-Am responses received.  This is useful for finding
- * Permission is hereby granted, free of charge, to any person obtaining
+ * devices on a network, or for finding devices that are in a specific
- * a copy of this software and associated documentation files (the
+ * instance range.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2006
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/whoisrouter/main.c

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2008 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet Who-Is-Router-To-Network 
- *
+ * message for one or more networks, and prints any I-Am-Router-To-Network
- * Permission is hereby granted, free of charge, to any person obtaining
+ * responses received.  This is useful for finding routers on the network.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2008
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/writebdt/main.c

@@ -1,29 +1,13 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2020 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that sends a BACnet BVLC message 
- *
+ * Write-Broadcast-Distribution-Table to a BBMD on the network,
- * Permission is hereby granted, free of charge, to any person obtaining
+ * and prints the result code received.  This is useful for
- * a copy of this software and associated documentation files (the
+ * configuring the BBMD on the network.
- * "Software"), to deal in the Software without restriction, including
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @date 2020
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @copyright SPDX-License-Identifier: MIT
- * 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 BVLC message, and displays the reply */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/writefile/main.c

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that uses BACnet AtomicWriteFile service 
- *
+ * to send a local file to a another device on the network.
- * Permission is hereby granted, free of charge, to any person obtaining
+ * This tool sends the file in chunks to the target device.
- * a copy of this software and associated documentation files (the
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * "Software"), to deal in the Software without restriction, including
+ * @date 2008
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @copyright SPDX-License-Identifier: MIT
- * 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>

apps/writeprop/main.c

@@ -1,29 +1,14 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2006-2007 Steve Karg <skarg@users.sourceforge.net>
+ * @brief command line tool that uses BACnet WriteProperty service 
- *
+ * message to write object property values to another device on 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * the network and prints an acknowledgment or error response of
- * a copy of this software and associated documentation files (the
+ * this confirmed service request.  This is useful for testing
- * "Software"), to deal in the Software without restriction, including
+ * the WriteProperty service.
- * without limitation the rights to use, copy, modify, merge, publish,
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @date 2006-2007
- * permit persons to whom the Software is furnished to do so, subject to
+ * @copyright SPDX-License-Identifier: MIT
- * 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 response */
 #include <stddef.h>
 #include <stdint.h>
 #include <stdio.h>

apps/writepropm/main.c

@@ -1,28 +1,14 @@
-/*************************************************************************
+/**
- * Copyright (C) 2017 Steve Karg <skarg@users.sourceforge.net>
+ * @file
- *
+ * @brief command line tool that uses BACnet WritePropertyMultiple service 
- * Permission is hereby granted, free of charge, to any person obtaining
+ * message to write object property values to another device on 
- * a copy of this software and associated documentation files (the
+ * the network and prints an acknowledgment or error response of
- * "Software"), to deal in the Software without restriction, including
+ * this confirmed service request.  This is useful for testing
- * without limitation the rights to use, copy, modify, merge, publish,
+ * the WritePropertyMultiple service.
- * distribute, sublicense, and/or sell copies of the Software, and to
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * permit persons to whom the Software is furnished to do so, subject to
+ * @date 2017
- * the following conditions:
+ * @copyright SPDX-License-Identifier: MIT
- *
+ */
- * 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>

src/bacnet/abort.c

@@ -1,36 +1,11 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005 Steve Karg
+ * @brief BACnet Abort Reason Encoding and Decoding
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @author Peter McShane <petermcs@users.sourceforge.net>
- modify it under the terms of the GNU General Public License
+ * @date 2007
- as published by the Free Software Foundation; either version 2
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- of the License, or (at your option) any later version.
+ */
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"
@@ -38,8 +13,6 @@
 #include "bacnet/bacdcode.h"
 #include "bacnet/abort.h"
 
-/** @file abort.c  Abort Encoding/Decoding */
-
 /**
  * @brief Convert error-code into abort-reason
  *

src/bacnet/abort.h

@@ -1,26 +1,11 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet Abort Reason Encoding and Decoding
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Peter McShane <petermcs@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2007
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* 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 BACNET_ABORT_H
 #define BACNET_ABORT_H
 

src/bacnet/access_rule.c

@@ -1,28 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnetAccessRule service encode and decode
- *
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
-
 #include <stdint.h>
 #include <stdbool.h>
 #include "bacnet/access_rule.h"

src/bacnet/access_rule.h

@@ -1,30 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnetAccessRule service encode and decode
-*
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ACCESS_RULE_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ACCESS_RULE_H
-* 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 ACCESS_RULE_H
-#define ACCESS_RULE_H
 
 #include <stdbool.h>
 #include <stdint.h>

src/bacnet/alarm_ack.h

@@ -17,7 +17,7 @@
 #include "bacnet/bacapp.h"
 #include "bacnet/timestamp.h"
 
-typedef struct {
+typedef struct BACnetAcknowledgeAlarmInfo {
     uint32_t ackProcessIdentifier;
     BACNET_OBJECT_ID eventObjectIdentifier;
     BACNET_EVENT_STATE eventStateAcked;

src/bacnet/apdu.h

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet APDU structures
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2007
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_APDU_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_APDU_H
-* 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 APDU_H
-#define APDU_H
-
 #include <stdbool.h>
 #include <stdint.h>
 /* BACnet Stack defines - first */

src/bacnet/arf.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005 Steve Karg
+ * @brief BACnet AtomicReadFile service structures, codecs, and handlers.
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2005
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"
@@ -38,8 +12,6 @@
 #include "bacnet/bacdcode.h"
 #include "bacnet/arf.h"
 
-/** @file arf.c  Atomic Read File */
-
 /**
  * @brief Encode the AtomicReadFile service request
  *

src/bacnet/arf.h

@@ -1,29 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet AtomicReadFile service structures, codecs, and handlers.
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2007
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ATOMIC_READ_FILE_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ATOMIC_READ_FILE_H
-* 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 ATOMIC_READ_FILE_H
-#define ATOMIC_READ_FILE_H
-
 #include <stdint.h>
 #include <stdbool.h>
 /* BACnet Stack defines - first */

src/bacnet/assigned_access_rights.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnetAssignedAccessRights structure and codecs
- *
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stdint.h>
 #include "bacnet/assigned_access_rights.h"
 #include "bacnet/bacdcode.h"

src/bacnet/assigned_access_rights.h

@@ -1,28 +1,10 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnetAssignedAccessRights structure and codecs
-*
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "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 BACNET_ASSIGNED_ACCESS_RIGHTS_H
 #define BACNET_ASSIGNED_ACCESS_RIGHTS_H
 
@@ -34,7 +16,7 @@
 #include "bacnet/bacapp.h"
 #include "bacnet/bacdevobjpropref.h"
 
-typedef struct {
+typedef struct BACnetAssignedAccessRights {
     BACNET_DEVICE_OBJECT_REFERENCE assigned_access_rights;
     bool enable;
 } BACNET_ASSIGNED_ACCESS_RIGHTS;

src/bacnet/authentication_factor.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnet BACnetAuthenticationFactor structure and codecs
- *
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stdint.h>
 #include "bacnet/authentication_factor.h"
 #include "bacnet/bacdcode.h"

src/bacnet/authentication_factor.h

@@ -1,28 +1,10 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnet BACnetAuthenticationFactor structure and codecs
-*
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "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 BACNET_AUTHENTICATION_FACTOR_H
 #define BACNET_AUTHENTICATION_FACTOR_H
 
@@ -33,13 +15,12 @@
 /* BACnet Stack API */
 #include "bacnet/bacapp.h"
 
-typedef struct {
+typedef struct BACnetAuthenticationFactor {
     BACNET_AUTHENTICATION_FACTOR_TYPE format_type;
     uint32_t format_class;
     BACNET_OCTET_STRING value;
 } BACNET_AUTHENTICATION_FACTOR;
 
-
 #ifdef __cplusplus
 extern "C" {
 #endif /* __cplusplus */

src/bacnet/authentication_factor_format.c

@@ -1,27 +1,10 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnet BACnetAuthenticationFactorFormat codecs
- *
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "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.
- *
- *********************************************************************/
 #include <stdint.h>
 #include "bacnet/bacdcode.h"
 #include "bacnet/authentication_factor_format.h"

src/bacnet/authentication_factor_format.h

@@ -1,28 +1,10 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2015 Nikola Jelic <nikola.jelic@euroicc.com>
+ * @brief BACnet BACnetAuthenticationFactorFormat structure and codecs
-*
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2015
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "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 BACNET_AUTHENTICATION_FACTOR_FORMAT_H
 #define BACNET_AUTHENTICATION_FACTOR_FORMAT_H
 
@@ -31,7 +13,7 @@
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"
 
-typedef struct {
+typedef struct BACnetAuthenticationFactorFormat {
     BACNET_AUTHENTICATION_FACTOR_TYPE format_type;
     uint32_t vendor_id, vendor_format;
 } BACNET_AUTHENTICATION_FACTOR_FORMAT;

src/bacnet/awf.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005 Steve Karg
+ * @brief BACnet AtomicWriteFile service structures, codecs, and handlers.
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2005
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+*/
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"
@@ -38,8 +12,6 @@
 #include "bacnet/bacdcode.h"
 #include "bacnet/awf.h"
 
-/** @file awf.c  Atomic Write File */
-
 /**
  * @brief Encode the AtomicWriteFile service request
  *

src/bacnet/awf.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet AtomicWriteFile service structures, codecs, and handlers.
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2007
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ATOMIC_WRITE_FILE_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ATOMIC_WRITE_FILE_H
-* 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 ATOMIC_WRITE_FILE_H
-#define ATOMIC_WRITE_FILE_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacaddr.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2007 Steve Karg
+ * @brief BACnet Address structure utilities
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2007
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>
@@ -44,8 +18,6 @@
 #include "bacnet/bacstr.h"
 #include "bacnet/bacaddr.h"
 
-/** @file bacaddr.c  BACnet Address structure utilities */
-
 /**
  * @brief Copy a #BACNET_ADDRESS value to another
  * @param dest - #BACNET_ADDRESS to be copied into

src/bacnet/bacaddr.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet address encode and decode helper functions
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2007
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "Software"), to deal in the Software without restriction, including
+ */
- * without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ADDRESS_H
- * distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ADDRESS_H
- * 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 BACADDR_H
-#define BACADDR_H
 
 #include <stddef.h>
 #include <stdint.h>

src/bacnet/bacapp.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005 Steve Karg
+ * @brief Utilities for the BACnet_Application_Data_Value
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2005
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 #include <stdbool.h>
 #include <string.h>
@@ -59,8 +33,6 @@
 #include "bacnet/special_event.h"
 #include "bacnet/basic/sys/platform.h"
 
-/** @file bacapp.c  Utilities for the BACnet_Application_Data_Value */
-
 /**
  * @brief Encode application data given by a pointer into the APDU.
  * @param apdu - Pointer to the buffer to encode to, or NULL for length

src/bacnet/bacapp.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet application data encode and decode helper functions
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2007
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "Software"), to deal in the Software without restriction, including
+ */
- * without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_APP_H
- * distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_APP_H
- * 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 BACAPP_H
-#define BACAPP_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacdcode.c

@@ -1,37 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2004 Steve Karg
+ * @brief BACnet primitive data encode and decode helper functions
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2004
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <string.h>
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"
@@ -41,8 +14,6 @@
 #include "bacnet/bacint.h"
 #include "bacnet/bacreal.h"
 
-/** @file bacdcode.c  Functions to encode/decode BACnet data types */
-
 /* max-segments-accepted
    B'000'      Unspecified number of segments accepted.
    B'001'      2 segments accepted.

src/bacnet/bacdcode.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet primitive data encode and decode helper functions
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2004
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "Software"), to deal in the Software without restriction, including
+ */
- * without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_CODEC_H
- * distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_CODEC_H
- * 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 BACDCODE_H
-#define BACDCODE_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacdef.h

@@ -3,12 +3,10 @@
  * @brief Core BACnet defines and enumerations and structures
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2004
- * @copyright 2004 Steve Karg <skarg@users.sourceforge.net>
+ * @copyright SPDX-License-Identifier: MIT
- *
- * SPDX-License-Identifier: MIT
  */
-#ifndef BACDEF_H
+#ifndef BACNET_DEFINES_H
-#define BACDEF_H
+#define BACNET_DEFINES_H
 
 #include <stddef.h>
 #include <stdint.h>

src/bacnet/bacdest.c

@@ -3,11 +3,7 @@
  * @brief BACnetDestination complex data type encode and decode
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date December 2022
- * @section LICENSE
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- *
- * Copyright (C) 2022 Steve Karg <skarg@users.sourceforge.net>
- *
- * SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
  */
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacdest.h

@@ -3,11 +3,7 @@
  * @brief API for BACnetDestination complex data type encode and decode
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date May 2022
- * @section LICENSE
+ * @copyright SPDX-License-Identifier: MIT
- *
- * Copyright (C) 2022 Steve Karg <skarg@users.sourceforge.net>
- *
- * SPDX-License-Identifier: MIT
  */
 #ifndef BACNET_DESTINATION_H
 #define BACNET_DESTINATION_H

src/bacnet/bacdevobjpropref.c

@@ -1,37 +1,11 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2008 John Minack
+ * @brief BACnetDeviceObjectPropertyReference structure, encode, decode
- Copyright (C) 2022 Steve Karg <skarg@users.sourceforge.net>
+ * @author John Minack <minack@users.sourceforge.net>
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2008
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 #include <stdbool.h>
 #include "bacnet/bacdcode.h"
@@ -39,9 +13,6 @@
 #include "bacnet/timestamp.h"
 #include "bacnet/bacdevobjpropref.h"
 
-/** @file bacdevobjpropref.c  BACnet Application Device Object (Property)
- * Reference */
-
 /**
  * Encode a property reference for the device object.
  * Add an opening tag, encode the property and finally

src/bacnet/bacdevobjpropref.h

@@ -1,29 +1,13 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2008 John Minack
+ * @brief BACnetDeviceObjectPropertyReference structure, encode, decode
- * Copyright (C) 2022 Steve Karg <skarg@users.sourceforge.net>
+ * @author John Minack <minack@users.sourceforge.net>
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2008
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "Software"), to deal in the Software without restriction, including
+ */
- * without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_DEV_PROP_REF_H_
- * distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_DEV_PROP_REF_H_
- * 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 _BAC_DEV_PROP_REF_H_
-#define _BAC_DEV_PROP_REF_H_
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacenum.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
- *
+ * @file
- * Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet defines and enumerations
- *
+ * @author Steve Karg <skarg@users.sourceforge.net>
- * Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2004
- * a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
- * "Software"), to deal in the Software without restriction, including
+ */
- * without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ENUMERATIONS_H
- * distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ENUMERATIONS_H
- * 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 BACENUM_H
-#define BACENUM_H
 
 typedef enum {
     PROP_ACKED_TRANSITIONS = 0,

src/bacnet/bacerror.c

@@ -1,3 +1,10 @@
+/**
+ * @file
+ * @brief BACnet error encode and decode helper functions
+ * @author Steve Karg <skarg@users.sourceforge.net>
+ * @date 2005
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
+ */
 /*####COPYRIGHTBEGIN####
  -------------------------------------------
  Copyright (C) 2005 Steve Karg

src/bacnet/bacerror.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet error encode and decode helper functions
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2012
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_ERROR_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_ERROR_H
-* 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 BACERROR_H
-#define BACERROR_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacint.c

@@ -1,39 +1,11 @@
-/*####COPYRIGHTBEGIN####
- -------------------------------------------
- Copyright (C) 2004 Steve Karg
-
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- as published by the Free Software Foundation; either version 2
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
-/* BACnet Integer encoding and decoding */
 
+/**
+ * @file
+ * @brief BACnet integer encode and decode helper functions
+ * @author Steve Karg <skarg@users.sourceforge.net>
+ * @date 2004
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
+ */
 #include <stdint.h>
 #include <stdbool.h>
 /* BACnet Stack defines - first */
@@ -41,8 +13,6 @@
 /* BACnet Stack API */
 #include "bacnet/bacint.h"
 
-/** @file bacint.c  Encode/Decode Integer Types */
-
 int encode_unsigned16(uint8_t *apdu, uint16_t value)
 {
     if (apdu) {

src/bacnet/bacint.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet integer encode and decode helper functions
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2012
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_INTEGER_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_INTEGER_H
-* 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 BACINT_H
-#define BACINT_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacprop.c

@@ -1,36 +1,11 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005 John Goulah
+ * @brief BACnet property tag lookup functions
-
+ * @author John Goulah <bigjohngoulah@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @author Steve Karg <skarg@users.sourceforge.net>
- modify it under the terms of the GNU General Public License
+ * @date 2005
- as published by the Free Software Foundation; either version 2
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- of the License, or (at your option) any later version.
+ */
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdbool.h>
 #include <string.h>
 #if PRINT_ENABLED
@@ -38,8 +13,6 @@
 #endif
 #include "bacnet/bacprop.h"
 
-/** @file bacprop.c  Lookup BACnet Property Tags */
-
 PROP_TAG_DATA bacnet_object_device_property_tag_map[] = {
     { PROP_OBJECT_IDENTIFIER, BACNET_APPLICATION_TAG_OBJECT_ID },
     { PROP_OBJECT_NAME, BACNET_APPLICATION_TAG_CHARACTER_STRING },

src/bacnet/bacprop.h

@@ -1,28 +1,13 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2005 John Goulah
+ * @brief BACnet property tag lookup functions
-*
+ * @author John Goulah <bigjohngoulah@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2005
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* without limitation the rights to use, copy, modify, merge, publish,
+ */
-* distribute, sublicense, and/or sell copies of the Software, and to
+#ifndef BACNET_PROPERTY_H
-* permit persons to whom the Software is furnished to do so, subject to
+#define BACNET_PROPERTY_H
-* 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 BACPROP_H
-#define BACPROP_H
 
 #include <stdbool.h>
 #include <stdint.h>

src/bacnet/bacpropstates.c

@@ -1,44 +1,17 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2008 John Minack
+ * @brief BACnet property state encode and decode functions
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @author John Minack <minack@users.sourceforge.net>
- modify it under the terms of the GNU General Public License
+ * @date 2008
- as published by the Free Software Foundation; either version 2
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- of the License, or (at your option) any later version.
+ */
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stdint.h>
 #include "bacnet/bacdcode.h"
 #include "bacnet/npdu.h"
 #include "bacnet/timestamp.h"
 #include "bacnet/bacpropstates.h"
 
-/** @file bacpropstates.c  Encode/Decode BACnet Application Property States */
-
 /**
  * @brief Decodes BACnetPropertyState from bytes into a data structure
  *

src/bacnet/bacpropstates.h

@@ -1,28 +1,13 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2008 John Minack
+ * @brief BACnet property state encode and decode functions
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author John Minack <minack@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2008
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* without limitation the rights to use, copy, modify, merge, publish,
+ */
-* distribute, sublicense, and/or sell copies of the Software, and to
+#ifndef BACNET_PROPERTY_STATES_H_
-* permit persons to whom the Software is furnished to do so, subject to
+#define BACNET_PROPERTY_STATES_H_
-* 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 _BAC_PROP_STATES_H_
-#define _BAC_PROP_STATES_H_
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacreal.c

@@ -1,37 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2004-2008 Steve Karg
+ * @brief BACnet single precision REAL encode and decode functions
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2004
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <string.h>
 /* BACnet Stack defines - first */
 #include "bacnet/bacdef.h"

src/bacnet/bacreal.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet single precision REAL encode and decode functions
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2012
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_REAL_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_REAL_H
-* 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 BACREAL_H
-#define BACREAL_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bacstr.c

@@ -1,37 +1,11 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2004 Steve Karg
+ * @brief BACnet bitstring, octectstring, and characterstring encode 
-
+ *  and decode functions
- This program is free software; you can redistribute it and/or
+ * @author Steve Karg <skarg@users.sourceforge.net>
- modify it under the terms of the GNU General Public License
+ * @date 2004
- as published by the Free Software Foundation; either version 2
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- of the License, or (at your option) any later version.
+ */
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <stdbool.h>
 #include <stdint.h>
 #include <stdlib.h>
@@ -43,7 +17,6 @@
 /* BACnet Stack API */
 #include "bacnet/bacstr.h"
 
-/** @file bacstr.c  Manipulate Bit/Char/Octet Strings */
 #ifndef BACNET_STRING_UTF8_VALIDATION
 #define BACNET_STRING_UTF8_VALIDATION 1
 #endif

src/bacnet/bacstr.h

@@ -1,28 +1,13 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet bitstring, octectstring, and characterstring encode 
-*
+ *  and decode functions
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2012
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* without limitation the rights to use, copy, modify, merge, publish,
+ */
-* distribute, sublicense, and/or sell copies of the Software, and to
+#ifndef BACNET_STRING_H
-* permit persons to whom the Software is furnished to do so, subject to
+#define BACNET_STRING_H
-* 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 BACSTR_H
-#define BACSTR_H
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/bactext.c

@@ -1,45 +1,16 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2005-2006 Steve Karg
+ * @brief Lookup or Translate BACnet Name Text
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2005
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <stdio.h>
 #include <stdlib.h>
 #include "bacnet/indtext.h"
 #include "bacnet/bacenum.h"
 #include "bacnet/bactext.h"
 
-/** @file bactext.c  Lookup or Translate BACnet Name Text */
-
 static const char *ASHRAE_Reserved_String = "Reserved for Use by ASHRAE";
 static const char *Vendor_Proprietary_String = "Vendor Proprietary Value";
 

src/bacnet/bactext.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief BACnet text enumerations lookup functions
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2012
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_TEXT_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_TEXT_H
-* 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 BACTEXT_H
-#define BACTEXT_H
 
 /* tiny implementations have no need to print */
 #if PRINT_ENABLED

src/bacnet/bactimevalue.h

@@ -1,29 +1,13 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2015 Nikola Jelic
+ * @brief BACnet time-value encode and decode functions
-*
+ * @author Nikola Jelic <nikola.jelic@euroicc.com>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* a copy of this software and associated documentation files (the
+ * @date 2015
-* "Software"), to deal in the Software without restriction, including
+ * @copyright SPDX-License-Identifier: MIT
-* without limitation the rights to use, copy, modify, merge, publish,
+ */
-* distribute, sublicense, and/or sell copies of the Software, and to
+#ifndef BACNET_TIME_VALUE_H_
-* permit persons to whom the Software is furnished to do so, subject to
+#define BACNET_TIME_VALUE_H_
-* 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 _BAC_TIME_VALUE_H_
-#define _BAC_TIME_VALUE_H_
 
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/bbmd/h_bbmd.c

@@ -1,37 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2020 Steve Karg
+ * @brief BBMD (BACnet Broadcast Management Device) for BACnet/IPv4
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2020
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <stdio.h> /* for standard i/o, like printing */
 #include <stdint.h> /* for standard integer types uint8_t etc. */
 #include <stdbool.h> /* for the standard bool type. */
@@ -527,7 +500,7 @@ static void bbmd_read_bdt_ack_handler(
             break;
         }
     }
-#else 
+#else
     (void)addr;
     (void)npdu;
     (void)npdu_length;

src/bacnet/basic/bbmd/h_bbmd.h

@@ -1,33 +1,12 @@
 /**
  * @file
+ * @brief Header file for a basic BBMD for BVLC IPv4 handler
  * @author Steve Karg
  * @date February 2020
- * @brief Header file for a basic BBMD for BVLC IPv4 handler
+ * @copyright SPDX-License-Identifier: MIT
- *
- * @section LICENSE
- *
- * 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 BVLC_HANDLER_H
+#ifndef BACNET_BASIC_BVLC_HANDLER_H
-#define BVLC_HANDLER_H
+#define BACNET_BASIC_BVLC_HANDLER_H
-
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/bbmd6/h_bbmd6.c

@@ -1,37 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2016 Steve Karg
+ * @brief BBMD (BACnet Broadcast Management Device) for BACnet/IPv6
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2016
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
-
 #include <stdio.h> /* for standard i/o, like printing */
 #include <stdint.h> /* for standard integer types uint8_t etc. */
 #include <stdbool.h> /* for the standard bool type. */
@@ -128,7 +101,7 @@ void bvlc6_maintenance_timer(uint16_t seconds)
         }
     }
 #else
-    (void)seconds;    
+    (void)seconds;
 #endif
 }
 
@@ -205,13 +178,13 @@ static void bbmd6_add_vmac(uint32_t device_id, BACNET_IP6_ADDRESS *addr)
             } else {
                 /* VMAC exists, but device ID changed */
                 VMAC_Delete(list_device_id);
-                PRINTF("BVLC6: VMAC existed for %u [", 
+                PRINTF("BVLC6: VMAC existed for %u [",
                     (unsigned int)list_device_id);
                 for (i = 0; i < new_vmac.mac_len; i++) {
                     PRINTF("%02X", new_vmac.mac[i]);
                 }
                 PRINTF("]\n");
-                PRINTF("BVLC6: Removed VMAC for %lu.\n", 
+                PRINTF("BVLC6: Removed VMAC for %lu.\n",
                     (unsigned long)list_device_id);
             }
         }
@@ -220,24 +193,24 @@ static void bbmd6_add_vmac(uint32_t device_id, BACNET_IP6_ADDRESS *addr)
             if (vmac) {
                 /* device ID already exists. Update MAC. */
                 memmove(vmac, &new_vmac, sizeof(struct vmac_data));
-                PRINTF("BVLC6: VMAC for %u [", 
+                PRINTF("BVLC6: VMAC for %u [",
                     (unsigned int)device_id);
                 for (i = 0; i < new_vmac.mac_len; i++) {
                     PRINTF("%02X", new_vmac.mac[i]);
                 }
                 PRINTF("]\n");
-                PRINTF("BVLC6: Updated VMAC for %lu.\n", 
+                PRINTF("BVLC6: Updated VMAC for %lu.\n",
                     (unsigned long)device_id);
             } else {
                 /* new entry - add it! */
                 VMAC_Add(device_id, &new_vmac);
-                PRINTF("BVLC6: VMAC for %u [", 
+                PRINTF("BVLC6: VMAC for %u [",
                     (unsigned int)device_id);
                 for (i = 0; i < new_vmac.mac_len; i++) {
                     PRINTF("%02X", new_vmac.mac[i]);
                 }
                 PRINTF("]\n");
-                PRINTF("BVLC6: Added VMAC for %lu.\n", 
+                PRINTF("BVLC6: Added VMAC for %lu.\n",
                     (unsigned long)device_id);
             }
         }

src/bacnet/basic/bbmd6/h_bbmd6.h

@@ -1,33 +1,12 @@
 /**
-* @file
+ * @file
-* @author Steve Karg
+ * @brief Header file for a basic BBMD for BVLC IPv6 handler
-* @date October 2019
+ * @author Steve Karg
-* @brief Header file for a basic BBMD for BVLC IPv6 handler
+ * @date October 2016
-*
+ * @copyright SPDX-License-Identifier: MIT
-* @section LICENSE
+ */
-*
+#ifndef BACNET_BASIC_BVLC6_HANDLER_H
-* Permission is hereby granted, free of charge, to any person obtaining
+#define BACNET_BASIC_BVLC6_HANDLER_H
-* 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 BVLC6_HANDLER_H
-#define BVLC6_HANDLER_H
-
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/bbmd6/vmac.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2015 Steve Karg
+ * @brief Virtual MAC (VMAC) for BACnet/IPv6 neighbors
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2016
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/bbmd6/vmac.h

@@ -1,10 +1,12 @@
 /**
-* @file
+ * @file
-* @author Steve Karg
+ * @brief API for Virtual MAC (VMAC) of BACnet/IPv6 neighbors
-* @date 2016
+ * @author Steve Karg <skarg@users.sourceforge.net>
-*/
+ * @date 2016
-#ifndef VMAC_H
+ * @copyright SPDX-License-Identifier: MIT
-#define VMAC_H
+ */
+#ifndef BACNET_BASIC_BBMD6_VMAC_H
+#define BACNET_BASIC_BBMD6_VMAC_H
 
 #include <stdint.h>
 #include <stdbool.h>
@@ -19,7 +21,7 @@
 * @{
 */
 struct vmac_data {
-    uint8_t mac[18];
+    uint8_t mac[VMAC_MAC_MAX];
     uint8_t mac_len;
 };
 /** @} */

src/bacnet/basic/binding/address.c

@@ -1,36 +1,10 @@
-/*####COPYRIGHTBEGIN####
+/**
- -------------------------------------------
+ * @file
- Copyright (C) 2004 Steve Karg
+ * @brief Handle device instance and NPDU address binding
-
+ * @author Steve Karg <skarg@users.sourceforge.net>
- This program is free software; you can redistribute it and/or
+ * @date 2004
- modify it under the terms of the GNU General Public License
+ * @copyright SPDX-License-Identifier: GPL-2.0-or-later WITH GCC-exception-2.0
- as published by the Free Software Foundation; either version 2
+ */
- of the License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to:
- The Free Software Foundation, Inc.
- 59 Temple Place - Suite 330
- Boston, MA  02111-1307, USA.
-
- As a special exception, if other files instantiate templates or
- use macros or inline functions from this file, or you compile
- this file and link it with other works to produce a work based
- on this file, this file does not by itself cause the resulting
- work to be covered by the GNU General Public License. However
- the source code for this file must still be made available in
- accordance with section (3) of the GNU General Public License.
-
- This exception does not invalidate any other reasons why a work
- based on this file might be covered by the GNU General Public
- License.
- -------------------------------------------
-####COPYRIGHTEND####*/
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>
@@ -51,8 +25,6 @@
 #endif
 #endif
 
-/** @file address.c  Handle address binding */
-
 /* This module is used to handle the address binding that */
 /* occurs in BACnet.  A device id is bound to a MAC address. */
 /* The normal method is using Who-Is, and using the data from I-Am */

src/bacnet/basic/binding/address.h

@@ -1,28 +1,12 @@
-/**************************************************************************
+/**
-*
+ * @file
-* Copyright (C) 2012 Steve Karg <skarg@users.sourceforge.net>
+ * @brief API for basic BACnet address binding table
-*
+ * @author Steve Karg <skarg@users.sourceforge.net>
-* Permission is hereby granted, free of charge, to any person obtaining
+ * @date 2004
-* a copy of this software and associated documentation files (the
+ * @copyright SPDX-License-Identifier: MIT
-* "Software"), to deal in the Software without restriction, including
+ */
-* without limitation the rights to use, copy, modify, merge, publish,
+#ifndef BACNET_BASIC_ADDRESS_H
-* distribute, sublicense, and/or sell copies of the Software, and to
+#define BACNET_BASIC_ADDRESS_H
-* 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 ADDRESS_H
-#define ADDRESS_H
 
 #include <stddef.h>
 #include <stdint.h>

src/bacnet/basic/client/bac-data.c

@@ -3,8 +3,7 @@
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2013
  * @brief Store properties from other BACnet devices
- *
+ * @copyright SPDX-License-Identifier: MIT
- * SPDX-License-Identifier: MIT
  */
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/client/bac-data.h

@@ -1,12 +1,12 @@
 /**
  * @file
+ * @brief API for basic BACnet data handling
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2013
- *
+ * @copyright SPDX-License-Identifier: MIT
- * SPDX-License-Identifier: MIT
  */
-#ifndef BAC_DATA_H
+#ifndef BACNET_BASIC_CLIENT_DATA_H
-#define BAC_DATA_H
+#define BACNET_BASIC_CLIENT_DATA_H
 
 #include <stdint.h>
 /* BACnet Stack defines - first */

src/bacnet/basic/client/bac-discover.c

@@ -1,10 +1,9 @@
 /**
  * @file
+ * @brief Discover all BACnet devices on a destination network
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2024
- * @brief Discover all BACnet devices on a destination network
+ * @copyright SPDX-License-Identifier: MIT
- *
- * SPDX-License-Identifier: MIT
  */
 #include <stdint.h>
 #include <stdbool.h>

src/bacnet/basic/client/bac-discover.h

@@ -1,13 +1,12 @@
 /**
  * @file
+ * @brief API for basic BACnet client device discovery
  * @author Steve Karg <skarg@users.sourceforge.net>
  * @date 2024
- *
+ * @copyright SPDX-License-Identifier: MIT
- * SPDX-License-Identifier: MIT
  */
-#ifndef BAC_DISCOVER_H
+#ifndef BACNET_BASIC_CLIENT_DISCOVER_H
-#define BAC_DISCOVER_H
+#define BACNET_BASIC_CLIENT_DISCOVER_H
-
 #include <stdbool.h>
 #include <stdint.h>
 /* BACnet Stack defines - first */
@@ -48,7 +47,7 @@ uint32_t bacnet_discover_device_instance(unsigned index);
 BACNET_STACK_EXPORT
 int bacnet_discover_device_object_count(uint32_t device_id);
 BACNET_STACK_EXPORT
-bool bacnet_discover_device_object_identifier(uint32_t device_id, 
+bool bacnet_discover_device_object_identifier(uint32_t device_id,
     unsigned index, BACNET_OBJECT_ID *object_id);
 BACNET_STACK_EXPORT
 unsigned long bacnet_discover_device_elapsed_milliseconds(
@@ -63,10 +62,10 @@ unsigned int bacnet_discover_object_property_count(
     uint32_t object_instance);
 BACNET_STACK_EXPORT
 bool bacnet_discover_object_property_identifier(
-    uint32_t device_id, 
+    uint32_t device_id,
     BACNET_OBJECT_TYPE object_type,
     uint32_t object_instance,
-    unsigned index, 
+    unsigned index,
     uint32_t *property_id);
 BACNET_STACK_EXPORT
 bool bacnet_discover_property_value(uint32_t device_id,