config.py 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. """
  2. 系统配置文件
  3. 用于管理系统参数,如缓冲区大小、超时设置等
  4. """
  5. import os
  6. from dotenv import load_dotenv
  7. # 加载环境变量
  8. load_dotenv()
  9. # 缓冲区配置
  10. MAX_BUFFER_SIZE = 1000 # 数据缓冲区最大条目数
  11. SERIAL_READ_BUFFER_SIZE = 4096 # 串口读取缓冲区大小(字节)
  12. # 串口配置
  13. DEFAULT_BAUDRATE = 9600 # 默认波特率
  14. DEFAULT_SERIAL_TIMEOUT = 0.1 # 默认串口读超时时间(秒),轮询总线用短超时
  15. # 配线架总线串口:板载 TTL(UART) 转 RS485 模块,默认 /dev/ttyS8
  16. DEFAULT_SERIAL_PORT = os.getenv('DEFAULT_SERIAL_PORT') or '/dev/ttyS8'
  17. SERIAL_RECONNECT_INTERVAL = 5 # 串口重连间隔(秒)
  18. SERIAL_RECONNECT_MAX_RETRIES = 5 # 串口最大重连次数
  19. # 串口指令统一发送节拍(秒):所有 0x80 保活 / 0x03 读卡 / 0x10 写卡 / 配置地址帧
  20. # 都经同一个发送队列,按「发送起点」固定间隔逐条发出,避免同台线架保活帧与读卡帧背靠背。
  21. # 注意 9600bps 下读卡(149B)/写卡(152B)单帧约 155ms,此值必须大于单帧耗时,默认 0.20s。
  22. SERIAL_CMD_INTERVAL = float(os.getenv('SERIAL_CMD_INTERVAL', '0.20'))
  23. # RS485 方向控制 GPIO(可选)。格式 "gpiochip0:25" 或 "gpiochip0:25:low"(low = 低电平为发送态)。
  24. # 用于板载 TTL 转 RS485 模块自动方向切换不可靠(发完立刻收不到回包)的场景,
  25. # 把模块的 DE/RE 接到该 GPIO,由软件在发送前拉 TX、发送完成后切回 RX。
  26. SERIAL_RS485_DIR_GPIO = (os.getenv('SERIAL_RS485_DIR_GPIO') or '').strip()
  27. SERIAL_RS485_DIR_PRE_DELAY = float(os.getenv('SERIAL_RS485_DIR_PRE_DELAY', '0.001')) # 切到发送态后等待(秒)
  28. SERIAL_RS485_DIR_POST_DELAY = float(os.getenv('SERIAL_RS485_DIR_POST_DELAY', '0.001')) # 发送完成后等待再切回接收(秒)
  29. # MQTT配置
  30. DEFAULT_MQTT_PORT = 1883 # 默认MQTT端口
  31. DEFAULT_MQTT_TLS_PORT = 8883 # 默认MQTT TLS端口
  32. DEFAULT_MQTT_KEEPALIVE = 60 # 默认MQTT心跳时间(秒)
  33. MQTT_RECONNECT_INTERVAL = 5 # MQTT重连间隔(秒)
  34. MQTT_RECONNECT_MAX_RETRIES = 5 # MQTT最大重连次数
  35. DEFAULT_MQTT_CLIENT_ID_PREFIX = "serial_mqtt_gateway_" # 默认MQTT客户端ID前缀
  36. DEFAULT_MQTT_PUBLISH_TOPIC = "serial/data" # 默认MQTT发布主题
  37. DEFAULT_MQTT_SUBSCRIBE_TOPIC = "command/serial" # 默认MQTT订阅主题
  38. # WebSocket配置
  39. SOCKETIO_ASYNC_MODE = 'threading' # SocketIO异步模式
  40. SOCKETIO_MESSAGE_QUEUE = None # SocketIO消息队列,生产环境可配置Redis
  41. SOCKETIO_TRANSPORTS = ['websocket', 'polling'] # SocketIO传输方式
  42. SOCKETIO_ALLOWED_ORIGINS = '*' # SocketIO允许的来源
  43. # Flask配置
  44. FLASK_SECRET_KEY = os.getenv('FLASK_SECRET_KEY', 'serial_mqtt_gateway_secret_key')
  45. FLASK_DEBUG = os.getenv('FLASK_DEBUG', 'False').lower() == 'true'
  46. FLASK_HOST = os.getenv('FLASK_HOST', '0.0.0.0')
  47. FLASK_PORT = int(os.getenv('FLASK_PORT', '5001'))
  48. # 日志配置
  49. LOG_LEVEL = os.getenv('LOG_LEVEL', 'INFO')
  50. LOG_FORMAT = '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
  51. LOG_FILE = os.getenv('LOG_FILE', None) # 如果设置了值,则将日志写入文件
  52. # 性能配置
  53. MAX_CONCURRENT_SOCKETIO_CLIENTS = 100 # 最大并发SocketIO客户端数
  54. SOCKETIO_HEARTBEAT_INTERVAL = 25 # SocketIO心跳间隔(秒)
  55. SOCKETIO_HEARTBEAT_TIMEOUT = 30 # SocketIO心跳超时(秒)
  56. # 转发配置
  57. DEFAULT_FORWARD_SERIAL_TO_MQTT = False # 默认是否启用串口到MQTT转发
  58. DEFAULT_FORWARD_MQTT_TO_SERIAL = False # 默认是否启用MQTT到串口转发
  59. # 主题配置
  60. SOCKETIO_NAMESPACE_DATA = '/data' # 数据命名空间
  61. SOCKETIO_NAMESPACE_STATUS = '/status' # 状态命名空间
  62. SOCKETIO_NAMESPACE_CONTROL = '/control' # 控制命名空间
  63. # API路径配置
  64. API_PREFIX = '/api'
  65. API_SERIAL_PREFIX = f'{API_PREFIX}/serial'
  66. API_MQTT_PREFIX = f'{API_PREFIX}/mqtt'
  67. API_DATA_PREFIX = f'{API_PREFIX}/data'
  68. API_FORWARD_PREFIX = f'{API_PREFIX}/forward'
  69. API_HEALTH = f'{API_PREFIX}/health'
  70. # 错误码定义
  71. ERROR_CODES = {
  72. 'SUCCESS': 0,
  73. 'SERIAL_CONNECTION_ERROR': 1001,
  74. 'SERIAL_SEND_ERROR': 1002,
  75. 'SERIAL_RECEIVE_ERROR': 1003,
  76. 'MQTT_CONNECTION_ERROR': 2001,
  77. 'MQTT_PUBLISH_ERROR': 2002,
  78. 'MQTT_SUBSCRIBE_ERROR': 2003,
  79. 'CONFIG_ERROR': 3001,
  80. 'NETWORK_ERROR': 4001,
  81. 'UNKNOWN_ERROR': 9999
  82. }
  83. # 错误消息定义
  84. ERROR_MESSAGES = {
  85. ERROR_CODES['SUCCESS']: '成功',
  86. ERROR_CODES['SERIAL_CONNECTION_ERROR']: '串口连接失败',
  87. ERROR_CODES['SERIAL_SEND_ERROR']: '串口发送数据失败',
  88. ERROR_CODES['SERIAL_RECEIVE_ERROR']: '串口接收数据失败',
  89. ERROR_CODES['MQTT_CONNECTION_ERROR']: 'MQTT连接失败',
  90. ERROR_CODES['MQTT_PUBLISH_ERROR']: 'MQTT发布消息失败',
  91. ERROR_CODES['MQTT_SUBSCRIBE_ERROR']: 'MQTT订阅主题失败',
  92. ERROR_CODES['CONFIG_ERROR']: '配置错误',
  93. ERROR_CODES['NETWORK_ERROR']: '网络错误',
  94. ERROR_CODES['UNKNOWN_ERROR']: '未知错误'
  95. }
  96. # DTU配置
  97. DEFAULT_CUSTOMER_ID = os.getenv('CUSTOMER_ID', 'default_customer')
  98. DEFAULT_DTU_ID = os.getenv('DTU_ID', 'dtu_001')
  99. DTU_HEARTBEAT_INTERVAL = 60 # DTU状态上报间隔(秒) - 协议 7.13 要求
  100. DTU_OFFLINE_TIMEOUT = 180 # DTU 离线判定超时(秒) - 协议 7.13 要求
  101. # MQTT主题前缀(可配置 - 通过web界面设置)
  102. DEFAULT_MQTT_TOPIC_PREFIX = os.getenv('MQTT_TOPIC_PREFIX', '线架系统')
  103. # DTU MQTT主题模板(运行时根据topic_prefix动态生成)
  104. # 格式: {topic_prefix}/{customer_id}/dtu/{dtu_id}/{topic}
  105. DTU_REGISTRATION_TOPIC = 'register'
  106. DTU_STATUS_TOPIC = 'status'
  107. DTU_CONTROL_TOPIC = 'control'
  108. DTU_RESPONSE_TOPIC = 'response'
  109. DTU_EVENT_TOPIC = 'event'
  110. DTU_ALARM_TOPIC = 'alarm'
  111. DTU_BROADCAST_TOPIC = 'broadcast'
  112. # 面板配置
  113. MAX_PANELS = 8 # 最大面板数
  114. MAX_PORTS_PER_PANEL = 24 # 每个面板最大端口数
  115. # 线架地址段轮询 / UID 绑定(80/81 口径,仅 80 请求/81 应答,82/83 已废弃)
  116. DEFAULT_ADDRESS_RANGE = {'start': 1, 'end': 50} # 默认轮询地址段
  117. PANEL_KEEPALIVE_MISS_LIMIT = 2 # 连续 2 次收不到匹配 81 即判离线,并停止该机 0x03 读卡
  118. # 兼容现网固件:部分线架对「带绑定 UID 的 0x80 点名」不回 81,但 0x03 读卡正常。
  119. # 开启后,81 连续缺失即将判离线 / 已离线等待恢复时,先补发一次 0x03 读卡探测:
  120. # 读卡成功 -> 判在线并清零保活计数(兼容救活);读卡也失败 -> 才判/维持离线。
  121. # 将来线架固件支持点名 81 后,置 False 即回到纯图解严格口径(在线完全由 80/81 决定)。
  122. PANEL_READ_FALLBACK_KEEPALIVE = os.getenv(
  123. 'PANEL_READ_FALLBACK_KEEPALIVE', 'true').lower() in ('1', 'true', 'yes')
  124. PANEL_PROBE_TIMEOUT = 0.3 # 未绑定地址全 0 探测超时(秒)
  125. PANEL_QUERY_TIMEOUT = 0.5 # 已绑定地址带 UID 的 0x80 保活查询超时(秒)
  126. PANEL_READ_TIMEOUT = 1.0 # 批量读卡 0x03 超时(秒,仅在线机执行)
  127. PANEL_CONFIG_ADDRESS_TIMEOUT = 60 # 配置地址状态等待刷配置卡的超时(秒),超时后自动退出
  128. # DHT11 环境传感器配置(本地 GPIO 读取)
  129. DHT11_ENABLED = os.getenv('DHT11_ENABLED', 'true').lower() in ('1', 'true', 'yes')
  130. DHT11_GPIO_PIN = int(os.getenv('DHT11_GPIO_PIN')) if os.getenv('DHT11_GPIO_PIN') else None
  131. DHT11_GPIO_CHIP = os.getenv('DHT11_GPIO_CHIP', 'gpiochip0')
  132. DHT11_POLL_INTERVAL = int(os.getenv('DHT11_POLL_INTERVAL', '5'))
  133. DHT11_SIMULATE = os.getenv('DHT11_SIMULATE', 'false').lower() in ('1', 'true', 'yes')
  134. DHT11_MAX_HISTORY = 1000 # 保留最近 1000 条历史记录
  135. # Nextion 串口屏配置(默认接 /dev/ttyS9)
  136. NEXTION_ENABLED = os.getenv('NEXTION_ENABLED', 'true').lower() in ('1', 'true', 'yes')
  137. DEFAULT_NEXTION_SCREEN_PORT = '/dev/ttyS9' # 串口屏默认端口
  138. NEXTION_SCREEN_PORT = os.getenv('NEXTION_SCREEN_PORT') or DEFAULT_NEXTION_SCREEN_PORT
  139. NEXTION_SCREEN_BAUD = int(os.getenv('NEXTION_SCREEN_BAUD', '9600'))
  140. NEXTION_PANEL_NAME_PREFIX = os.getenv('NEXTION_PANEL_NAME_PREFIX', '终端')
  141. NEXTION_CMD_DELAY_MS = int(os.getenv('NEXTION_CMD_DELAY_MS', '25'))