创建您的第一个自定义芯片

自定义芯片是您自行编程的元件。您针对velxio-chip.h API编写纯C代码，Velxio在云端将其编译为WebAssembly，结果与任何目录中的元件一样：它有您可以接线的引脚、可以编辑的属性，以及在仿真中运行的逻辑。

何时构建一个

您需要的IC不在目录中（一个冷门的移位寄存器、专有传感器协议）。
您想要一个测试夹具——脉冲发生器、协议练习器、带有脚本化数值的假传感器。
您在教授数字逻辑，希望学生_实现_芯片，而不仅仅是使用它。

五分钟快速上手

打开元件选择器并将Custom Chip添加到画布上。
示例库打开——选择一个起点（或从空白开始）。
您会进入常规代码编辑器：芯片在文件资源管理器中拥有自己的部分，包含两个普通文件——
- chip.c — 行为；
- chip.json — 清单：名称、引脚、属性（输入时通过补全进行验证）。这是内置的Inverter示例：

#include "velxio-chip.h"
#include <stdlib.h>

typedef struct { vx_pin in, out; } chip_state_t;

static void on_in_change(void* ud, vx_pin pin, int value) {
  chip_state_t* s = ud;
  vx_pin_write(s->out, value ? VX_LOW : VX_HIGH);
}

void chip_setup(void) {
  chip_state_t* s = malloc(sizeof *s);
  s->in  = vx_pin_register("IN",  VX_INPUT);
  s->out = vx_pin_register("OUT", VX_OUTPUT);
  vx_pin_write(s->out, vx_pin_read(s->in) ? VX_LOW : VX_HIGH);
  vx_pin_watch(s->in, VX_EDGE_BOTH, on_in_change, s);
  vx_log("inverter ready");
}

及其清单：

{
  "schema": "velxio-chip/v1",
  "name": "Inverter",
  "pins": ["IN", "OUT", "GND", "VCC"],
  "attributes": []
}

将IN连接到按钮，将OUT连接到LED，然后按Run（运行）——每当芯片源代码更改时，芯片会自动编译（芯片文件资源管理器部分中的锤子按钮可以单独编译它，错误会像任何C编译器一样显示在输出控制台中）。
切换开关。在仿真停止时点击芯片以跳回其chip.c；编辑并再次运行。

为芯片赋予外观

默认情况下，芯片绘制为深色主体，名称印在丝印带上，引脚标签围绕边缘。您可以用自己的图形替换该外观——真实分线板的照片、数据手册图纸、图标：

点击芯片文件资源管理器部分中的image（图像）按钮（位于Compile旁边），选择不超过256 KB的PNG、JPEG或SVG。它会作为该芯片部分中的另一个文件加入chip.c和chip.json——chip.png、chip.jpg或chip.svg——因此它会随项目一起传输，导出到.vlx内部，并在您将芯片保存到My Chips时一并携带。

图像会缩放以适应芯片主体，绝不会裁剪或拉伸。引脚不会移动：它们的位置仍然来自chip.json，因此为已接线的芯片添加图形会使每条导线保持在原位置。引脚标签保持在图像上方，以白色绘制并带有深色轮廓，以便在浅色和深色图形上都能清晰阅读，而印刷名称则让位于图形（它保留在悬停提示中）。

要移除它，请使用图像按钮旁边的按钮，或从芯片部分删除图像文件。

芯片如何执行

主机为每个芯片实例调用一次chip_setup()。之后芯片是响应式的：您的代码仅在回调中运行——被监视的引脚发生变化、I2C字节到达、定时器触发。没有可阻塞的主循环，这正是自定义芯片足够轻量、可以在电路中大量使用的原因。

内置示例芯片

芯片编辑器附带可加载和修改的工作源码：逻辑门（反相器、异或门）、移位寄存器（74HC595、CD4094）、I2C元件（PCF8574、DS3231 RTC、24Cxx EEPROM）、SPI ADC（MCP3008）、UART ROT13转换器、脉冲计数器——以及一个复古CPU系列（Intel 4004及其同类）供真正敢于冒险的人使用。

下一步：芯片API参考。