介绍
Moku 云编译 (MCC) 是 Liquid Instruments Moku 产品的一项功能，允许用户在 Moku 设备内运行自定义逻辑。 创建此自定义逻辑的基本工作流程是：
- 登录 MCC Web IDE 并创建项目
- 编写您的 HDL 逻辑，从转换器工具上传逻辑或加载示例
- 构建设计
- 将设计部署到您的 Moku。
所有 Moku Cloud Compile 模块都只是 VHDL 实体，它们提供了 自定义包装器 实体。 CustomWrapper 定义了信号输入端口、信号输出端口和控制寄存器，并由 Liquid Instruments 预定义。 以下代码段显示前两个输出由前两个输入的和和差驱动。 在典型配置中，输入端口可能是来自 ADC 或其他仪器的数字化信号； 输出可以连接到其他仪器或直接连接到 DAC。 有关更多示例，请参阅 示例页面 or 示例存储库.
输入和输出具有不同的比例，具体取决于硬件配置和信号源。 有关如何使用 CustomWrapper 的输入和输出的详细信息，请参阅 MCC 文档.
一旦你有了这样的实体，你需要将它部署到你的 Moku。 本指南将向您展示如何操作。
MCC 测试版
MCC 目前处于开放测试阶段。 随着产品接近完整版本，以下工作流程将发生变化。 如果您在本文档中发现任何不一致之处，请确保您的 Moku 应用程序（桌面和/或 iPad）是最新的，然后联系 support@liquidinstruments.com.
查找文档
有关最新文档，请参阅 Moku Cloud 编译文档站点或在登录后单击基于 Web 的 IDE 屏幕左下方的帮助按钮。
登录莫库云编译
Moku Cloud Compile 使用基于 Web 的集成开发环境 (IDE)，您可以在其中编写代码并构建设计。 打开页面 https://compile.liquidinstruments.com.
如果这是您第一次访问，请注册一个帐户或立即使用 Google 帐户登录。 如果您已经创建了用户名和密码，请在登录屏幕上输入它们。
在公测期间免费注册。
Moku Cloud 编译登录屏幕
编写你的第一个设计
建立专案
IDE 向您显示的第一个屏幕是“项目”屏幕。 使用右上角的按钮创建一个新项目。
编写代码
从左侧的文件选项卡创建一个新文件并输入文件名。 您的代码可以在右侧的编辑器窗格中编写。 例如，输入上面介绍的简单示例代码后，您的 IDE 屏幕可能如下所示：
建筑物
要构建您的设计，您必须针对特定设备。 设备是硬件（例如 Moku:Pro 或 Moku:Go）和固件（例如版本 568）的组合。 此外，选择适当数量的插槽，Moku:Pro 为 4，Moku:Go 为 2
查找您的固件版本
在桌面应用程序上，右键单击您的 Moku，选择 Device Info 并记下固件版本。 在 iPad 上，您可以通过长按设备来查看此信息。
在 Moku 应用程序的设备信息屏幕中查找您的固件版本
创建或更新您的设备
在设备屏幕上，添加新设备或编辑现有设备。 硬件和固件版本必须与 Moku 上的完全匹配。
固件不匹配
尝试将 MCC 设计部署在固件版本与其构建版本不同的 Moku 上可能会导致 Moku 挂起，需要重启电源。
构建您的设计
在您的 MCC 项目中：
- 在目标下拉列表中选择您新创建的设备
- 构建你的项目
- 展开日志面板以查看进度。 当所有指示灯为绿色时，单击
bitstream.tar.gz下载构建工件以部署到您的 Moku
构建时间取决于硬件平台和项目复杂性。 Moku:Go 上的一个简单项目将在 3-5 分钟内构建，而 Moku:Pro 设计可能需要长达半小时。
部署
下载您的构建后，下一步是将设计上传到您的 Moku。 最简单的方法是使用 Moku 的内置 Web 界面。
查找您的 IP 地址
Moku 设备的 IP 地址与其固件版本位于同一屏幕上，请参见上文。
在 Moku 应用程序的设备信息屏幕中找到您的 Moku 的 IP 地址
在Moku Web界面上传
在浏览器中导航到该 IP 地址。 例如，如果您发现 Moku 设备的 IP 是 10.1.111.11 然后访问 http://10.1.111.11.
- 选择
Registers在右上角。 您的屏幕可能会有所不同，具体取决于您 Moku 上当前运行的内容。 - 在上传比特流框中上传您的 MCC 设计文件。
IPv6
请注意，此步骤需要您在浏览器中访问 Moku 的控制界面。 现代浏览器的限制意味着，如果您使用 IPv6“本地链接”地址（例如通过 USB 连接到 Moku），这是不可能的。 有关更多信息和可能的解决方案，请参阅 API 文档
以多仪器模式部署
现在将您的设计放在您的 Moku 上，只要您将“云编译”仪器放入多仪器模式 (MiM) 的插槽中，您的设计就会被部署。 使用 MiM 配置屏幕将您的设计与可能需要的任何其他仪器一起部署。 您还可以使用此屏幕配置 MCC 设计与其他仪器和/或 Moku 上的物理 BNC 连接器之间的路由。
- 将至少一个 Cloud Compile 仪器添加到您的 MiM 配置中
- 应用设置以开始您的设计运行
应用 MiM 配置后，您可以通过单击部署的 Cloud Compile 仪器来编辑设计的控制寄存器。 有关详细信息，请参阅 控制寄存器.
Moku Cloud Compile 设计在多仪器模式下使用 System Builder 进行部署
与其他仪器结合
Moku Cloud Compile 以多仪器模式部署，因此您可以访问所有 Moku 仪器来激发、查看和表征您的 MCC 设计。 例如，上面使用的“和和差”示例可以通过结合波形发生器和示波器进行测试。 左侧的配置还具有路由到 DAC 的波形发生器信号和和差信号。 右侧的示波器图像显示了 1Vpp 正弦波和 100mVpp 斜波的和和差结果。
用于 MCC 计算输入信号的和和差的 MiM 配置（左）。 信号由波形发生器生成，结果显示在示波器上（右）
下一步
Moku Cloud Compile 从多仪器模式部署，因此可以与其他仪器（包括波形发生器、示波器和频谱分析仪）结合使用，以帮助您激发和表征您的设计。 有关多乐器模式的更多信息，请访问 液体仪器网站. Moku Cloud Compile 的更多文档可在其 文档站点，还有更多示例（包括下面显示的“平方根”示例）可以在我们的完整源代码中找到 示例存储库.
与 Moku 云编译设计一起部署的示波器的屏幕截图。 此设计取自“平方根”示例，输入信号为蓝色，该值的平方根实时计算、输出并以红色显示。
