Difference between revisions of "Troubleshooting"

From Gamebuino Wiki
Jump to: navigation, search
(forum link added)
m (How to format the micro SD card: forgot the <code> tag)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page is meant to help you sort out the problems you may encounter. If you've been through this page (and the [[Getting started]] page) and didn't find any answer, then you can:
+
This page is meant to help you sort out the problems you may encounter. If you've been through this page (and the [[Getting started]] page) and didn't find any answers, then you can:
 
* Search on the forum if someone had a similar issue and solved it
 
* Search on the forum if someone had a similar issue and solved it
 
* Post on the forum in [http://gamebuino.com/forum/viewforum.php?f=7 Installation & Troubleshooting]
 
* Post on the forum in [http://gamebuino.com/forum/viewforum.php?f=7 Installation & Troubleshooting]
Line 6: Line 6:
 
== Boot ==
 
== Boot ==
 
=== My Gamebuino won't turn on ===
 
=== My Gamebuino won't turn on ===
 +
* There is no start up sound
 +
** '''Solution to most of the problems''' : You may not have a program loaded in your Gamebuino, or you may have a corrupted program if something went wrong while loading a program. To solve that problem '''hold the C button down, turn your Gamebuino on, release C, and wait 30 seconds'''. What it does it that it force your Gamebuino to flash LOADER.HEX from the micro SD card.Note that nothing will appear on the screen during these 30 seconds, it's normal. You can also upload one of the Gamebuino examples through USB using the Arduino IDE.
 +
** Your Gamebuino may be out of battery: turn your Gamebuino off, and plug it in (the "charging" led should turn on) for about one hour and try again.
 +
** If a micro SD card is present, check that the C button is not jammed in the pressed position, or LOADER.HEX will be continuously re-flashed.
 
* I hear the start up sound
 
* I hear the start up sound
 
** If you hear the start-up sound but the screen don't show anything, then it's a screen issue.
 
** If you hear the start-up sound but the screen don't show anything, then it's a screen issue.
* There is no start up sound
+
 
** You may be out of battery: turn your Gamebuino off, and plug it in (the "charging" led should turn on) for about one hour and try again.
 
** You may not have a program loaded in your Gamebuino, or a corrupted program if something went wrong while loading. To solve that problem upload on of the Gamebuino example through USB using the Arduino IDE. You can also press C while you turn your Gamebuino on to flash LOADER.HEX from the micro SD card.
 
** If a micro SD card is present, check that the C button is not jammed in the pressed position, or LOADER.HEX will be continuously re-flashed.
 
 
== Screen ==
 
== Screen ==
=== Screen blank, dark, dim, random, etc. ===
+
=== Screen is blank, dark, dim, displaying randomly, etc. ===
 
[[File:Setting_contrast.gif|right|thumb|How to adjust contrast. Don't forget to select "save" when you're done.]]
 
[[File:Setting_contrast.gif|right|thumb|How to adjust contrast. Don't forget to select "save" when you're done.]]
* You can adjust the contrasts using the program SETTINGS.HEX located on the SD card. Note that contrast can't be adjusted on some screens.
+
* You can adjust the contrast using the program SETTINGS.HEX located on the SD card. Note that contrast can't be adjusted on some screens.
 
If it doesn't solve your problem, it's probably a bad contact between the screen and the PCB.
 
If it doesn't solve your problem, it's probably a bad contact between the screen and the PCB.
 
* Pinch the top of the screen to improve the contact with the PCB
 
* Pinch the top of the screen to improve the contact with the PCB
 
* Check that the screen is correctly snapped to the PCB
 
* Check that the screen is correctly snapped to the PCB
* Check the screen holder is in place to prevent the screen from moving (see picture on the right).
 
 
[[File:Screen_holder.PNG|thumb|right|The screen holder part, highlighted in blue.]]
 
[[File:Screen_holder.PNG|thumb|right|The screen holder part, highlighted in blue.]]
 
* The screen might have moved and the contacts are now misaligned. Try to gently push the screen upward/downward/leftward/rightward and restart the Gamebuino until the contacts are correctly aligned and you can see something.
 
* The screen might have moved and the contacts are now misaligned. Try to gently push the screen upward/downward/leftward/rightward and restart the Gamebuino until the contacts are correctly aligned and you can see something.
 
* Sometimes some dust gets in between the screen and the PCB. Clean the rubberized contact on the back of the screen using alcohol with a piece of soft fabric
 
* Sometimes some dust gets in between the screen and the PCB. Clean the rubberized contact on the back of the screen using alcohol with a piece of soft fabric
 +
* Check the screen holder is in place to prevent the screen from moving (see picture on the right). Note : the screen holder has now been replaced by a grey rubber pad stuck on the upper part of the screen so the pressure is more even and it limits PCB bending.
  
 
=== Scratched screen ===
 
=== Scratched screen ===
These screens are recycled from older cell phones so they often have tiny nicks or scratches. There's no such thing as a 'new' Nokia 5110 display, but the scratches should not be noticeable when in use.
+
These screens are recycled from old cell phones so they often have tiny nicks or scratches. There's no such thing as a 'new' Nokia 5110 display, but the scratches should not be noticeable when in use.
 
 
 
=== Change the screen ===
 
=== Change the screen ===
 
If you want to get another screen you can buy them for as low as [http://www.ebay.com/sch/i.html?_sacat=0&_from=R40&_nkw=bare+5110+screen&LH_PrefLoc=2&rt=nc&LH_BIN=1 2€ on eBay] (including shipping). To swap to another screen you just have to unscrew your Gamebuino and snap the screen off the PCB, it's very simple.
 
If you want to get another screen you can buy them for as low as [http://www.ebay.com/sch/i.html?_sacat=0&_from=R40&_nkw=bare+5110+screen&LH_PrefLoc=2&rt=nc&LH_BIN=1 2€ on eBay] (including shipping). To swap to another screen you just have to unscrew your Gamebuino and snap the screen off the PCB, it's very simple.
Line 33: Line 33:
 
=== The loader says "Please insert an SD card" ===
 
=== The loader says "Please insert an SD card" ===
 
* Check that the micro SD card is correctly inserted, obviously.
 
* Check that the micro SD card is correctly inserted, obviously.
 +
* Check that there are files on the card. You need at least <code>LOADER.HEX</code> and <code>SETTINGS.HEX</code>. Download them here along with some games : [https://github.com/Rodot/Gamebuino-Games-Compilation Gamebuino-Games-Compilation]
 +
 
* Try another micro SD card (2GB or below) to see if it's a compatibility issue.
 
* Try another micro SD card (2GB or below) to see if it's a compatibility issue.
* Try to re-format the micro SD card to FAT16 (aka FAT).
+
* Try to format the micro SD card to FAT16 (aka FAT). Don't forget to copy the <code>.HEX</code> files back on the micro SD card afterward (see download link above).
 +
 
 
=== Won't load the game I select in the loader ===
 
=== Won't load the game I select in the loader ===
* Your games have to be name must be 8 characters long or shorter with only capitals. The extension must be HEX. for example CRABATOR.HEX or PONG.HEX
+
* Your game's name must be 8 characters long or shorter with only capitals. The extension must be HEX. for example CRABATOR.HEX or PONG.HEX
* You have formatted your micro SD card in the wrong format (see How to format my micro SD).
+
* You have formatted your micro SD card in the wrong format (see "How to format the micro SD" below).
 
* The file you try to load might be corrupted, try to upload it again on the micro SD card.
 
* The file you try to load might be corrupted, try to upload it again on the micro SD card.
 
=== Won't get back to the loader when I press C ===
 
=== Won't get back to the loader when I press C ===
* When you press 'C' when in the title screen, it loads LOADER.HEX for you to be able to browse games. But some programmers don't allow you to get back to the title screen once the game is started, so you have to turn you Gamebuino off then back on.
+
* When you press 'C' when in the title screen, it loads LOADER.HEX for you to be able to browse games. However, some programs don't allow you to get back to the title screen once the game is started, so you have to turn your Gamebuino off and back on again.
* Some programmer don't use the official library so you are not able to press 'C' in the titleScreen to get back to the loader. You can turn your Gamebuino off, hold 'C' down, turn it on, wait for a second and release 'C'. The screen will stay blank for up to 20 seconds while it loads your game. Don't turn off your Gamebuino while it's loading a game.
+
* Some programmers don't use the official library so you are not able to press 'C' in the titleScreen to get back to the loader. You can turn your Gamebuino off, hold 'C' down, turn it on, wait for a second, and then release 'C'. The screen will stay blank for up to 20 seconds while it loads your game. Don't turn off your Gamebuino while it's loading a game.
 
* LOADER.HEX might be corrupted, download it again from [https://github.com/Rodot/Gamebuino/tree/master/hex_files GitHub] and upload it on your micro SD card.
 
* LOADER.HEX might be corrupted, download it again from [https://github.com/Rodot/Gamebuino/tree/master/hex_files GitHub] and upload it on your micro SD card.
 
* You have formatted your micro SD card in the wrong format (see How to format my micro SD).
 
* You have formatted your micro SD card in the wrong format (see How to format my micro SD).
 
=== My Gamebuino hangs while loading a game ===
 
=== My Gamebuino hangs while loading a game ===
When you select a game to flash from the micro SD card on your Gamebuino, it shows "Flashing game don't turn off" for up to 20 seconds. If after a while the screen goes blank and nothing happens, there was an error during flashing.
+
When you select a game to flash from the micro SD card on your Gamebuino, it shows "Flashing game... DON'T TURN OFF!" for up to 20 seconds. If after a while the screen goes blank and nothing happens, there was an error during flashing.
* Now you have a corrupted program on your Gamebuino so it won't start up again. Don't worry, to solve that problem upload on of the Gamebuino example through USB using the Arduino IDE.
+
* Now you have a corrupted program on your Gamebuino so it won't start up again. Don't worry, to solve that problem upload one of the Gamebuino examples via USB using the Arduino IDE.
 
* If it happens again, try with another micro SD card. You might also want to try to burn the [http://gamebuino.com/forum/viewtopic.php?f=12&t=932 experimental bootloader v2.0] which solves some compatibility issues.
 
* If it happens again, try with another micro SD card. You might also want to try to burn the [http://gamebuino.com/forum/viewtopic.php?f=12&t=932 experimental bootloader v2.0] which solves some compatibility issues.
=== How to format my micro SD card ===
+
=== How to format the micro SD card ===
 
The micro SD card must be 2GB or less to be compatible with the bootloader. You have to format it in FAT16 (aka FAT) format.
 
The micro SD card must be 2GB or less to be compatible with the bootloader. You have to format it in FAT16 (aka FAT) format.
 
* Insert the micro SD card in the micro SD card reader, then plug the reader in your computer.
 
* Insert the micro SD card in the micro SD card reader, then plug the reader in your computer.
Line 54: Line 57:
 
*** Open "Computer", right click on the micro SD card, then click on "Format...". Select the "FAT" format (not FAT32).
 
*** Open "Computer", right click on the micro SD card, then click on "Format...". Select the "FAT" format (not FAT32).
 
*** Alternative: run the command <code>format F: /q /fs:FAT /v:GAMEBUINO</code> (replace F: with the letter of your device)
 
*** Alternative: run the command <code>format F: /q /fs:FAT /v:GAMEBUINO</code> (replace F: with the letter of your device)
 +
** Linux users
 +
*** open a terminal
 +
*** type lsblk to check the device, so the /dev/sdXn
 +
*** as root (replacing the /dev/sdXn with your device), run <code>mkfs.vfat -F 16 /dev/sdXn</code>
 +
 
== USB ==
 
== USB ==
 
=== Device not detected ===
 
=== Device not detected ===
 
* Check that you correctly installed the drivers
 
* Check that you correctly installed the drivers
 
* Try with another USB cable
 
* Try with another USB cable

Latest revision as of 2015-04-07T14:19:05

This page is meant to help you sort out the problems you may encounter. If you've been through this page (and the Getting started page) and didn't find any answers, then you can:


Boot

My Gamebuino won't turn on

  • There is no start up sound
    • Solution to most of the problems : You may not have a program loaded in your Gamebuino, or you may have a corrupted program if something went wrong while loading a program. To solve that problem hold the C button down, turn your Gamebuino on, release C, and wait 30 seconds. What it does it that it force your Gamebuino to flash LOADER.HEX from the micro SD card.Note that nothing will appear on the screen during these 30 seconds, it's normal. You can also upload one of the Gamebuino examples through USB using the Arduino IDE.
    • Your Gamebuino may be out of battery: turn your Gamebuino off, and plug it in (the "charging" led should turn on) for about one hour and try again.
    • If a micro SD card is present, check that the C button is not jammed in the pressed position, or LOADER.HEX will be continuously re-flashed.
  • I hear the start up sound
    • If you hear the start-up sound but the screen don't show anything, then it's a screen issue.

Screen

Screen is blank, dark, dim, displaying randomly, etc.

Error creating thumbnail: Unable to save thumbnail to destination
How to adjust contrast. Don't forget to select "save" when you're done.
  • You can adjust the contrast using the program SETTINGS.HEX located on the SD card. Note that contrast can't be adjusted on some screens.

If it doesn't solve your problem, it's probably a bad contact between the screen and the PCB.

  • Pinch the top of the screen to improve the contact with the PCB
  • Check that the screen is correctly snapped to the PCB
Error creating thumbnail: Unable to save thumbnail to destination
The screen holder part, highlighted in blue.
  • The screen might have moved and the contacts are now misaligned. Try to gently push the screen upward/downward/leftward/rightward and restart the Gamebuino until the contacts are correctly aligned and you can see something.
  • Sometimes some dust gets in between the screen and the PCB. Clean the rubberized contact on the back of the screen using alcohol with a piece of soft fabric
  • Check the screen holder is in place to prevent the screen from moving (see picture on the right). Note : the screen holder has now been replaced by a grey rubber pad stuck on the upper part of the screen so the pressure is more even and it limits PCB bending.

Scratched screen

These screens are recycled from old cell phones so they often have tiny nicks or scratches. There's no such thing as a 'new' Nokia 5110 display, but the scratches should not be noticeable when in use.

Change the screen

If you want to get another screen you can buy them for as low as 2€ on eBay (including shipping). To swap to another screen you just have to unscrew your Gamebuino and snap the screen off the PCB, it's very simple.

SD card

The loader says "Please insert an SD card"

  • Check that the micro SD card is correctly inserted, obviously.
  • Check that there are files on the card. You need at least LOADER.HEX and SETTINGS.HEX. Download them here along with some games : Gamebuino-Games-Compilation
  • Try another micro SD card (2GB or below) to see if it's a compatibility issue.
  • Try to format the micro SD card to FAT16 (aka FAT). Don't forget to copy the .HEX files back on the micro SD card afterward (see download link above).

Won't load the game I select in the loader

  • Your game's name must be 8 characters long or shorter with only capitals. The extension must be HEX. for example CRABATOR.HEX or PONG.HEX
  • You have formatted your micro SD card in the wrong format (see "How to format the micro SD" below).
  • The file you try to load might be corrupted, try to upload it again on the micro SD card.

Won't get back to the loader when I press C

  • When you press 'C' when in the title screen, it loads LOADER.HEX for you to be able to browse games. However, some programs don't allow you to get back to the title screen once the game is started, so you have to turn your Gamebuino off and back on again.
  • Some programmers don't use the official library so you are not able to press 'C' in the titleScreen to get back to the loader. You can turn your Gamebuino off, hold 'C' down, turn it on, wait for a second, and then release 'C'. The screen will stay blank for up to 20 seconds while it loads your game. Don't turn off your Gamebuino while it's loading a game.
  • LOADER.HEX might be corrupted, download it again from GitHub and upload it on your micro SD card.
  • You have formatted your micro SD card in the wrong format (see How to format my micro SD).

My Gamebuino hangs while loading a game

When you select a game to flash from the micro SD card on your Gamebuino, it shows "Flashing game... DON'T TURN OFF!" for up to 20 seconds. If after a while the screen goes blank and nothing happens, there was an error during flashing.

  • Now you have a corrupted program on your Gamebuino so it won't start up again. Don't worry, to solve that problem upload one of the Gamebuino examples via USB using the Arduino IDE.
  • If it happens again, try with another micro SD card. You might also want to try to burn the experimental bootloader v2.0 which solves some compatibility issues.

How to format the micro SD card

The micro SD card must be 2GB or less to be compatible with the bootloader. You have to format it in FAT16 (aka FAT) format.

  • Insert the micro SD card in the micro SD card reader, then plug the reader in your computer.
    • Windows users
      • Open "Computer", right click on the micro SD card, then click on "Format...". Select the "FAT" format (not FAT32).
      • Alternative: run the command format F: /q /fs:FAT /v:GAMEBUINO (replace F: with the letter of your device)
    • Linux users
      • open a terminal
      • type lsblk to check the device, so the /dev/sdXn
      • as root (replacing the /dev/sdXn with your device), run mkfs.vfat -F 16 /dev/sdXn

USB

Device not detected

  • Check that you correctly installed the drivers
  • Try with another USB cable