Storage Link — 快速指南¶

Storage Link 是一個 ESP32 模組，它將可尋址 LED 燈條轉換為絲材線軸倉庫指示器，並可選擇性地從 SHT31 感測器發佈溫度和濕度。

連接到 Wi-Fi 並將裝置與 portal.idryer.org 綁定。
根據雲端或本機應用程式的指令，在指定時間內以指定顏色點亮線軸插槽。
安裝 SHT31 感測器時，發佈溫度和濕度。

倉庫和線軸的知識存在於外部應用程式中。韌體作為簡單的執行模組運作：「在 T 秒內以顏色 C 點亮插槽 N」。這允許您將燈條粘貼到任何架子上，並在入口中描述它，而不受韌體限制。

支援的開發板¶

開發板
ESP32-C3 DevKitM-1	`✅`
ESP32-C3 Super Mini	`✅`
Seeed XIAO ESP32-S3	`✅`
Waveshare ESP32-S3-Zero	`✅`

任何基於 ESP32-C3 或 ESP32-S3 的其他開發板，如果有用於燈條資料的空閒 GPIO 和一對用於 I2C 的 GPIO，都可以使用。請參考製造商的腳位圖。

接線圖¶

絕不要在供電的情況下連接或斷開導線。

Storage Link 通過一個信號 GPIO（DATA）控制燈條，並可選擇性地通過 I2C 讀取 SHT31。

燈條供電¶

燈條和 ESP 應由與燈條實際負載相匹配的電源供電。

在許多 ESP 開發板上，5V（VBUS）引腳直接從 USB 連接器輸出。如果使用的 USB 電源能夠提供足夠的電流來應對燈條的負載，則可以並聯從它給 ESP 和燈條供電。
如果電流不足——燈條供電應由單獨的 5 V 電源供應器提供。電源供應器的負極必須連接到 ESP 的 GND——沒有公共接地，DATA 信號將無法工作。

在這兩種情況下，在 psu_ma 菜單中都需要輸入您的電源供應器在 5 V 時實際能提供的電流。這不是「希望值」，而是電源供應器的規格值。FastLED 將根據此值限制總體亮度，以不超過限制。

良好的安裝實踐¶

這些元件不是必需的啟動，但可消除可尋址燈條的典型問題（像素跳過、「首個 LED 故障」、啟動時電壓下降）。

DATA 線上的電阻。 在 ESP GPIO 和燈條 DIN 之間串聯放置 300–500 Ω 電阻（通常為 390 Ω），物理上盡可能靠近燈條。消除信號反射並保護燈條的第一個晶片。
電源電解電容。 在燈條電源輸入的 +5V 和 GND 之間——1000 μF 在 16 V（在 25 V 也可以，在 10 V 是最小值）。平滑突發電流。
共地線截面積。 ESP—燈條—電源供應器接地線應根據燈條的峰值電流進行設計。短導線指南（最多約 1 m）：

電源供應器電流截面積 AWG

最多 3 A 0.5 mm² AWG 20

最多 5 A 0.75 mm² AWG 18

對於燈條的 +5V 線——使用相同的截面積。在長燈條上，從兩端供電。

信號連接¶

GPIO 值取決於開發板。

ESP32-C3 DevKitM-1 和 ESP32-C3 Super Mini¶

ESP	用途
`GPIO4`	可尋址燈條 `DATA`
`GPIO8`	`SDA`（SHT31，可選）
`GPIO9`	`SCL`（SHT31，可選）
`GND`	與燈條和電源供應器公共接地

Seeed XIAO ESP32-S3¶

ESP	用途
`GPIO2`	可尋址燈條 `DATA`
`GPIO5`	`SDA`（SHT31，可選）
`GPIO6`	`SCL`（SHT31，可選）
`GND`	與燈條和電源供應器公共接地

Waveshare ESP32-S3 Zero¶

ESP	用途
`GPIO4`	可尋址燈條 `DATA`
`GPIO8`	`SDA`（SHT31，可選）
`GPIO9`	`SCL`（SHT31，可選）
`GND`	與燈條和電源供應器公共接地

開發板腳位圖¶

ESP32-C3 Super Mini：

Waveshare ESP32-S3-Zero：

可選 SHT31 感測器¶

只有在此裝置上要發佈溫度和濕度時，感測器才是必需的。Storage Link 無論是否安裝感測器，都以相同方式啟動和運作。如果未安裝感測器，溫度和濕度只是不發送。

匯流排：相應開發板上的 I2C SDA/SCL。
地址：0x44 或 0x45（韌體將在啟動時自動確定）。

通過 Web Flasher 刷寫韌體¶

Web flasher 位於 install.idryer.org。

將 Storage Link 連接到電腦的 USB 埠。
打開 install.idryer.org 並單擊 Storage Link 按鈕。
選擇您的開發板變體。
單擊 Connect，選擇序列埠。如果裝置未被識別，按住開發板上的 BOOT 按鈕並短暫按下 RST。
單擊 Install。Flasher 將寫入韌體。
韌體刷寫完成後，Wi-Fi 設置嚮導將打開。

Wi-Fi 設置¶

韌體刷寫後，Improv 嚮導自動在序列埠中打開。

輸入您的 2.4 GHz 網路的 SSID 和密碼。
等待狀態為 Connected。

如果嚮導未打開，請斷開 USB 連接，然後通過 Connect 重新連接，而不重新刷寫韌體。

ESP32-C3 和 ESP32-S3 僅支持 Wi-Fi 2.4 GHz。5 GHz 網路不工作。

綁定到入口¶

在 Flasher 頁面上，單擊 連接並執行 Claim。Claim 指令將發送到裝置。
幾秒後，PIN 將在頁面上出現。PIN 有效時間約為 5 分鐘。
打開 portal.idryer.org → 添加裝置 → 輸入 PIN。
成功綁定後，裝置將在線上列表中出現。

如果 PIN 未出現或綁定失敗——重複 claim，或在入口中刪除裝置並重試。

燈條設置¶

參數通過裝置配置菜單設置。部分設置立即應用，部分僅在重啟後應用。

參數	值	默認值	應用方式
`led_count`	`1..300`，步長 `1`	`120`	立即
`psu_ma`	`500..20000` mA，步長 `100`	`5000`	立即
燈條類型	菜單中可用的選擇	`WS2812B`	重啟後
顏色順序	`GRB`、`RGB`、`BRG`、`BGR`	`GRB`	重啟後
`language`	`ru` / `en`	`en`	立即

首次啟動後的基本檢查清單：

設置 led_count——燈條上像素的實際數量。
設置 psu_ma——電源供應器在 5 V 的規格電流（以毫安計）。
選擇您安裝的燈條類型。
選擇顏色順序。默認為 GRB。如果紅色和綠色互換或顏色不正確——嘗試其他選項。
重啟裝置——燈條類型和顏色順序僅在重啟後應用。

預期結果¶

聲稱後，裝置在入口中可見為上線。
來自入口或應用程式的照明指令在指定時間內點亮燈條上的選定插槽。新指令關閉前一個插槽並點亮下一個。
如果安裝了 SHT31——溫度和濕度在入口中定期更新。
如果未安裝 SHT31——沒有氣候讀數，這是正常的。

電源供應器電流	截面積	AWG
最多 3 A	`0.5 mm²`	`AWG 20`
最多 5 A	`0.75 mm²`	`AWG 18`