4.6 KiB

Flashing a new micro-SD card

The following steps describe how to flash a micro-SD card with the latest version of FunKey-OS. This must be done before switching micro-SD cards inside the console.

Note: Everything on the micro-SD card will be lost, be sure to save your data.

Download the latest FunKey-OS image file

Get the latest "FunKey-rootfs-x.y.z.img" SD card image file directly from here or from the bottom of the latest release page in the "assets" section:

https://github.com/FunKey-Project/FunKey-OS/releases/latest

Github Release{: .lightbox}

Flash the micro-SD card with balenaEtcher

  • Download and install balenaEtcher for Windows/Mac OS/Linux from balena.io.

  • Run balenaEtcher and click on "Flash from file" to select the FunKey-OS image file

  • Insert the micro-SD card in your computer and select the SD card drive (balenaEtcher should automatically detect it for you)

  • Finally, click Flash

  • You'll see a progress bar. Once complete, make sure the flashing was successful, otherwise retry to flash the SD card. The program will automatically unmount the SD card so it's safe to remove it from your computer.

    balenaEtcher{: .lightbox}


Switching micro-SD cards

On the FunKey S, the micro-SD card was voluntarily placed against the casing so that it has no degree of liberty and cannot move by accident during the eventful life of a keychain. Removing/switching the micro-SD card was nevertheless designed to be pretty straightforward and only require a standard Phillips screwdriver (PH0). Please follow the steps below carefully.

Display Action
removeScrews{: .lightbox width=240}removeScrews{: .lightbox width=240}removeScrews{: .lightbox width=240} STEP 1 - Removing the screws
Using a standard PH0 screwdriver, remove the 2 screws on the back of your FunKey S.
Be careful to use the correct screwdriver head size not to damage the screws.
removeBack{: .lightbox width=240}removeBack{: .lightbox width=240}removeBack{: .lightbox width=240} STEP 2 - Opening up the console
Carefully remove:
1) The plastic back of the console by pulling from the side of the hinge first.
2) The keychain lanyard and axis.
3) The LR plastic buttons by gently pulling them out of their axis. Be careful not to damage the switch on the circuit board.
removeBattery{: .lightbox width=240}removeBattery{: .lightbox width=240} STEP 3 - Exposing the circuit board
Pull back the battery (leave it connected) to expose the circuit board.
pullPCB{: .lightbox width=240} STEP 4 - Accessing the SD card
By grabbing it by the micro-USB port, gently pull the circuit board towards you until you have access to the SD card.
removeSD{: .lightbox width=240}removeSD{: .lightbox width=240} STEP 5 - Switching SD cards
You can now remove the old micro-SD card from its socket and insert the new one (previously flashed as described in the 1st part of this tutorial).
checkSpeaker{: .lightbox width=240}checkSpeaker{: .lightbox width=240} STEP 6 - Reassembly
Before putting back down the circuit board in the case, please make sure the speaker on the circuit board is already inserted in the casing. If not, then insert it first like in the pictures.
Reassemble the console by following the previous steps backwards.
Be careful no to damage the switches on the circuit board when putting back the LR plastic buttons.

--8<-- includes/glossary.md --8<--