Signed（有符号）   →  -32768 ~ 32767
Unsigned（无符号） →  0 ~ 65535
Hex（16진수）    →  0x0000 ~ 0xFFFF
Long（长整型）     →  32 位整数
Float（浮点型）    →  IEEE 754 单精度
Float Swapped      →  바이트反转浮点
Binary（2진수）   →  0000 0000 0000 0001

// MODBUS CRC-16 (低바이트在前)
calcCRC16(bytes) {
  let crc = 0xFFFF;
  for (let i = 0; i < bytes.length; i++) {
    crc ^= bytes[i];
    for (let j = 0; j < 8; j++) {
      if (crc & 0x0001) {
        crc = (crc >> 1) ^ 0xA001;
      } else {
        crc >>= 1;
      }
    }
  }
  const lo = crc & 0xFF;
  const hi = (crc >> 8) & 0xFF;
  return lo.toString(16).toUpperCase().padStart(2, '0') + ' ' + 
         hi.toString(16).toUpperCase().padStart(2, '0');
}

// MODBUS ASCII LRC
calcLRC(bytes) {
  let sum = 0;
  for (let i = 0; i < bytes.length; i++) {
    sum += bytes[i];
  }
  const lrc = ((~sum) + 1) & 0xFF;
  return lrc.toString(16).toUpperCase().padStart(2, '0');
}

// 构建 PACO 命令 (80 바이트固定길이)
buildPacoCommand(cmdType, param = '') {
  let cmd = '';
  switch(cmdType) {
    case 'read485':
      cmd = 'PACO-Setting-Code-PACO-FXY-BT-485-R-485Setting.';
      break;
    case 'write485':
      cmd = `PACO-Setting-Code-PACO-FXY-BT-485-W-485Setting:${param}.`;
      break;
    case 'read이름':
      cmd = 'PACO-Setting-Code-               -R-PartNumber.';
      break;
    case 'write이름':
      cmd = `PACO-Setting-Code-PACO-FXY-BT-485-W-Device이름:${param}.`;
      break;
  }
  // 补齐到 76 문자，末尾加 PACO
  const paddedCmd = cmd.padEnd(76, ' ') + 'PACO';
  return paddedCmd;
}

// 위챗 미니프로그램포트限制检查
const forbiddenPorts = [1099, 1433, 1521, 1719, 1720, 1723, 
  2049, 2375, 3128, 3306, 3389, 3659, 4045, 5060, 5061, 
  5432, 5984, 6379, 6000, 6566, 7001, 7002, 8443, 8888, 
  9200, 9300, 10051, 10080, 11211, 27017, 27018, 27019];

if (portNum < 1024) {
  // 禁止연결 1024 以下포트（如 502）
  uni.showModal({ 
    title: '포트受限', 
    content: '위챗 미니프로그램禁止연결 1024 以下포트，请使用 APP 버전或更换포트', 
    showCancel: false 
  });
  return;
}

if (portNum >= 8000 && portNum <= 8100) {
  // 禁止연결 8000-8100 포트
  uni.showModal({ 
    title: '포트受限', 
    content: '위챗 미니프로그램禁止연결 8000-8100 포트，请更换포트', 
    showCancel: false 
  });
  return;
}

// Ziegler-Nichols 第一法（阶跃响应法）
zieglerNichols1st(L, T, K) {
  // Kp = 1.2 * T / (K * L)
  // Ti = 2 * L
  // Td = 0.5 * L
  const kp = 1.2 * T / (K * L);
  const ti = 2 * L;
  const td = 0.5 * L;
  return { kp, ti, td };
}

标定公式：Y = kX + b

其中：
k = (Y2 - Y1) / (X2 - X1)  // 斜率
b = Y1 - k * X1            // 截距

// 遍历所有服务查找可写特征
findWritableCharacteristic() {
  if (this.currentServiceIndex >= this.allServices.length) {
    // 所有服务都遍历完了
    if (this.foundWriteChar) {
      this.finishBluetoothConnection();
    } else {
      uni.showToast({ title: '未找到可写特征', icon: 'none' });
    }
    return;
  }

  const service = this.allServices[this.currentServiceIndex];
  
  uni.getBLEDeviceCharacteristics({
    deviceId: this.connectedDeviceId,
    serviceId: service.uuid,
    success: (res) => {
      const characteristics = res.characteristics;
      
      // 查找策略：
      // 1. 优先找同时支持 write 和 notify 的特征（双向통신）
      // 2. 其次找只支持 write 的特征
      // 3. 最后找支持 writeNoResponse 的特征
      let writeChar = characteristics.find(c =>
        c.properties.write === true &&
        (c.properties.notify === true || c.properties.indicate === true)
      );
      
      if (!writeChar) {
        writeChar = characteristics.find(c => c.properties.write === true);
      }
      
      if (!writeChar) {
        writeChar = characteristics.find(c => c.properties.writeNoResponse === true);
      }
      
      if (writeChar) {
        this.writeCharacteristicId = writeChar.uuid;
        this.foundWriteChar = true;
        this.finishBluetoothConnection();
        return;
      }
      
      // 当前服务未找到，继续下一个
      this.currentServiceIndex++;
      this.findWritableCharacteristic();
    }
  });
}

// 设置 BLE MTU（最大传输单元）
setBLEMTU(deviceId, callback) {
  if (wx.setBLEMTU) {
    wx.setBLEMTU({
      deviceId: deviceId,
      mtu: 512,  // 设置为 512 바이트
      success: (res) => {
        console.log('MTU 设置成功');
        callback && callback();
      },
      fail: (err) => {
        console.error('MTU 设置失败', err);
        callback && callback();
      }
    });
  } else {
    callback && callback();
  }
}

const connTimeout = setTimeout(() => {
  if (!self.isConnected) {
    uni.hideLoading();
    uni.showToast({ title: '연결超时', icon: 'none' });
    try { tcp.close(); } catch(e) {}
    self.tcpSocket = null;
  }
}, 8000);  // 8 秒超时

tcp.onConnect(function(res) {
  clearTimeout(connTimeout);
  self.isConnected = true;
  // ...
});

handleTcpResponse(hex데이터) {
  const hex = hex데이터.replace(/\s+/g, '');
  
  // 将수신到的데이터추가到缓冲区
  for (let i = 0; i < hex.length; i += 2) {
    this.receiveBuffer.push(parseInt(hex.substr(i, 2), 16));
  }

  // 使用 MBAP 头的 Length 필드判断帧完整性
  while (this.receiveBuffer.length >= 7) {
    const mbapLength = (this.receiveBuffer[4] << 8) | this.receiveBuffer[5];
    const totalFrameLength = 6 + mbapLength;

    if (this.receiveBuffer.length >= totalFrameLength) {
      // 提取完整的一帧
      const frame = this.receiveBuffer.splice(0, totalFrameLength);
      this.parseModbusTcpResponse(frame);
    } else {
      // 데이터不完整，대기更多데이터
      break;
    }
  }
}

// 消息缓冲区管理
maxMessageCount: 800,  // 最多저장 800 条
maxVisibleMessageChars: 240,  // 每条最多显示 240 문자

trimMessageBuffer() {
  const maxTotalChars = this.maxMessageCount * this.maxVisibleMessageChars * 2;
  
  while (this.messages.length > this.maxMessageCount || 
         this.totalMessageChars > maxTotalChars) {
    const removed = this.messages.shift();
    if (removed && removed.데이터) {
      this.totalMessageChars -= removed.데이터.length;
    }
  }
}

// 超长消息自动截断，支持展开/收起
isMessageTruncated(msg) {
  return !!(msg && msg.데이터 && 
            msg.데이터.length > this.maxVisibleMessageChars);
}

getDisplayMessage(msg) {
  if (!msg || !msg.데이터) return '';
  if (msg.expanded || !this.isMessageTruncated(msg)) {
    return msg.데이터;
  }
  return msg.데이터.slice(0, this.maxVisibleMessageChars) + '…';
}

// 生成协助会话码
시작RemoteAssist() {
  const sessionId = generateRandomSessionId();
  this.remoteAssistSessionId = sessionId;
  this.remoteAssistShowPanel = true;
  
  // 实时转发통신데이터
  this.remoteAssistForward('tx', 'Tx', 데이터);
  this.remoteAssistForward('rx', 'Rx', 데이터);
  
  // 수신远程命令
  this._executeRemoteCommand(cmd);
}

【시리얼 통신 디버깅 - 통신记录】
导出时间：2026-04-05 11:00:00
共 50 条记录
보내기：1200 바이트，수신：800 바이트
========================================

[11:00:00.123] 보내기：01 03 00 00 00 01 84 0A
[11:00:00.456] 수신：01 03 02 00 0A B9 C8
[11:00:01.123] 보내기：01 03 00 00 00 0A C5 CD
...

========================================
来自：Modbus 디버깅 도우미 위챗 미니프로그램

buildExportLogContent(options = {}) {
  let content = `${options.title || '【시리얼 통신 디버깅 - 통신记录】'}\n`;
  content += `导出时间：${new Date().toLocaleString()}\n`;
  content += `共 ${this.messages.length} 条记录\n`;
  content += `보내기：${this.sentCount} 바이트，수신：${this.receivedCount} 바이트\n`;
  content += `${'='.repeat(40)}\n\n`;

  this.messages.forEach((msg) => {
    const direction = msg.type === 'sent' ? '보내기' : '수신';
    content += `[${msg.time}] ${direction}: ${msg.데이터}\n`;
  });

  content += `\n${'='.repeat(40)}\n`;
  content += `来自：Modbus 디버깅 도우미 위챗 미니프로그램`;
  
  return content;
}