Windows环境Notebook中创建Saleae对象报连接被拒错误咨询

问题根因 #

该错误触发逻辑是saleae库通过socket连接本地Logic软件API服务时，目标端口无对应服务监听，被Windows系统直接拒绝连接，首次使用时基本都是配置缺失、自动拉起失败导致，按以下步骤逐一排查即可解决：

• 优先手动启动Saleae Logic客户端，不要依赖库自动拉起
  库内置的自动启动Logic软件逻辑依赖默认安装路径、系统注册表配置，自定义安装路径、权限不足都会导致静默拉起失败，没有明确报错。操作流程：
  1. 从开始菜单/桌面快捷方式手动启动安装好的Saleae Logic软件，等待完全加载进入主操作界面
  2. 回到Notebook环境重新运行初始化代码，验证连接是否恢复正常
• 手动开启Logic软件的Socket API权限
  首次安装的Saleae Logic默认关闭脚本调用的API接口，手动启动软件后仍无法连接时按以下路径配置：
  1. 点击Logic软件顶部菜单栏，打开选项 -> 开发者选项（英文版本路径为Options -> Developer）
  2. 勾选启用Socket API选项，确认端口号保持默认值10429，不要随意修改
  3. 保存配置后重启Logic软件，再次运行代码测试连接
• 排查端口监听与拦截问题
  完成前两步仍报错时，检查网络层拦截、端口占用问题：
  1. 打开Windows命令提示符，执行命令netstat -ano | findstr "10429"，确认输出结果中存在状态为LISTENING的条目，对应进程为Saleae Logic主进程
  2. 如果没有对应监听条目，检查系统防火墙、第三方安全软件是否拦截了Logic软件的端口监听行为，可临时关闭防火墙测试，或给Logic软件添加防火墙放行规则
  3. 如果10429端口被其他程序占用，要么关闭占用端口的无关程序，要么在Logic开发者选项中修改API服务端口，初始化Saleae对象时传入自定义端口参数，示例代码：

     from saleae import Saleae
     # 示例：自定义API端口为10430时的初始化写法
     s = Saleae(port=10430)
     

• 校验版本匹配关系
  确认本地安装的saleaePython库版本和Saleae Logic软件版本适配：旧版saleae Python库不支持Logic 2.x系列版本的API接口，版本不匹配时会出现连接握手失败、端口无响应的问题，卸载当前Python库后安装对应适配版本即可。

内容的提问来源于stack exchange，提问作者Guy fomen