config.py 7.5 KB

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