BrenekH/yamaha-rcp-docs 开源项目中文解读：技术栈、适用场景与上手建议

项目介绍

BrenekH/yamaha-rcp-docs 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，目前获得 46 个 Star、1 次 Fork。

仓库全名: BrenekH/yamaha-rcp-docs

README 摘要

Yamaha Remote Control Protocol (RCP) Unofficial documentation for Yamaha's mixer control protocol with an emphasis on the TF Series of mixers. The concepts in this documentation do apply to some of Yamaha's other mixers (notably the QL, CL, Rivage, and DM3 series), but since I only have access to a TF console, that's what this documentation is most relevant to. Note: This is a big work in progress. If you want to…

完整内容见 GitHub 原始 README 或本页。

常见问题

yamaha-rcp-docs 用什么语言开发？

主要使用 Python 编写，目前有 46 个 Star。

如何获取 yamaha-rcp-docs 的源码？

可以直接克隆仓库：git clone https://github.com/BrenekH/yamaha-rcp-docs.git，默认分支为 master；安装与运行步骤见仓库 README。

yamaha-rcp-docs 最近还在维护吗？

仓库最近一次更新为 2024年3月21日，当前没有未关闭的 Issue；Star 数为 46，可作为社区活跃度的参考。

关于

Unofficial documentation for Yamaha's mixer control protocol

documentation proaudio remote-control reverse-engineering unofficial yamaha yamaha-mixer yamaha-tf yamaha-tf1 yamaha-tf3 yamaha-tf5

46 Stars
1 Forks
4 Watching

描述取自 GitHub 官方 API，中文内容由 GitRead 中文社区编辑团队整理。

简要分析

热度分

价值分

活跃状态

活跃

GitHub

语言占比

Python

贡献者

BrenekH

Yamaha Remote Control Protocol (RCP)

Unofficial documentation for Yamaha’s mixer control protocol with an emphasis on the TF Series of mixers. The concepts in this documentation do apply to some of Yamaha’s other mixers (notably the QL, CL, Rivage, and DM3 series), but since I only have access to a TF console, that’s what this documentation is most relevant to.

Note: This is a big work in progress. If you want to help out, feel free to open up a Discussion, Issue, or Pull Request.

Official Sources

Python Script Template - Simple Python scripts and PDFs that are light on details
MTX3, MTX5-D, MRX7-D, XMV Series, EXi8, EXo8 RCP Spec V4.0.0 - Yamaha docs on the protocol for their multi-zone commercial mixing system (thanks @morydd)
RIVAGE PM Series OSC Specifications V1.0.2 - Documentation for using Open Sound Control (OSC) on Rivage PM consoles (thanks @snurrgnu)
DM3 Series OSC Specifications V1.0.0 - Documentation for using Open Sound Control (OSC) on DM3 consoles (thanks @hansSchall)

Basics

Yamaha uses a simple TCP connection to transfer all of the data between the client and the mixer. The data is split into messages that are delimited by a newline character (\n). Each message starts with one of the following command keywords:

Client to Mixer:

get - Request a value from the mixer
set - Set a value on the mixer
ssrecall_ex - Recall a scene to the mixer

Mixer to Client:

OK - Indicates that the client’s request was accepted
OKm - The difference between this keyword and OK is likely to be an indication of a modified value, but this has not yet been confirmed
NOTIFY - Unsolicited message from the mixer indicating a change was made outside of the current connection
ERROR - Indicates an error with the client’s request

Data Types

Strings
- Represented by a variable length of characters surrounded by quotation marks (")
Decibels
- Represented by an integer where the dB value has been multiplied by 100 (10 dB -> 1000)
- Max Fader Value: 1000
- Min Fader Value: -13800
- Negative Infinity Value: -32768
Booleans
- Represented by either a 0 or 1, 0 for false and 1 for true

Getting and Setting Values

Getting and setting simple values uses essentially the same syntax. The only difference is really that a get command doesn’t contain a value on the end while set does.

Here’s some basic examples:

Channel 1 Fader Values:
- get MIXER:Current/InCh/Fader/Level 0 0
- set MIXER:Current/InCh/Fader/Level 0 0 1000
Channel 16 Fader Label:
- get MIXER:Current/InCh/Fader/Name 15 0
- set MIXER:Current/InCh/Fader/Name 15 0 "My Label"

List of Command Paths

Credits

Yamaha - For making a great mixer. Not for properly documenting it’s API.
bitfocus/companion-module-yamaha-rcp - For compiling a list of commands available

暂无评论

yamaha-rcp-docs