Added @file description to bacnet.h and lib/main.cpp

Fixed a build issue for the linux+MS/TP combination in trendlog.h
Setup library build to define BIP_DEBUG if it is a Debug build and if it is a BIP build.

bacnet-stack/include/bacnet.h

@@ -34,7 +34,7 @@
 #ifndef BACNET_H
 #define BACNET_H
 
-/* This file is designed to reference the entire BACnet stack library */
+/** @file bacnet.h  This file is designed to reference the entire BACnet stack library */
 
 /* core files */
 #include "version.h"
@@ -96,4 +96,18 @@
 #include "client.h"
 #include "handlers.h"
 
+/* Additions for Doxygen documenting */
+/**
+ * @mainpage BACnet-stack API Documentation
+ * This documents the BACnet-Stack API, OS ports, and sample applications. <br>
+ * 
+ *  - The high-level handler interface can be found in the Modules tab.
+ *  - Specifics for each file can be found in the Files tab.
+ *  - A full list of all functions is provided in the index of the 
+ *  Files->Globals subtab.
+ * 
+ * See doc/README.doxygen for notes on building and extending this document. <br>
+ * In particular, if you have graphviz installed, you can enhance this 
+ * documentation by turning on the function call graphs feature.
+ */
 #endif

bacnet-stack/include/trendlog.h

@@ -27,6 +27,7 @@
 
 #include <stdbool.h>
 #include <stdint.h>
+#include <time.h>		// for time_t
 #include "bacdef.h"
 #include "cov.h"
 #include "rp.h"

bacnet-stack/lib/Makefile

@@ -32,6 +32,9 @@ DEBUGGING =
 ifeq (${BUILD},debug)
 OPTIMIZATION = -O0
 DEBUGGING = -g
+ifeq (${BACDL_DEFINE},-DBACDL_BIP=1)
+DEFINES += -DBIP_DEBUG
+endif
 endif
 CFLAGS  = -Wall $(DEBUGGING) $(OPTIMIZATION) $(STANDARDS) $(INCLUDES) $(DEFINES)
 

bacnet-stack/lib/main.cpp

@@ -1,31 +1,33 @@
-#include "main.h"
+#include "main.h"
-
+
-// a sample exported function
+/** @file lib/main.cpp  Provides DLLMain for Win32 build of library. */
-void SomeFunction(const LPCSTR sometext)
+
-{
+// a sample exported function
-    MessageBoxA(0, sometext, "DLL Message", MB_OK | MB_ICONINFORMATION);
+void SomeFunction(const LPCSTR sometext)
-}
+{
-
+    MessageBoxA(0, sometext, "DLL Message", MB_OK | MB_ICONINFORMATION);
-BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved)
+}
-{
+
-    switch (fdwReason)
+BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved)
-    {
+{
-        case DLL_PROCESS_ATTACH:
+    switch (fdwReason)
-            // attach to process
+    {
-            // return FALSE to fail DLL load
+        case DLL_PROCESS_ATTACH:
-            break;
+            // attach to process
-
+            // return FALSE to fail DLL load
-        case DLL_PROCESS_DETACH:
+            break;
-            // detach from process
+
-            break;
+        case DLL_PROCESS_DETACH:
-
+            // detach from process
-        case DLL_THREAD_ATTACH:
+            break;
-            // attach to thread
+
-            break;
+        case DLL_THREAD_ATTACH:
-
+            // attach to thread
-        case DLL_THREAD_DETACH:
+            break;
-            // detach from thread
+
-            break;
+        case DLL_THREAD_DETACH:
-    }
+            // detach from thread
-    return TRUE; // succesful
+            break;
-}
+    }
+    return TRUE; // succesful
+}