config.py 7.3 KB

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