mirror of
https://github.com/daveallie/crosspoint-reader.git
synced 2026-02-04 22:57:50 +03:00
e3d6e32609
## More detailed documentation * **What is the goal of this PR?** Add more information about the exposed webserver. * **What changes are included?** Detailed documentation for the webserver endpoints (`./docs/webserver-endpoints.md`) Adding a table of content so it is easier to navigate directly to the section you're interested on (Almost all `.md` files or at least all those relevant) ## Additional Context Not sure if this would get accepted but I thought it might be useful for those trying to create separate apps that would sync files to the device. It was at least to me trying to upload files using python as stated [here](https://github.com/crosspoint-reader/crosspoint-reader/discussions/434#discussioncomment-15545349) --- ### 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? _**PARTIALLY**_
58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# Troubleshooting
|
|
|
|
This document show most 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 **same WiFi network**
|
|
- Check your computer/phone WiFi settings
|
|
- Confirm the CrossPoint Reader shows "Connected" status
|
|
2. Double-check the IP address
|
|
- Make sure you typed it correctly
|
|
- Include `http://` at the beginning
|
|
3. Try disabling VPN if you're using one
|
|
4. Some networks have "client isolation" enabled - check with your network administrator
|
|
|
|
### Connection Drops or Times Out
|
|
|
|
**Problem:** WiFi connection is unstable
|
|
|
|
**Solutions:**
|
|
|
|
1. Move closer to the WiFi router
|
|
2. Check signal strength on the device (should be at least `||` or better)
|
|
3. Avoid interference from other devices
|
|
4. Try a different WiFi network if available
|
|
|
|
### Upload Fails
|
|
|
|
**Problem:** File upload doesn't complete or shows an error
|
|
|
|
**Solutions:**
|
|
|
|
1. Ensure the file is a valid `.epub` file
|
|
2. Check that the SD card has enough free space
|
|
3. Try uploading a smaller file first to test
|
|
4. Refresh the browser page and try again
|
|
|
|
### 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
|