IoT 系统连接 Odoo 的完整指南
IoT 系统连接 Odoo
前提条件
要将 IoT 系统连接到 Odoo 数据库，需要满足以下前提条件：
- 必须 安装
<general/install>的物联网（IoT）应用。 - IoT 系统必须已接入网络。
- 连接 Odoo 的设备必须与 IoT 系统在同一网络中。
:::: note ::: title 注意 :::
建议将 IoT 系统连接到 生产 实例，其他环境（例如 HTTPS 证书生成 <iot/https_certificate_iot/iot-eligibility>）可能导致问题。
::::
::: seealso
iot_box-windows_iot:::
连接
要将 IoT 系统连接到 Odoo 数据库，打开 IoT 应用并点击 Connect。
浏览器随后会扫描计算机所在网络，寻找可用的 IoT 系统。如果检测到 IoT 系统，会自动连接；如果发现多个系统，在弹出窗口中选择合适的系统后点击 Connect。若未自动检测到系统，可尝试使用 配对码 <iot/connect/pairing-code> 或 连接令牌 <iot/connect/token> 进行连接。
:::: tip ::: title 提示 :::
IoT 系统的名称由 IoT box <iot_box> 或 Windows computer <windows_iot> 的主板序列号组成，后面跟随其 配对码 <iot/connect/pairing-code>。
::::
使用配对码连接 {#iot/connect/pairing-code}
:::: note ::: title 注意 :::
- 配对码在 IoT 系统开机后有效期最长为 2 小时。若码失效，重启 IoT box 或
重启 Windows 虚拟 IoT 服务 <iot/windows_iot/restart>以显示新配对码。也可以改用连接令牌 <iot/connect/token>。 - 若 IoT 系统已连接到数据库（如测试库），配对码不会显示。必要时，请
从数据库断开 IoT 系统 <iot/connect/disconnect>。 ::::
获取 IoT 系统的配对码：
::::::: tabs ::::: group-tab IoT box
将 IoT box 连接到外部显示器或 USB 打印机。如果 IoT box 已预先插入，请
重启 <iot/iot-box/restart>。- 外部显示器：重启后配对码会显示在屏幕上。
- USB 打印机：配对码会自动打印。
:::: tip ::: title 提示 :::
若未连接外部显示器或打印机，可访问
IoT box 的主页 <iot/iot-box/homepage>，配对码显示在Pairing Code区域。 :::: :::::::: group-tab Windows 虚拟 IoT
在已安装 Windows 虚拟 IoT 的电脑上，打开浏览器访问
http://localhost:8069，进入 IoT 系统主页后滚动至Pairing Code区域。 ::: :::::::在 Odoo 中打开 IoT 应用并点击
Connect。在弹出的
Searching for an IoT Box窗口中，点击Use Pairing Code。输入
配对码并点击Connect。
使用连接令牌连接 {#iot/connect/token}
启用开发者模式 <developer-mode>。- 在 Odoo 中打开 IoT 应用并点击
Connect。 - 在弹出的
Searching for an IoT Box窗口中，点击Offline pairing。 - 在弹出的
Pair an IoT Box offline窗口中，复制Token。 - 访问
IoT box 的主页 <iot/iot-box/homepage>或Windows 虚拟 IoT 的主页 <iot/windows-iot/homepage>。 - 在
Odoo database connected区域点击Configure。 - 将令牌粘贴到
Server Token字段并点击Connect。
:::: note ::: title 注意 :::
IoT 系统连接到数据库后：
- 若已安装
POS 应用 </applications/sales/point_of_sale>，会弹出选择关联 POS 的窗口</applications/sales/point_of_sale/configuration/pos_iot>。 - 使用
IoT box <iot_box>时，请等待几分钟让其更新后再使用已连接的devices <devices>。 - IoT 系统会自动请求
HTTPS 证书 <iot/connect/https_certificate>，并在证书可用后将主页更新为以.odoo-iot.com结尾的 HTTPS URL。 ::::
::: seealso iot_advanced/troubleshooting :::
IoT 系统表单 {#iot/connect/IoT-form}
IoT 系统连接到 Odoo 数据库后，会以卡片形式显示在 IoT 应用中。点击该卡片即可打开 IoT 系统的表单，进而访问 IoT box 的主页 <iot/iot-box/homepage> 或 Windows 虚拟 IoT 的主页 <iot/windows-iot/homepage>，并查看已连接的 devices <devices> 列表。
:::: tip ::: title 提示 :::
启用 开发者模式 <developer-mode> 可查看 IoT 系统的 技术信息，包括 Domain Address、Image Version、SSL Certificate <iot/connect/https_certificate> 的 结束日期。默认情况下，驱动程序在每次 IoT 系统重启时会自动 更新 <iot_updating_iot/handlers>。若需关闭自动更新，取消勾选 Automatic drivers update 选项。
::::
从数据库断开 IoT 系统 {#iot/connect/disconnect}
要从数据库断开 IoT 系统，按以下步骤操作：
- 打开 IoT 应用并点击对应的 IoT 系统卡片。
- 点击
fa-cog（Actions）图标，选择Delete。
:::: tip ::: title 提示 :::
另一种方式：
- 访问
IoT box 的主页 <iot/iot-box/homepage>或Windows 虚拟 IoT 的主页 <iot/windows-iot/homepage>。 - 在
Odoo database connected区域点击Configure。 - 在弹出的窗口中点击
Disconnect。 ::::
HTTPS 证书 {#iot/connect/https_certificate}
HTTPS（超文本传输安全协议） 是 HTTP（超文本传输协议） 的加密安全版。它使用 TLS（传输层安全）（以前的 SSL（安全套接层））证书对服务器进行身份验证，并保护浏览器与网站之间的数据交换。某些网络设备（如支付终端）需要有效的 HTTPS 证书才能与 IoT 系统通信，若没有证书则无法正常交互。
:::: note ::: title 注意 :::
本文档以及 Odoo 中，HTTPS 证书 指的是能够建立 HTTPS 连接的有效 SSL 证书。 ::::
当 IoT 系统（重新）启动并连接到数据库时，会在满足以下条件的情况下自动下载 HTTPS 证书：
::: {#iot/https_certificate_iot/iot-eligibility}
- 数据库必须是 生产 实例，且不能是拷贝、复制、预发布或开发环境。
- Odoo 订阅必须处于进行中（
In Progress）状态。 :::
证书获取后：
- IoT 系统主页地址会更新为以
.odoo-iot.com结尾的 HTTPS URL。 HTTPS certificate横幅会显示证书的有效期。查看信息，请点击主页右上角的fa-cogs（cogs）按钮。
::: seealso iot/troubleshooting/https_certificate :::