The default buttons->keypresses will be satisfactory for most projects. However, you may want to customize those keys so when a GPIO pin is pulled to ground, a different keystroke is sent. It isn't that difficult to do!

Bluefruit v1.1 (Oct 22, 2013 or later) supports over-the-air key remapping and also you can map the pins to mouse movement or mouse clicks

Bluefruit v1.2 (Nov 7 2013 or later) - We have added support for mapping buttons to some "Consumer Report" keys, also known as Multimedia buttons. You can use the graphical remapper for the consumer keys.

Over-the-air remapping is suggested since there's no wiring required and you can do it at any time. You just need to make sure the Bluefruit is paired to your computer. It's been tested on Mac and Windows but should also work on Linux.

You'll need to install Processing v1.5.1 to run the remapper. We suggest 1.5.1, 2.0+ may not work. If v1.5 is giving you problems, though, try v2!

You will also need to download and install the ControlP5 library:

Then download the zip with the wireless remapper code

Uncompress and open the GUI_EZKey_remapper.pde in Processing.
Make sure the Bluefruit is paired to your computer, since we need to be paired in order to send it the new keycodes

Select Sketch -> Run or click the play button to start the graphical remapper

You can now select the pins and then using the menus below select what mouse/keyboard/consumer reports you want. Mouse reports can be X movement, Y movement, wheel, and three different buttons in any combination. Keyboard reports can be up to 6 keystroke commands, with modifiers, ascii-type, non-printing, etc. Consumer reports are special commands, such as volume up, volume down, iPhone keyboard display/hide and cannot be mixed or combined unlike mouse & Keyboard.

You can also save and load your keymap which is handy for trying out different mappings!

When you're done, click SEND_MAP to send it to your Bluefruit. In the main Processing window you should see the text report indicate that it found a Bluefruit and also that it sent data with a Checksum Match

"Text style" over-the-air remapper

The original remapper is a Processing sketch that requires editing the reports by hand. While this is the most powerful, most people may be happier with the graphical remapper above. Still, for more advanced users, you can edit the reports per button with more flexibility here.

Uncompress and open the HID_EZKey_remapper.pde in Processing.
Make sure the Bluefruit is paired to your computer, since we need to be paired in order to send it the new keycodes

Select Sketch -> Run or click the play button

You should see the text report indicate that it found a Bluefruit and also that it sent data with a Checksum Match

That's it, you can use it immediately with the new keymap!