如何在Sigrok PulseView中安装社区支持的Futaba SBus协议解码器？

确认正确的安装路径 #

PulseView不会识别随意放置的解码器文件，必须放到指定的用户自定义解码器目录：

• Linux：~/.local/share/libsigrokdecode/decoders/
• Windows：C:\Users\<你的用户名>\AppData\Roaming\libsigrokdecode\decoders\
• macOS：~/Library/Application Support/libsigrokdecode/decoders/

每个解码器需要单独建一个文件夹，文件夹名称必须和解码器脚本里定义的id一致（比如SBus解码器的脚本里id是sbus，那文件夹就得命名为sbus），把解码器的.py文件直接放在这个文件夹里，不要嵌套多层目录。

验证解码器脚本的合法性 #

打开你的SBus解码器.py文件，检查核心定义是否完整：
必须包含继承自sigrokdecode.Decoder的类，且类内有必填属性，示例如下：

class Decoder(sigrokdecode.Decoder):
    id = 'sbus'
    name = 'SBus'
    longname = 'Futaba SBus'
    desc = 'Futaba SBus serial protocol.'
    license = 'gplv2+'
    inputs = ['uart']
    outputs = ['sbus']
    # 其他必要的选项、输出格式定义

如果缺少这些关键属性，PulseView会直接忽略这个解码器。

重启软件并检查 #

复制完成后完全关闭PulseView再重新打开，不要仅刷新窗口。重新启动后，在解码器列表中搜索sbus或SBus，或者在堆叠解码器的选项中查找。

排查常见问题 #

• 不要将解码器放到系统默认的解码器目录（如/usr/share/libsigrokdecode/decoders/），这类目录需要管理员权限，且更新软件时可能被覆盖，优先使用用户目录。
• 检查脚本语法：用Python直接运行解码器脚本（python3 /path/to/sbus/decoder.py），如果有报错，先修复语法问题再重新放置。
• Linux/macOS下确保权限：执行chmod -R 755 ~/.local/share/libsigrokdecode/decoders/sbus/，保证文件有可读权限。

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