EleksCava 使用指南
EleksCava 加密貨幣與股市顯示裝置的完整設定與使用指南。
產品概述
EleksCava 是一款基於 ESP32 的智慧金融市場顯示器，採用 2.9 吋 E-Ink 螢幕，即時顯示加密貨幣與股票的價格資訊。
•雙市場支援：同時支援加密貨幣（Bitcoin、Ethereum 等）和股票（美股、A股、港股）價格顯示
•即時資料更新：自動從專業金融資料源取得最新價格資訊
•E-Ink 螢幕：低功耗、護眼、斷電保持顯示
•LED 趨勢指示：透過顏色變化直觀顯示價格漲跌
•Web 設定介面：透過瀏覽器輕鬆設定裝置參數
•多裝置堆疊：支援最多 5 台裝置垂直堆疊使用
首次使用配網步驟
1. 開機啟動
使用 USB-C 傳輸線將裝置連接到電源。裝置啟動後，螢幕會顯示啟動畫面。如果裝置尚未設定 Wi-Fi，將自動進入設定模式。
2. Wi-Fi 設定
- 方法一 — 瀏覽器設定（推薦）：透過 www.elekscava.com/firmware 刷入韌體後，瀏覽器會自動彈出 Wi-Fi 設定視窗。輸入 Wi-Fi 名稱和密碼後，裝置會儲存設定並重新啟動連線。
- 方法二 — AP 熱點設定：如裝置進入 AP 模式（LED 變為藍色），在手機或電腦上搜尋名為 'EleksCava_XXXX' 的熱點（無需密碼）。連接後會自動彈出設定頁面，或手動前往 http://192.168.4.1。
3. 設定網路
- 選擇您的 Wi-Fi 網路（僅支援 2.4GHz），輸入 Wi-Fi 密碼，點選'儲存'按鈕
- 裝置將自動重新啟動並連接到您的 Wi-Fi 網路
- 連接成功後，可在瀏覽器中前往 http://elekscava.local 開啟裝置設定頁面
按鍵功能說明
基礎按鍵功能
| 按键 | 功能说明 |
|---|---|
| Key A | 切換到下一個加密貨幣或股票 |
| Key B | 切換顯示模式（加密貨幣 → 股票 → 時間 → 天氣 → 裝置資訊） |
| Key C | 切換到上一個加密貨幣或股票 |
組合按鍵功能
| 组合 | 功能说明 |
|---|---|
| A + C (10s) | A + C 長按10秒：進入 Wi-Fi 設定模式（AP模式），LED 變為藍色 |
設定加密貨幣清單
前往設定介面
- 在瀏覽器中前往 http://elekscava.local（或輸入裝置 IP 位址）
- 進入主設定頁面後，找到'Cryptocurrency Settings'部分
新增加密貨幣
- 在輸入框中輸入加密貨幣符號（如 BTC、ETH、XRP）
- 輸入時會出現智慧提示，協助您選擇正確的加密貨幣
- 點選 '1.Add' 按鈕將其新增到清單
- 最多支援新增 15 個加密貨幣
支持的加密货币：
BTC (Bitcoin)
ETH (Ethereum)
XRP (Ripple)
USDT (Tether)
SOL (Solana)
BNB (Binance Coin)
DOGE (Dogecoin)
ADA (Cardano)
TRX (Tron)
LTC (Litecoin)
注意：預設幣種清單可能因韌體版本而異。您可以透過 Web 設定介面自訂清單。
管理加密貨幣清單
•調整順序：使用每個幣種旁的 'Up'/'Down' 按鈕調整顯示順序
•刪除幣種：點選 'Delete' 按鈕移除不需要的加密貨幣
•設定持有量：點選 'Set' 按鈕可設定您的持有數量。持有量用於計算投資組合總價值，支援鏈上錢包餘額查詢。
•重置清單：點選 'Reset' 按鈕恢復預設清單
同步到裝置
- 完成清單設定後，'2.Sync to Device' 按鈕會自動啟用
- 點選該按鈕將設定同步到裝置
- 同步成功後，裝置會自動更新顯示
- 使用裝置上的按鍵 A/C 可以輪流切換顯示不同的加密貨幣
API 資料來源選擇
EleksCava 支援多種加密貨幣資料來源，您可以在 Web 設定介面中切換。
Gate.io: 預設資料來源，涵蓋範圍廣
Binance: 全球加密貨幣交易所
Binance US: 美國合規版 Binance
Binance Data: Binance 資料節點
Binance Testnet: 測試網路
OKX: 支援 HMAC 簽名認證
CoinGecko: 支援法幣交易對
Custom API: 自訂 URL，使用 {symbol} 佔位符
使用自訂 API 時，在 URL 中使用 {symbol} 作為佔位符，裝置會自動替換為實際的加密貨幣符號。
法幣交易對
EleksCava 支援以 45 種不同法幣計價加密貨幣。
使用法幣交易對時，請輸入「符號/貨幣」格式。例如：BTC/EUR、ETH/GBP、SOL/JPY
支援的貨幣：USD（預設）、EUR、GBP、JPY、CNY、KRW、AUD、CAD、CHF、HKD、SGD、TWD、INR、BRL 等共 45 種。
設定股票清單
前往股票設定
在 Web 管理介面中找到 "Stock Settings" 部分
新增股票
支持的市场：
US Stock: 美股（如 AAPL、TSLA、GOOGL）
Shanghai (SH): 上海證券交易所
Shenzhen (SZ): 深圳證券交易所
Hong Kong (HK): 香港交易所
Beijing (BJ): 北京證券交易所
Gold (SGE): 上海黃金交易所
China Futures (NF): 國內期貨
Gold Futures (COMEX): 國際黃金期貨
Futures Market: 國際期貨市場
US Indices: DJI（道瓊斯）、IXIC（那斯達克）、INX（標普500）
Gold/Silver Ratio: GSR — 金銀比價
- 選擇市場類型：從下拉選單中選擇股票所屬市場
- 輸入股票代碼：在輸入框中輸入對應的股票代碼
- 代碼格式範例：美股直接使用代碼（AAPL），滬市使用6位代碼（600519），深市使用6位代碼（000001），港股使用5位代碼（00700）
- 驗證代碼：點選 '1.Validate' 按鈕驗證代碼有效性
- 新增到清單：驗證通過後，點選 '2.Add' 按鈕新增
- 同步到裝置：完成設定後，點選 '3.Sync to Device' 按鈕
股票顯示說明
- 美股會顯示 $ 符號
- A股會顯示 ¥ 符號
- 港股顯示 HK$ 符號
- 支援盤後交易資料（美股）
- 非交易時間顯示'Not Trading Hours'
天氣顯示
EleksCava 可顯示目前天氣狀況。按 Button B 切換至天氣模式。無需 API Key。
- 資料來源：wttr.in（無需 API Key，開箱即用）
- 城市偵測：透過 IP 地理定位自動偵測，或手動輸入城市
- 3 日天氣預報：今天 + 未來 2 天，含溫度範圍和天氣指示
- 更新間隔：每 10 分鐘自動重新整理
- LED 溫度漸層：藍色（寒冷）→ 綠色（溫和）→ 紅色（炎熱）的連續漸層
時間顯示設定
設定時間模式（Button B）下的時間顯示方式。
- 12 小時 / 24 小時格式切換
- 時區選擇：UTC-12 至 UTC+14
- NTP 伺服器設定（預設：pool.ntp.org）
- 夏令時間（DST）開關
價格預警系統
EleksCava 可在 1 分鐘滾動視窗內偵測到顯著價格波動時發出警報。
- 取樣頻率：每 5 秒一次（12 個樣本的環形緩衝區）
- 可設定閾值：0.5%、1%、2%、3%、5%、10%
- 警報方式：LED 閃爍、蜂鳴器或兩者同時
- 自動冷卻期，防止重複警報
蜂鳴器 / 聲音
EleksCava 內建無源壓電蜂鳴器（GPIO 25），用於音訊回饋。
- 開機歡迎旋律
- 價格預警通知聲
- 音量級別：低（25%）、中（50%）、高（80%）
- 可在 Web 設定中停用
裝置資訊畫面
按 Button B 切換至裝置資訊畫面，顯示以下內容：
- IP 位址和 MAC 位址
- Wi-Fi 訊號強度（RSSI）
- 目前韌體版本
- 可用記憶體 / 堆積狀態
- 電池狀態（如適用）
韌體更新
更新準備
- 開始更新前，請確認裝置已開機且正常運作
- 檢查目前版本：在裝置 Web 管理介面查看目前韌體版本
- 穩定網路環境：確保穩定的 Wi-Fi 或 USB 連接
- 充足電量：更新過程中保持裝置連接 USB 電源
透過 Web 介面更新（推薦）
線上更新方式
- 前往官網：使用電腦瀏覽器前往 www.elekscava.com/firmware
- 連接裝置：確保電腦和 EleksCava 裝置在同一網路下
- 進入更新模式：在裝置 Web 管理介面中找到'韌體更新'選項，或者前往：http://[裝置IP]/firmware
- 選擇更新方式：線上更新（直接從伺服器下載最新韌體）或本地更新（上傳下載的韌體檔案）
使用 WebSerial 更新
- 準備工作：使用支援 WebSerial API 的瀏覽器（Chrome 89+、Edge 89+），準備 USB-C 傳輸線將裝置連接到電腦
- 前往韌體頁面：使用 Chrome 或 Edge 瀏覽器前往 www.elekscava.com/firmware
- 連接裝置：使用 USB-C 傳輸線將 EleksCava 裝置連接到電腦
- 開始更新：點選 'Install Firmware' 按鈕，在彈出視窗中選擇對應的序列埠，等待安裝完成（約 2-3 分鐘）
- 設定 Wi-Fi：刷機完成後，瀏覽器會自動彈出 Wi-Fi 設定視窗，輸入網路資訊後裝置將重新啟動並連接。
更新注意事項
更新前檢查
- 備份設定：重要的 Wi-Fi 與幣種設定可能在更新後需要重新設定
- 網路穩定：確保更新過程中網路連接穩定
- 電源穩定：更新過程中不要斷電或移除 USB 連線
更新過程
- 進度顯示：更新過程中裝置螢幕會顯示更新進度
- LED 指示：更新期間 LED 會顯示特殊顏色（通常為紫色或白色閃爍）
- 自動重新啟動：更新完成後裝置會自動重新啟動
- 時間要求：整個過程通常需要 3-5 分鐘
更新後設定
- 驗證版本：在 Web 管理介面確認韌體版本已更新
- 重新設定：檢查並重新設定 Wi-Fi、幣種清單等設定
- 功能測試：測試所有按鍵功能和顯示模式是否正常
更新失敗處理
恢復步驟
- 重新連接 USB 傳輸線並再次嘗試更新
- 如果裝置無回應，斷開並重新連接電源，然後重試
- 如問題持續，請聯絡 [email protected] 取得協助
進階設定
刷新間隔
•資料取得間隔：每 30 秒自動取得最新價格資料（固定，不可設定）
•螢幕完整刷新：預設每 60 分鐘進行一次全螢幕刷新以防止殘影（可透過 Web 介面設定）
•自動播放：可設定自動切換顯示內容的間隔時間
LED 指示燈設定
•綠色：價格上漲（可設定反轉）
•紅色：價格下跌（可設定反轉）
•藍色：Wi-Fi 設定模式
•白色：價格無變化
•彩虹效果：時間顯示等特殊模式
亮度級別：關閉 / 超低(5%) / 低(10%) / 四分之一(25%) / 中(50%) / 明亮(80%) / 高(100%) / 自動
時區設定
- 預設自動偵測時區
- 可手動選擇時區（UTC-12 到 UTC+14）
- 影響時間顯示和交易時間判斷
- Web 設定介面支援 4 種語言：英語、簡體中文、日語、韓語
歡迎畫面自訂
透過 Web 設定介面自訂開機歡迎畫面標題（預設：'EleksCava'）。歡迎畫面還會顯示韌體版本和 MAC 位址。
靜態 IP 設定
適用於需要固定網路位址的進階使用者。
- 在 DHCP（預設）和靜態 IP 之間切換
- 手動設定：IP 位址、閘道、子網路遮罩、DNS 伺服器
自訂顯示 API
面向開發者：EleksCava 提供 HTTP 端點，可向 E-Ink 螢幕推送自訂內容。
| Endpoint | 说明 |
|---|---|
| POST /api/display/text/simple | 推送純文字到螢幕 |
| POST /api/display/text/icon | 推送帶圖示的文字到螢幕 |
| POST /api/display/alert | 推送警報訊息 |
| POST /api/display/notification | 推送通知 |
| POST /api/display/market-summary | 推送市場概覽 |
序列埠偵錯命令
面向進階使用者和開發者。透過 USB 序列埠連線（115200 鮑率）存取偵錯命令。
| 命令 | 说明 |
|---|---|
| viewlog | 檢視裝置日誌 |
| clearlog | 清除日誌 |
| get_status | 查詢裝置狀態 |
| memcheck | 記憶體診斷 |
| factory_test | 進入工廠測試模式 |
常見問題解答
如何重新設定 Wi-Fi？
同時長按按鍵 A 和 C 約 10 秒，LED 變藍後即可重新配網。
為什麼看不到我的 Wi-Fi 網路？
裝置僅支援 2.4GHz Wi-Fi，請確認您的路由器開啟了 2.4GHz 頻段。
如何恢復出廠設定？
- 僅重置 Wi-Fi：長按 A+C 10秒 — 僅清除 Wi-Fi 設定，保留加密貨幣與股票設定不變
- 完全恢復出廠：前往 www.elekscava.com/firmware，執行完整韌體刷入 — 將清除所有資料，包括 Wi-Fi、加密貨幣清單、股票清單及所有設定
資料多久更新一次？
資料取得間隔為每 30 秒（固定）。螢幕完整刷新預設每 60 分鐘一次以防止殘影（可透過 Web 介面設定）。注意：資料取得和螢幕完整刷新是獨立的，資料會在背景更新，而完整刷新會重新繪製整個 E-Ink 螢幕。
支援哪些加密貨幣？
- 支援來自多個資料源的主流加密貨幣，包括 Gate.io（預設）、Binance、CoinGecko 等（最多 15 個）。熱門幣種包括：
- BTC (Bitcoin)、ETH (Ethereum)、XRP (Ripple)
- USDT (Tether)、SOL (Solana)、BNB (Binance Coin)
- DOGE (Dogecoin)、ADA (Cardano)、TRX (Tron)，以及更多...
支援哪些股票市場？
- 美股：紐交所、納斯達克所有股票
- A股：滬深兩市所有股票
- 港股：香港交易所主板股票
E-Ink 螢幕閃爍正常嗎？
正常。E-Ink 螢幕刷新時會有短暫閃爍，這是技術特性。
可以同時顯示多個幣種嗎？
裝置一次顯示一個幣種/股票，透過按鍵 A/C 快速切換查看。
為什麼裝置斷電後無法正常啟動？
先斷開裝置電源，按住 A、B、C 任一按鍵，同時將 ON/OFF 電源開關來回切換幾次，讓裝置徹底放電，然後重新接通電源。
技術支援
如遇到使用問題，請透過以下方式取得協助：
- 官方網站：www.elekscava.com
- 韌體更新：定期前往官網取得最新韌體
- 技術支援信箱：[email protected]
注意事項
•電源要求：使用 5V/1A 以上的 USB 電源供應器
•網路要求：需要穩定的 2.4GHz Wi-Fi 網路連接
•溫度範圍：運作溫度 0°C ~ 40°C
•螢幕保護：避免長時間陽光直射和高溫環境
•資料準確度：顯示資料僅供參考，請以交易所官方資料為準