Created simple project for GTK BACnet Discovery Application. (#1064)

2025-08-07 17:16:34 -05:00
parent 11c1338863
commit 3f89981b29
6 changed files with 957 additions and 0 deletions
@@ -0,0 +1,116 @@
+# BACnet GTK Discovery Application
+
+A GTK-based graphical application for discovering BACnet devices, objects,
+and properties on a network.
+
+## Features
+
+- **Device Discovery**: Browse and discover BACnet devices on the network
+- **Object Discovery**: View all objects within a selected BACnet device
+- **Property Inspection**: Examine properties of individual BACnet objects
+- **Three-Pane Interface**:
+  - Left pane: Device list with device ID, name, model, and address
+  - Top-right pane: Object list for selected device
+  - Bottom-right pane: Property list for selected object
+
+## Prerequisites
+
+### GTK+ 3.0 Development Libraries
+
+The application requires GTK+ 3.0 development libraries to be installed:
+
+#### Ubuntu/Debian:
+```bash
+sudo apt-get update
+sudo apt-get install libgtk-3-dev pkg-config
+```
+
+#### Fedora/RHEL/CentOS:
+```bash
+sudo yum install gtk3-devel pkgconfig
+# or for newer versions:
+sudo dnf install gtk3-devel pkgconfig
+```
+
+#### openSUSE:
+```bash
+sudo zypper install gtk3-devel pkg-config
+```
+
+#### Arch Linux:
+```bash
+sudo pacman -S gtk3 pkgconfig
+```
+
+## Building
+
+The BACnet stack library must be built first.
+The apps/Makefile helps with the various options.
+From the project root folder:
+
+```bash
+make gtk-discover
+```
+
+## Running
+
+Execute the built application:
+```bash
+./bin/bacdiscover-gtk
+```
+
+## Usage
+
+1. **Device View**: The left pane shows discovered BACnet devices.
+
+2. **Object View**: Click on a device in the left pane to view its
+   objects in the top-right pane. Objects show:
+   - Object type (Analog Input, Binary Output, etc.)
+   - Object instance number
+   - Object name
+
+3. **Property View**: Click on an object to view its properties
+   in the bottom-right pane, including:
+   - Property name
+   - Property value
+
+4. **Toolbar Functions**:
+   - **Discover Devices**: network device discovery using Who-Is requests
+   - **Refresh**: refreshing current device data
+
+## Architecture
+
+The application is structured with:
+
+- **GTK Components**: ListStore models for each tree view
+- **BACnet Integration**: Uses the BACnet Stack library
+- **Three-Pane Layout**: Resizable paned windows for optimal viewing
+
+## Troubleshooting
+
+### Build Issues:
+
+1. **GTK not found**: Ensure GTK+ 3.0 development packages are installed
+2. **BACnet library missing**: Build the BACnet library first: `make -C apps/lib all`
+3. **pkg-config issues**: Install pkg-config package for your distribution
+
+### Runtime Issues:
+
+1. **Application won't start**: Check that all required libraries are installed
+2. **Segmentation faults**: Build with debug symbols: `make debug`
+
+## Files
+
+- `main.c` - Main application source code
+- `Makefile` - Build configuration
+- `README.md` - This documentation
+
+## Future Enhancements
+
+- Property editing capabilities
+- Device configuration management
+- Trending and logging
+- Alarm and event handling
+- Export/import functionality
+- Multiple datalink support configuration
+- Network diagnostics and monitoring