EleksCava 使用指南
您的 EleksCava 加密货币和股市显示设备的完整设置和使用指南。
产品概述
EleksCava 是一款基于 ESP32 的智能金融市场显示器，采用 2.9 英寸电子墨水屏，实时显示加密货币和股票的价格信息。
•双市场支持：同时支持加密货币（Bitcoin、Ethereum 等）和股票（美股、A股、港股）价格显示
•实时数据更新：自动从专业金融数据源获取最新价格信息
•电子墨水屏：低功耗、护眼、断电保持显示
•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 端点，可向电子墨水屏推送自定义内容。
| 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 界面配置）。注意：数据获取和屏幕全刷新是独立的——数据在后台更新，而全刷新会重新绘制整个电子墨水屏。
支持哪些加密货币？
- 支持来自多个数据源的主流加密货币，包括 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股：沪深两市所有股票
- 港股：香港交易所主板股票
电子墨水屏闪烁正常吗？
正常。电子墨水屏刷新时会有短暂闪烁，这是技术特性。
可以同时显示多个币种吗？
设备一次显示一个币种/股票，通过按键 A/C 快速切换查看。
为什么设备断电后无法正常启动？
先断开设备电源，按住 A、B、C 任意一个按键，同时将 ON/OFF 电源开关来回拨动几次，让设备彻底放电，然后重新接通电源。
技术支持
如遇到使用问题，请通过以下方式获取帮助：
- 官方网站：www.elekscava.com
- 固件更新：定期访问官网获取最新固件
- 技术支持邮箱：[email protected]
注意事项
•电源要求：使用 5V/1A 以上的 USB 电源适配器
•网络要求：需要稳定的 2.4GHz Wi-Fi 网络连接
•温度范围：工作温度 0°C ~ 40°C
•屏幕保护：避免长时间阳光直射和高温环境
•数据准确性：显示数据仅供参考，请以交易所官方数据为准