2025-12-08 23:13:33 +11:00
|
|
|
[platformio]
|
2026-01-03 19:42:14 +11:00
|
|
|
crosspoint_version = 0.12.0
|
2025-12-08 23:13:33 +11:00
|
|
|
default_envs = default
|
2025-12-03 22:00:29 +11:00
|
|
|
|
2025-12-08 23:13:33 +11:00
|
|
|
[base]
|
2025-12-23 12:16:42 +11:00
|
|
|
platform = espressif32 @ 6.12.0
|
2025-12-03 22:00:29 +11:00
|
|
|
board = esp32-c3-devkitm-1
|
|
|
|
|
framework = arduino
|
|
|
|
|
monitor_speed = 115200
|
|
|
|
|
upload_speed = 921600
|
2025-12-15 19:46:52 +11:00
|
|
|
check_tool = cppcheck
|
2025-12-22 03:19:49 +11:00
|
|
|
check_flags = --enable=all --suppress=missingIncludeSystem --suppress=unusedFunction --suppress=unmatchedSuppression --suppress=*:*/.pio/* --inline-suppr
|
2025-12-15 19:46:52 +11:00
|
|
|
check_skip_packages = yes
|
2025-12-03 22:00:29 +11:00
|
|
|
|
|
|
|
|
board_upload.flash_size = 16MB
|
|
|
|
|
board_upload.maximum_size = 16777216
|
|
|
|
|
board_upload.offset_address = 0x10000
|
|
|
|
|
|
|
|
|
|
build_flags =
|
|
|
|
|
-DARDUINO_USB_MODE=1
|
|
|
|
|
-DARDUINO_USB_CDC_ON_BOOT=1
|
|
|
|
|
-DMINIZ_NO_ZLIB_COMPATIBLE_NAMES=1
|
2025-12-17 00:17:49 +11:00
|
|
|
-DEINK_DISPLAY_SINGLE_BUFFER_MODE=1
|
2025-12-30 15:09:30 +10:00
|
|
|
-DDISABLE_FS_H_WARNING=1
|
2025-12-08 23:13:33 +11:00
|
|
|
# https://libexpat.github.io/doc/api/latest/#XML_GE
|
2025-12-06 20:57:24 +11:00
|
|
|
-DXML_GE=0
|
|
|
|
|
-DXML_CONTEXT_BYTES=1024
|
2025-12-12 22:13:34 +11:00
|
|
|
-std=c++2a
|
2025-12-31 07:08:31 +09:00
|
|
|
# Enable UTF-8 long file names in SdFat
|
|
|
|
|
-DUSE_UTF8_LONG_NAMES=1
|
2026-01-09 22:03:16 +00:00
|
|
|
# LWIP TCP/IP stack optimizations for WiFi file transfer performance
|
|
|
|
|
# These settings optimize buffer sizes and TCP parameters for maximum throughput
|
|
|
|
|
-DCONFIG_LWIP_MAX_SOCKETS=10
|
|
|
|
|
-DCONFIG_LWIP_TCP_MSS=1436
|
|
|
|
|
-DCONFIG_LWIP_TCP_SND_BUF_DEFAULT=5744
|
|
|
|
|
-DCONFIG_LWIP_TCP_WND_DEFAULT=5744
|
|
|
|
|
-DCONFIG_LWIP_TCP_RECVMBOX_SIZE=12
|
|
|
|
|
-DCONFIG_LWIP_UDP_RECVMBOX_SIZE=12
|
|
|
|
|
-DCONFIG_LWIP_TCPIP_RECVMBOX_SIZE=32
|
|
|
|
|
-DCONFIG_LWIP_TCP_RTO_TIME=3000
|
|
|
|
|
# WiFi performance optimizations
|
|
|
|
|
-DCONFIG_ESP32_WIFI_STATIC_RX_BUFFER_NUM=16
|
|
|
|
|
-DCONFIG_ESP32_WIFI_DYNAMIC_RX_BUFFER_NUM=32
|
|
|
|
|
-DCONFIG_ESP32_WIFI_TX_BUFFER_TYPE=1
|
|
|
|
|
-DCONFIG_ESP32_WIFI_DYNAMIC_TX_BUFFER_NUM=32
|
|
|
|
|
# TCP optimizations for file uploads
|
|
|
|
|
-DCONFIG_LWIP_TCP_OVERSIZE=1
|
|
|
|
|
-DCONFIG_LWIP_WND_SCALE=1
|
|
|
|
|
-DCONFIG_LWIP_TCP_RCV_SCALE=2
|
2025-12-03 22:00:29 +11:00
|
|
|
|
2025-12-08 23:13:33 +11:00
|
|
|
; Board configuration
|
|
|
|
|
board_build.flash_mode = dio
|
|
|
|
|
board_build.flash_size = 16MB
|
|
|
|
|
board_build.partitions = partitions.csv
|
|
|
|
|
|
Add connect to Wifi and File Manager Webserver (#41)
## Summary
- **What is the goal of this PR?**
Implements wireless EPUB file management via a built-in web server,
enabling users to upload, browse, organize, and delete EPUB files from
any device on the same WiFi network without needing a computer cable
connection.
- **What changes are included?**
- **New Web Server**
([`CrossPointWebServer.cpp`](src/CrossPointWebServer.cpp),
[`CrossPointWebServer.h`](src/CrossPointWebServer.h)):
- HTTP server on port 80 with a responsive HTML/CSS interface
- Home page showing device status (version, IP, free memory)
- File Manager with folder navigation and breadcrumb support
- EPUB file upload with progress tracking
- Folder creation and file/folder deletion
- XSS protection via HTML escaping
- Hidden system folders (`.` prefixed, "System Volume Information",
"XTCache")
- **WiFi Screen** ([`WifiScreen.cpp`](src/screens/WifiScreen.cpp),
[`WifiScreen.h`](src/screens/WifiScreen.h)):
- Network scanning with signal strength indicators
- Visual indicators for encrypted (`*`) and saved (`+`) networks
- State machine managing: scanning, network selection, password entry,
connecting, save/forget prompts
- 15-second connection timeout handling
- Integration with web server (starts on connect, stops on exit)
- **WiFi Credential Storage**
([`WifiCredentialStore.cpp`](src/WifiCredentialStore.cpp),
[`WifiCredentialStore.h`](src/WifiCredentialStore.h)):
- Persistent storage in `/sd/.crosspoint/wifi.bin`
- XOR obfuscation for stored passwords (basic protection against casual
reading)
- Up to 8 saved networks with add/remove/update operations
- **On-Screen Keyboard**
([`OnScreenKeyboard.cpp`](src/screens/OnScreenKeyboard.cpp),
[`OnScreenKeyboard.h`](src/screens/OnScreenKeyboard.h)):
- Reusable QWERTY keyboard component with shift support
- Special keys: Shift, Space, Backspace, Done
- Support for password masking mode
- **Settings Screen Integration**
([`SettingsScreen.h`](src/screens/SettingsScreen.h)):
- Added WiFi action to navigate to the new WiFi screen
- **Documentation** ([`docs/webserver.md`](docs/webserver.md)):
- Comprehensive user guide covering WiFi setup, web interface usage,
file management, troubleshooting, and security notes
- See this for more screenshots!
- Working "displays the right way in GitHub" on my repo:
https://github.com/olearycrew/crosspoint-reader/blob/feature/connect-to-wifi/docs/webserver.md
**Video demo**
https://github.com/user-attachments/assets/283e32dc-2d9f-4ae2-848e-01f41166a731
## Additional Context
- **Security considerations**: The web server has no
authentication—anyone on the same WiFi network can access files. This is
documented as a limitation, recommending use only on trusted private
networks. Password obfuscation in the credential store is XOR-based, not
cryptographically secure.
- **Memory implications**: The web server and WiFi stack consume
significant memory. The implementation properly cleans up (stops server,
disconnects WiFi, sets `WIFI_OFF` mode) when exiting the WiFi screen to
free resources.
- **Async operations**: Network scanning and connection use async
patterns with FreeRTOS tasks to prevent blocking the UI. The display
task handles rendering on a dedicated thread with mutex protection.
- **Browser compatibility**: The web interface uses standard
HTML5/CSS3/JavaScript and is tested to work with all modern browsers on
desktop and mobile.
---------
Co-authored-by: Dave Allie <dave@daveallie.com>
2025-12-19 09:05:43 -05:00
|
|
|
extra_scripts =
|
|
|
|
|
pre:scripts/build_html.py
|
|
|
|
|
|
2025-12-03 22:00:29 +11:00
|
|
|
; Libraries
|
|
|
|
|
lib_deps =
|
|
|
|
|
BatteryMonitor=symlink://open-x4-sdk/libs/hardware/BatteryMonitor
|
2025-12-06 12:35:41 +11:00
|
|
|
InputManager=symlink://open-x4-sdk/libs/hardware/InputManager
|
2025-12-08 19:48:49 +11:00
|
|
|
EInkDisplay=symlink://open-x4-sdk/libs/display/EInkDisplay
|
2025-12-30 15:09:30 +10:00
|
|
|
SDCardManager=symlink://open-x4-sdk/libs/hardware/SDCardManager
|
2025-12-22 03:19:49 +11:00
|
|
|
ArduinoJson @ 7.4.2
|
2025-12-26 02:13:40 +01:00
|
|
|
QRCode @ 0.0.1
|
2025-12-08 23:13:33 +11:00
|
|
|
|
|
|
|
|
[env:default]
|
|
|
|
|
extends = base
|
|
|
|
|
build_flags =
|
|
|
|
|
${base.build_flags}
|
|
|
|
|
-DCROSSPOINT_VERSION=\"${platformio.crosspoint_version}-dev\"
|
|
|
|
|
|
|
|
|
|
[env:gh_release]
|
|
|
|
|
extends = base
|
|
|
|
|
build_flags =
|
|
|
|
|
${base.build_flags}
|
|
|
|
|
-DCROSSPOINT_VERSION=\"${platformio.crosspoint_version}\"
|