SmartUSBHub 文档中心
======================

拿到设备后，先确认产品并阅读使用指南完成接线，然后选择图形化软件或 Python
Demo 完成第一次控制。

.. grid:: 1 1 3 3
   :gutter: 2

   .. grid-item-card:: 选择产品并完成接线
      :link: products/index
      :link-type: doc
      :class-card: docs-step-card docs-home-card

      .. image:: ../source/_static/icon-product.svg
         :alt: 产品使用指南
         :class: docs-card-icon

      对照产品图片和机身标签，打开对应使用指南，先确认接口、供电要求和安全事项。

   .. grid-item-card:: 用软件直接控制
      :link: software/control-pannel
      :link-type: doc
      :class-card: docs-step-card docs-home-card

      .. image:: ../source/_static/icon-desktop-control.svg
         :alt: 桌面软件控制
         :class: docs-card-icon

      安装 Control Pannel，通过图形界面直接打开或关闭每个 USB 端口。

   .. grid-item-card:: 运行 Python Demo
      :link: quickstart
      :link-type: doc
      :class-card: docs-step-card docs-home-card

      .. image:: ../source/_static/icon-python-demo.svg
         :alt: Python Demo
         :class: docs-card-icon

      安装 Python SDK，运行一个简单 Demo，完成第一个端口控制操作。

桌面软件
--------

.. grid:: 1 1 2 2
   :gutter: 2

   .. grid-item-card:: Control Pannel
      :link: software/control-pannel
      :link-type: doc
      :class-card: docs-home-card

      .. image:: ../source/_static/icon-control-pannel.svg
         :alt: Control Pannel
         :class: docs-card-icon

      轻量图形化控制：端口开关、状态查看、工作模式设置和固件更新。

   .. grid-item-card:: Studio Pro
      :link: software/studio-pro
      :link-type: doc
      :class-card: docs-home-card

      .. image:: ../source/_static/icon-studio-pro.svg
         :alt: Studio Pro
         :class: docs-card-icon

      专业控制台：电源和数据线控制与多设备管理；支持测量的型号还可查看实时波形并记录数据。

Python 开发与参考
-----------------

.. grid:: 1 1 2 2
   :gutter: 2

   .. grid-item-card:: Python SDK 使用指南
      :link: software/python-library
      :link-type: doc
      :class-card: docs-home-card

      .. image:: ../source/_static/icon-python-sdk.svg
         :alt: Python SDK
         :class: docs-card-icon

      了解设备发现、电源和数据线控制、测量、多设备控制及其他完整功能。

   .. grid-item-card:: 示例程序
      :link: software/examples
      :link-type: doc
      :class-card: docs-home-card

      .. image:: ../source/_static/icon-examples.svg
         :alt: 示例程序
         :class: docs-card-icon

      从可直接运行的示例开始，完成端口循环、数据线切换、测量和多设备控制。

   .. grid-item-card:: Python API 参考
      :link: api/python
      :link-type: doc
      :class-card: docs-home-card

      .. image:: ../source/_static/icon-api-reference.svg
         :alt: API 参考
         :class: docs-card-icon

      按类、方法和参数查找精确接口定义。

   .. grid-item-card:: GitHub ↗
      :link: https://github.com/mixedsignal-labs/smartusbhub
      :link-type: url
      :class-card: docs-home-card

      .. image:: ../source/_static/github-mark.svg
         :alt: GitHub
         :class: docs-card-icon

      查看 SmartUSBHub 开源仓库、SDK 源码、示例程序和最新版本。

.. toctree::
   :maxdepth: 1
   :caption: 开始使用
   :hidden:

   self
   products/index
   software/index