server

type DeviceConfig struct {
	// DeviceID is the BACnet device instance (0..4194302). Zero is a valid
	// instance ID; it is NOT rewritten. Use DefaultDeviceConfig() or a nil
	// cfg to get the conventional demo default of 1000.
	// DeviceID 为 BACnet 设备实例号（0..4194302）。0 是合法实例，不会被静默改写。
	DeviceID     btypes.ObjectInstance
	DeviceName   string                     // BACnet device name
	VendorID     uint32                     // BACnet vendor identifier
	Interface    string                     // Network interface name (e.g., "eth0")
	Ip           string                     // IP address to bind to
	Port         int                        // BACnet port (default: 47808)
	SubnetCIDR   int                        // Subnet CIDR (e.g., 24 for /24)
	MaxPDU       uint16                     // Maximum PDU size (default: 1476)
	MaxSegments  uint                       // Maximum segments accepted (default: 0 = no segmentation)
	Segmentation segmentation.SegmentedType // Segmentation support (default: noSegmentation)
}

type ObjectStore struct {
	// contains filtered or unexported fields
}

type Server interface {
	// Serve starts the server message loop. This method blocks until the server is stopped.
	// It should be called in a goroutine for non-blocking operation.
	// Serve 启动服务端消息循环。此方法阻塞直到服务端停止。
	// 应在 goroutine 中调用以实现非阻塞操作。
	Serve() error

	// Close stops the server and releases all resources.
	// Close 停止服务端并释放所有资源。
	Close() error

	// IsRunning returns true if the server message loop is running.
	// IsRunning 返回服务端消息循环是否正在运行。
	IsRunning() bool

	// AddObject adds a new object to the server's object store.
	// AddObject 向服务端对象存储中添加新对象。
	AddObject(obj btypes.Object) error

	// RemoveObject removes an object from the server's object store.
	// RemoveObject 从服务端对象存储中移除对象。
	RemoveObject(objType btypes.ObjectType, instance btypes.ObjectInstance) error

	// GetObject retrieves an object by type and instance.
	// GetObject 按类型和实例检索对象。
	GetObject(objType btypes.ObjectType, instance btypes.ObjectInstance) (*btypes.Object, bool)

	// SetProperty sets a specific property value on an object.
	// SetProperty 设置对象上的特定属性值。
	SetProperty(objType btypes.ObjectType, instance btypes.ObjectInstance, propType btypes.PropertyType, data interface{}) error

	// GetProperty retrieves a specific property value from an object.
	// GetProperty 从对象中检索特定属性值。
	GetProperty(objType btypes.ObjectType, instance btypes.ObjectInstance, propType btypes.PropertyType) (interface{}, bool)

	// GetObjectStore returns the underlying object store for direct access.
	// GetObjectStore 返回底层对象存储以供直接访问。
	GetObjectStore() *ObjectStore

	// GetDeviceID returns the server's device instance ID.
	// GetDeviceID 返回服务端的设备实例 ID。
	GetDeviceID() btypes.ObjectInstance
}