Leopoldo Pla Sempere
7f01eab62e
## Summary * **What is the goal of this PR?** Update project documentation to match the current master implementation for cache formats, i18n, file transfer/web server workflows, SD-card fonts, and root user-facing docs. * **What changes are included?** Refreshes `book.bin`/`section.bin` docs for v6/v25, updates File Transfer/Calibre/WebDAV/API docs, documents 24 UI languages and JSON language persistence, updates root README/USER_GUIDE cache and network details, and syncs the tracked CLAUDE skill doc cache-version notes. ## Additional Context * Docs-only change. Verified with `git diff --check origin/master..HEAD` and stale-reference greps for old cache versions, removed i18n APIs, old WiFi screen wording, and raw `Serial.printf` examples. No firmware build was run. --- ### AI Usage While CrossPoint doesn't have restrictions on AI tools in contributing, please be transparent about their usage as it helps set the right context for reviewers. Did you use AI tools to help write this code? _**NO**_
61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# Troubleshooting
|
|
|
|
This document shows common issues and possible solutions while using the device features.
|
|
|
|
- [Troubleshooting](#troubleshooting)
|
|
- [Cannot See the Device on the Network](#cannot-see-the-device-on-the-network)
|
|
- [Connection Drops or Times Out](#connection-drops-or-times-out)
|
|
- [Upload Fails](#upload-fails)
|
|
- [Saved Password Not Working](#saved-password-not-working)
|
|
|
|
### Cannot See the Device on the Network
|
|
|
|
**Problem:** Browser shows "Cannot connect" or "Site can't be reached"
|
|
|
|
**Solutions:**
|
|
|
|
1. Verify both devices are on the correct network
|
|
- Check your computer/phone Wi-Fi settings
|
|
- In **Join Network** mode, your computer/phone and CrossPoint Reader must be on the same Wi-Fi network
|
|
- In **Create Hotspot** mode, your computer/phone must be connected to the `CrossPoint-Reader` hotspot
|
|
2. Double-check the IP address
|
|
- Make sure you typed it correctly
|
|
- Include `http://` at the beginning
|
|
- Try the displayed IP address if `http://crosspoint.local/` does not resolve
|
|
3. Try disabling VPN if you're using one
|
|
4. Some networks have "client isolation" enabled - use Create Hotspot mode or check with your network administrator
|
|
|
|
### Connection Drops or Times Out
|
|
|
|
**Problem:** Wi-Fi connection is unstable
|
|
|
|
**Solutions:**
|
|
|
|
1. Move closer to the Wi-Fi router, or use Create Hotspot mode for a direct connection
|
|
2. Check signal strength on the device (should be at least `||` or better)
|
|
3. Avoid interference from other devices
|
|
4. Try a different Wi-Fi network if available
|
|
|
|
### Upload Fails
|
|
|
|
**Problem:** File upload doesn't complete or shows an error
|
|
|
|
**Solutions:**
|
|
|
|
1. Check that the SD card has enough free space
|
|
2. Check that the filename is valid for the SD card filesystem
|
|
3. Try uploading a smaller file first to test
|
|
4. Refresh the browser page and try again
|
|
5. If WebSocket upload fails repeatedly, refresh the page and retry with the HTTP fallback path
|
|
|
|
### Saved Password Not Working
|
|
|
|
**Problem:** Device fails to connect with saved credentials
|
|
|
|
**Solutions:**
|
|
|
|
1. When connection fails, you'll be prompted to "Forget Network"
|
|
2. Select **Yes** to remove the saved password
|
|
3. Reconnect and enter the password again
|
|
4. Choose to save the new password
|