{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/markchadwick/hpcs330/blob/8e5699029d66f12d3a898832bd6892f7a4a5a16e/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "hpcs330 implements a Python reader for the Hopoo HPCS-330 spectrometer using a USB serial protocol recovered from the vendor's Windows application. The protocol notes describe framing and measurement commands; the client retrieves spectral samples and the meter's computed light measurements.",
  "description_zh": "hpcs330 根据原厂 Windows 程序还原的 USB 串口协议，实现了 Hopoo HPCS-330 光谱仪的 Python 读取程序。协议文档记录消息格式和测量命令，客户端可读取光谱样本及仪器计算的照明指标。",
  "entry_url": "https://awesomerea.org/resources/hpcs330-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/hpcs330-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/markchadwick/hpcs330/blob/8e5699029d66f12d3a898832bd6892f7a4a5a16e/docs/protocol.md",
  "group": "cases",
  "id": "hpcs330-case",
  "json_url": "https://awesomerea.org/resources/hpcs330-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/hpcs330-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/hpcs330-case/index.md",
  "name": "hpcs330: reconstructing the Hopoo spectrometer serial protocol",
  "name_zh": "hpcs330：重建 Hopoo 光谱仪串口协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.10 or later and pyserial 3.4 or later.",
    "A Hopoo HPCS-330P in USB COM mode; this is the model the author reports testing.",
    "Other HPCS-330 variants and HPCS-310/320 models are unconfirmed; some computed values have not been checked against the screen.",
    "MIT License."
  ],
  "requirements_zh": [
    "需要 Python 3.10 或更新版本，以及 pyserial 3.4 或更新版本。",
    "需要设为 USB COM 模式的 Hopoo HPCS-330P；作者报告仅测试了该型号。",
    "其他 HPCS-330 型号及 HPCS-310/320 尚未确认，部分计算值也尚未与仪器屏幕核对。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/markchadwick/hpcs330",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}
