Skip to content

Latest commit

 

History

History
124 lines (65 loc) · 2.83 KB

BOSSA.md

File metadata and controls

124 lines (65 loc) · 2.83 KB

Prereq

Do you really need to unbrick your keyboard?

This guide will only help if the orange flashing LED will not activate even after pressing the flash button.

Supported boards

Keyboards with sam4s based chips

  • Kira
  • RE:Type
  • Gemini Dawn / Dusk

Note: If your keyboard has multiple USB (out) ports, only one will function for BOSSA. Please try both ports if one doesn't function.

Erasing

!> This procedure has the posiblity of leaving your keyboard in a bad state if you do not complete all steps. Proceed at your own caution!

  • Begin by making sure your keyboard is plugged in to power.
  • Using tweezers or another metal object to touch the two erase pads together for 30 seconds.

erase

  • Unplug the keyboard and plug it back in.

Detecting the device

The flash mode led should be a faint orange at this point.

led

You can confirm the keyboard is detected by following the steps for your system below.

** Windows **

On windows Device Manager will show a bossa com port

com

** Mac **

On Mac System Information should show an "Communication Device" made by Atmel under USB -> USB Bus.

mac

** Linux **

On linux lsusb should show a device called "SAMBA bootloader"

Bus 003 Device 017: ID 03eb:6124 Atmel Corp. at91sam SAMBA bootloader

Installing BOSSA

** Windows **

bossa-install-win

** Mac **

bossa-install-osx

  • Launch the BOSSA application

bossa-app-osx

** Linux **

  • Install the 'bossa' aur package.

  • Run sudo bossa from a terminal.

Flashing the bootloader

  • Download the appropriate bootloader.bin file from here: Controller .bin Files
  • Select the the Serial Port.

bossa-port

  • Press Browse

  • Select the kiibohd_bootloader.bin file and press Open.

bossa-file

If an error pops up, press "Continue"

bossa-error

  • Wait for the programming to complete

bossa-progress

bossa-complete

  • Unplug and replug in your keyboard

Flashing the firmware

The flashing led should be lit brightly.

flash-led

You can now follow the Quickstart guide to flash your keyboard with the Configurator.