# xBACnet - 把任何数据发布为BACnet

**Repository Path**: guangyuzhang/xBACnet

## Basic Information

- **Project Name**: xBACnet - 把任何数据发布为BACnet
- **Description**: xBACnet - 把任何数据发布为BACnet - Publish Any Data as BACnet
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://xbacnet.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-01-10
- **Last Updated**: 2025-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">xBACnet v1.0.0</h1>
<h4 align="center">把任何数据发布为BACnet</h4>

## xBACnet 介绍

xBACnet把任何数据发布为BACnet!

此应用是一个BACnet服务器软件，用于在BACnet网络中把各种数据数据发布为多种核心服务。
支持的服务有Who-Is、I-Am用于设备绑定，读写属性，读写多属性和值变化订阅。

This application is a BACnet server that supports many core services that
applications need to present data on a BACnet network.  It supports Who-Is
and I-Am for device binding, Read and Write Property, Read and Write
Property Multiple, and COV subscriptions.


## 前提 Prerequisites 
MySQL数据库 MySQL Server
Python (3.4 3.5 3.6 3.7 3.8 3.9 3.10)


## 安装 Installation

* 克隆源代码 Clone Source Code
```
git clone https://gitee.com/xbacnet/xbacnet
```
* 创建数据库 Create Database 
```
mysql -u root -p < xbacnet/database/xbacnet.sql
```
* 安装依赖库 Install Requirements
```
sudo cp ~/xbacnet/xbacnet-server /xbacnet-server
cd /xbacnet-server
sudo pip install -r requirements.txt
```

* 配置xbacnet-server Configure xbacnet-server

打开配置文件 Open config file for local device address 
修改地址 Modify address: lo to the actual interface name by running 'ip a'
修改对象ID Modify objectIdentifier
```
$ sudo nano /xbacnet-server/config.ini
```

编辑数据库设置文件 Edit settings file for database configuration
```
sudo nano /xbacnet-server/settings.py
```

* 打开防火墙端口 Allow port in firewall
```
$ sudo ufw allow 47808
```


### 示例config.ini  Demo config.ini
```
[BACpypes]
objectName: xBACnet Server
address: 192.168.20.193/24
objectIdentifier: 20193
description: xBACnet Server
vendorName: xBACnet Inc.
maxApduLengthAccepted: 1024
segmentationSupported: segmentedBoth
vendorIdentifier: 1524
foreignBBMD: 192.168.20.1
foreignTTL: 30
systemStatus: operational
```


* 调试 Debugging
```
$ sudo python3 server.py --debug --ini config.ini
-- Use --help for help
$ sudo python3 server.py --help
```

* 部署xbacnet-server Deploy xbacnet-server
```
sudo cp /xbacnet-server/xbacnet-server.service /lib/systemd/system/
```

```
sudo systemctl enable xbacnet-server.service
```

```
sudo systemctl start xbacnet-server.service
```

* 如何使用 How to Use
在数据库中的添加对象，编辑对象属性，把要发布的数据写入present_value
Add objects in the database, edit object properties, and write the data to be published into the presenter value

* 开发计划 TODO
1. 增加日志 add logger
2. 自动重加载对象列表 auto reload object_list
3. 增加异常处理 add try...except to pro_application.add_object(pro_object)
4. 增加API Add REST API
5. 增加Web界面 Add Web UI