TABLE OF CONTENTS
- DAKboard OS Setup:
- DAKboard Shows a Loading Screen:
- DAKboard is Showing Code:
- DAKboard Network Connection Issues:
- Helpful Articles:
This guide is to help you find the cause of the most common things we see with our OS. It will also supply you with basic troubleshooting and how to correct the issues when they happen.
DAKboard OS Setup:
When first setting up a DAKboard OS device some issues may occur. Below is a list of the most common ones and how to resolve them.
DAKboard Loops Back to Welcome Page:
DAKboard Goes to a Blank Screen:
This will happen if the Chromium browser is delayed starting post-connection to your home network. It will most often occur with the smaller CPUs, like the CPU Mini or the Raspberry Pi 3B or 3A. CPUs with less than 1GB of RAM can delay or fail to start the browser after the initial connection to your network. Rebooting these CPUs, will restart the browser service and allow it to load. If you continue to get a blank screen you can either try a Factory Reset of your device using the steps in our article Reset your Device to Factory Settings or you can reset your OS completely by upgrading it using the steps in our article Upgrading your DAKboard OS Device.
DAKboard Fails to Register With Link Code:
If you receive an error saying your Display was unable to link, the link code appears to not be working when you enter it into your display, or it fails to link with no error message, this may be a sign of a weak WiFi signal to your display or a delay in processing on the smaller CPUs. Try moving the CPU closer to your Router or Access point, or move your Mesh node or WiFi Extender closer to the DAKboard to improve this while completing your initial linking.
On Smaller CPUs, like the Mini, the Raspberry Pi 3B, or 3A, you may need to reboot the CPU and get a fresh link code. This is because the CPU received the link code but did not have the memory to store it. In these rare cases, the Link code will show that it was accepted but the communication of this information from our services to your CPU was lost. Rebooting the CPU will free up enough memory to allow the new link code to be stored.
DAKboard Hotspot Fails to Start or Connect:
This can happen when there is a lot of WiFi traffic in your home, or a device in your house is using the same WiFi band we use to launch the Hotspot. This will sometimes cause the Hotspot to fail to load. In these cases, you can use the Manual steps to access your Settings page and set up your device instead. We have listed them below for you in order:
- Connect the USB mouse/keyboard to your CPU using one of its USB A ports (If you have a Mini you will need a Micro male to USB A female adapter)
- Reboot the CPU by unplugging the power cable
- Once fully booted up, If you have the latest OS you can use the Touchscreen/ On-Device Setup button at the bottom of the page to open the Settings page. Skip to step 6 if this is the case. Otherwise, press ALT+F4 on your keyboard and continue at step 4.
- Click on the Raspberry icon in the top left of the screen
- Select Help, then click on Device Configuration
- Update/verify the network credentials
- Click Save at the bottom of the page
- Once the settings are saved, reboot by unplugging the power cable
DAKboard Shows a Loading Screen:
Depending on which model DAKboard you have and which version of the OS you are on this can present itself in several ways. We will cover the variations and how to correct the Display.
DAKboard Reboots After Reaching Loading or Rainbow Screen:
If your DAKboard OS device is only going to the DAKboard loading page, or a rainbow-colored screen and reboots repeatedly, this means that your DAKboard is not getting the response from your Monitor/TV via the HDMI. This can be a sign that either your HDMI connection from the CPU to the Monitor/TV is loose or your HDMI cable is bad.
If the connection is loose, you can correct this by simply unplugging the power to your DAKboard CPU, unplugging both the HDMI connection on the CPU and the Monitor/TV, then plugging the HDMI cable back in making sure the connection is sound on both ends. If you have a CPU v4, we recommend using the Primary output, the output closest to the power supply, for best results. Then simply plug the power back in and your device will start up.
If this does not work, try connecting your CPU to a different Monitor/TV. If it continues to reboot on the new device, then your cable may be bad and will need to be replaced.
DAKboard Hangs on the Orange Pi Logo:
This will only happen when using a DAKboard built on an Orange Pi 3LTS. When this happens it means that the OS has failed to load entirely. This could happen if your SD card is not fully seated if the OS has become corrupted, or if the SD card has been damaged and needs to be replaced.
If the SD card is not fully seated, try removing it and reseating it in the Micro SD card slot. With the Orange Pi 3LTS, you will know the SD card is seated fully when you hear a click and it does not pop back out. Reboot the CPU and it should load.
If after reseating the SD card it continues to fail, try upgrading the the OS to the latest release. You can remove your SD card, connect it to a Laptop or PC using a Micro SD card reader, and then follow the steps in our article Orange Pi - Download and Install DAKboard OS to upgrade your SD card. Reinstall the SD card and reboot your CPU, then follow the onscreen instructions or use our article Setup - DAKboard CPU/Micro SD Card to reconnect your Display to your account.
If the SD card fails to install the OS or the Etcher program says it cannot write to the SD card, this means the card itself is damaged and needs replacing. We recommend replacing the SD card with a 16 GB micro SD card. Once you have the new card, follow the same steps above to install the OS.
DAKboard Hangs on the DAKboard Loading Page:
If you make it to the loading page and it does not boot loop or advance, this means that the Browser we use to show your Screen has failed to load. The only fix for this is to upgrade your DAKboard OS device. For the CPU v3 on the Orange Pi 3LTS, use the article we supplied above to complete this upgrade. For all other DAKboard OS devices, you can use the article Raspberry Pi - Download and Install the DAKboard OS. If you are not sure how to access your SD cards, check out our article Upgrading your DAKboard OS Device as this contains details and links to articles to show you how to replace them.
DAKboard is Showing Code:
Sometimes the DAKboard OS will become corrupted. This can happen for several reasons and is very hard to predict or determine the cause of the failure, however, the solution is always the same. Upgrading the OS to the latest to get it back up and running. See our article Upgrading your DAKboard OS Device to see how to do this. These corruptions can show themselves in various ways. Here are the most common ones:
Kernel Panic:
When the DAKboard loads a stream of code that ends with the message Kernel Panic, this means that the base OS we used to build our OS upon has become corrupted. This usually happens if you try to update the base Kernel or if there was a sudden interruption of power to the CPU while it was writing to the SD card containing the OS. You will need to reinstall the OS to correct this.
busybox v1.35:
If the DAKboard only loads to a line that states busybox v1.35, this is similar to a Kernel Panic. The cause of this failure is when the CPU was writing to the SD card containing the OS and was interrupted. This will cause it to overwrite some of our OS code which will prevent it from starting your CPU. You will need to reinstall the OS to correct this.
Loads to a Raspberry Pi Command Prompt or an Error Message:
This will happen when the base Kernel loads, but it was unable to access the loading scripts from the DAKboard User. This can happen if you make edits to the code if the browser fails to start, or if the DAKboard User is deleted. You will need to reinstall the OS to correct this.
DAKboard Network Connection Issues:
Once you have your DAKboard OS device connected to your account you may have issues where your DAKboard goes offline or freezes. Below are what each of these items are and how to fix them.
Weak WiFi Signal Strength:
The cause for most of the issues in this section will be a weak WiFi signal strength. A good signal strength is between 0 and -67 dBm with values closer to 0 being better. If your signal strength is -50 dBm or higher, you will experience loading and network connection issues. If it is greater than -67 dBm, these issues will become more frequent or permanent until the strength can be improved. Be aware that other devices may have a strong signal strength when standing next to your Display, but that does not mean the DAKboard can use that signal strength. Only judge how good the signal strength is for the DAKboard OS device by what it is reporting.
Using this knowledge will help you in the placement of your DAKboard OS device in your home, or the placement of your Mesh Nodes, or WiFi Extenders.
NOTE: DAKboard OS devices version 3.50 and above support Mesh Nodes, Access Points, and WiFi Extenders. If you are running a version older than this on your Display we strongly recommend upgrading it to improve your network connections. Use our article Upgrading your DAKboard OS Device to see how to complete these upgrades.
No Internet Message After Reboot:
If you reboot your DAKboard OS device and receive a No Internet message, this does not necessarily mean that your internet is down, instead it may mean that your DAKboard cannot reach the internet through your network. This could indicate that there is an issue with your WiFi signal strength, preventing the DAKboard from connecting to your router. If your router and DAKboard just reset together, the DAKboard may have come back up before the router completed its connection to the internet.
First, make sure your router is online and connected to the internet, then try rebooting your DAKboard OS device by unplugging it and plugging it back in. If you still get the No Internet message, check your last reported WiFi signal as described above. If your signal strength is less than you expected, try rebooting your router, Mesh Nodes, Access Points, or WiFi Extenders as they may also be having issues connecting. Once they are back online reboot the DAKboard again. If the issue persists, try moving your DAKboard closer to the router, or moving your Mesh Node, Access Point, or WiFi extender close to it.
Alternatively, you can connect your DAKboard via ethernet to bypass the need for WiFi altogether. If you don't want to run a long wire to your router, check and see if your Mesh Nodes or WiFi Extenders have an ethernet port you can connect to instead. You can also use Ethernet Over Power (EOP) devices as they use your home's electrical circuitry to make an artificial ethernet connection to your Display.
DAKboard Device is Offline Message:
If your DAKboard OS device is displaying the message DAKboard Device is Offline - Please check network connectivity! this means that your display has been offline for more than 6 hours. OS version 3.50 and up will attempt to reconnect to your network once every 30 minutes. If it fails to connect it will launch the Hotspot called DAKboard to allow you a means to access the settings page. If you see this network up on a WiFI-Enabled device, you can connect to it using the password dakb5142 then navigate to the settings page by opening a browser and typing in http://10.0.0.5. From here you can check or update your WiFi credentials.
At the 6-hour mark from when it last successfully connected to our service, this message will appear. As with the No Internet message above, this does not necessarily mean that your network is down, it just means that the DAKboard cannot connect to your internet and our services. Use the same steps above to see if you can get your device back online.
Helpful Articles:
Having trouble? See if these articles help
- Reset your Device to Factory Settings
- Trouble Connecting To A WiFi Network
- Set Display Resolution
- Updating Your WiFi Credentials on Your DAKboard OS Device
- Move a Display or CPU to a New DAKboard Account
- How to Access Your DAKboard OS Settings Page