> For the complete documentation index, see [llms.txt](https://docs.wingbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wingbits.com/wingview/troubleshooting.md). # Troubleshooting Fix common WingView setup, display, network, and map problems. Nothing here harms your board or removes saved settings. ### Updates fail, but the board otherwise works Restart the board first. This returns it to the previous firmware version without removing settings. Follow the [Recovery Guide](/wingview/troubleshooting/recovery-guide.md) for the full steps and support-log instructions. ### Nothing appears on screen Touch the screen first. After 15 minutes, the display sleeps. A touch or knob turn restores it. Set the timeout in **Settings** → **Sleep after**. Choose 15, 30, or 60 minutes. You can show a clock while the display sleeps. Set this in **Settings** → **When asleep**. Touch the screen to return to the scope. If touching the screen does nothing, check power. Try another port, charger, or cable. If the board has never been flashed, it stays dark until you install firmware. ### The flashing tool cannot find the board Use a cable that carries data. Charge-only cables are common. Check that your computer detects the port. On Linux, look for `/dev/ttyACM0`. On Windows, look for a COM port. ### Demo traffic does not disappear Your WingView does not have a working feed. Hold the **N** button and check the status screen: * `no auth` means your API key was rejected. * `no internet` means the board cannot reach the internet. * `api down` means our API did not answer. Demo traffic is expected whenever the board has no working feed. ### Aircraft appear, but no map The selected location probably has no maps. Open **locations** to check each location. A failed or interrupted map build leaves no partial maps. Start the build again. The board only uses a map set after every range is written. This prevents incomplete maps. ### The map disappears when you zoom in The board is using maps built for a nearby location. It stops using them at closer ranges to avoid map misalignment. The location tolerance is 3% of the displayed range. It is about 5.5 km at 100 NM and 170 m at 3 NM. This usually happens when you have nearby locations. It can also happen near Los Angeles, where demo maps are centered. Build maps for the location you are using. ### You cannot reach the web page Open the settings menu. Select **Wi-Fi setup** to restore the board's setup network. ### The page requests a passphrase you do not have Press and hold the **N** button to open the status screen. Find the `page pass` row. The passphrase uses lowercase letters only. Replace it in **Settings** → **New passphrase** if needed. ### An erase appears to do nothing Each erase option requires confirmation on the board. Touch and hold the screen for about 2.5 seconds. A ring sweeps around the display. The erase starts when it closes. A quick tap cancels the erase. On the Elecrow, you can press the knob instead. The web page cannot erase the board by itself. If the display is asleep, it wakes for the confirmation. ### You cannot reach the web page or settings menu Install the firmware again from the browser. Follow the same steps as your original setup: 1. Plug the board into a computer. 2. Open [the WingView install page](https://wingbits.com/wingview/) in Chrome or Edge. 3. Select **Install**. 4. Select no when asked whether to erase first. Your Wi-Fi, API key, locations, and maps remain saved. This works even when nothing else on the board works. It does not use the network, web page, or running firmware. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.wingbits.com/wingview/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.