Giter Site home page Giter Site logo

bb9900-usb_ble_keyboard's Introduction

BB9900-USB_BLE_Keyboard

View1 View1
Last update about this documentation: 2024.03.27
2024.03.24 update: uploaded 3D model
2024.03.27 update: uploaded How to customize your own keymap

About this keyboard
Before you buy/use
How to use this keyboard
Concept of Layer
Keymap
What to do when you first get this keyboard
Multidevice Connect
How to delete the pairing
USB&BLE Output select
Backlight/LED control
How to update the firmware
Troubleshoot
Some tipps for using this keyboard
iphone or IOS users
Andriod users
Others
Dimensions
Weight
How to correctly assemble the battery

This mini Keyboard uses the original Blackberry 9900 keyboard with Trackpad and powered by the NRF52840 Microcontroller and operates under modified ZMK Firmware.

A Brief Video of using this tiny keyboard
How to connect the keyboard with a device

Here are some main Features:
Processor: NRF52840 from Nordic Semiconductor
Firmware: Modified ZMK Firmware.source code
Swapable battery Design: Replace your battery in 10 seconds.
Battery type: Nokia BL-5B. You can buy it anywhere in the world.
Long battery life: The keyboard can work more than 3 months when normally used without recharging.
Mouse and scroll wheel 2 in 1: When enable Capslock, the trackpad works as scroll wheel.
Compatible with all platform: Android, Apple, Windows, Linux, Steamdeck or even Car(tested work OK on Lixiang L9 max) as long as your device has Bluetooth modul.
On board charging circuit: The USB-C port can not only be used for data transmitting but also can be used for charging battery
USB&BLE Output: Support both wired and wireless connect.
Shoulder keys: There are two shoulder keys on top side of the keyboard which can be used as mouse left and right keys.
Multidevice connect: The keyboard can be paired with up to 4 devices at the same and can be switched between them easily.

Bluetooth version check: This keyboard can only be paired wirelessly with devices that have BLE 5.0 modul or higher, please check if your device have the right Bluetooth modul, otherwise the keyboard can not work with your device wirelessly!
How to check the Bluetooth version of your device: google (your device name) like iphone 8 and plus Bluetooth version and you will find the answer like this: BLE VERSION CHECK

About the battery: If you want to buy the keyboard, you will need to buy the battery yourself because of the international shipping policy of Lithium battery from DHL. The Battery type that you need to buy is BL-5B. You can first check if you can buy it on your local Amazon or ebay webside. If there is not, you can buy the battery on Aliexpress. Just buy the cheapest one, in Europe the cheapest one will cost approximaltely 6 Euros. Here are some pictures of the battery price from Amazon, ebay and Aliexpress:
BL-5B on Amazon BL-5B on Ebay BL-5B on Ebay

Where to buy

Pay with US dollar: Tindie
Pay with Euro: Lectronz

Because of the limited number of keys on this tiny keyboard, there are many normal keys like characters or symbols and media keys that we want the keyboard to type out. By default I have set 3 layers on this keyboard, by pressing the layer toggle keys we can enter and exit the layer, at the same time the backlight under the 4 big button keys work as indicator for the current layer number. You can find more Information about it under Backlight/LED control When we power the keyboard on, we are at Layer 1: the QWERTY layer. By pressing the sym key on the right under area, we can enter Layer 2: now we can type out symbol and number like # 1 2 3 which is originally marked on the keyboard. The Layer3 contains some Bluetooth operation keys and other symbols.

The following pictures show the default keymap of the keyboard
BLE VERSION CHECK BLE VERSION CHECK BLE VERSION CHECK

Here are a few steps to connect the keyboard with your device when you first get hands on this keyboard:

  1. Put the battery into the keyboard: The pictures shows you how to correctly put the battery into the keyboard.
  2. Power the keyboard on by sliding the red switch to the right side:
  3. You can see the backlight under the keyboard area is turned on, press the aA key on the right under area to enter layer 3 and you can see the backlight under the pannel for the 4 big buttons starts to breath.
  4. Press the fitst big button on the left and double tap the trackpad: Now the keyboard has cleared the early pairing informations and is ready to pair with a new device. For the keyboard, this device is remembered as device 1.
  5. Check the Bluetooth setting on your device and pair with the kaybord and now you can type with the keyboard.

The keyboard can be paired with up to 4 devices and can be switch between them very quickly.
Here are a few steps showing how you connect the keyboard with a new device when you have already paired with a first device:

  1. Enter Layer 3 by pressing the aA key on the right under area and you can see the backlight under the pannel for the 4 big buttons starts to breath.
  2. Press the second or third or fourth big button key dependen on which number you want the keyboard to remember.
  3. Double tap the trackpad to clear the early pairing information to make sure it is now pairing with a new device.
  4. Operate on you device to pair with the keyboard
  5. If you want to switch to another device, enter layer 3 and press the big button that is match with your early operation, don't double tap the trackpad this time.

Out of range problem:
Assume that the keyboard is connected with 2 devices:device 1 and device 2. If you turn on the keyboard, the keyboard will first connect with device1.
And now you put the device 1 out of the communication range of the keyboard, then the keyboard will look for the device that is already paired, that would be the device 2 and stay connected with it.
If you put device 1 back into the communication range, the keyboard will still stay connected with device 2, if you want to type with device 1, you need reboot the keyboard or enter layer 3 and select BT device 1.

If you don't want the keyboard to connect with some device that you paired before, here are a few steps that you should do to delete the pairing:

  1. On the keyboard side: switch to the device that you want to delete by entering layer 3 and press the right big button.
  2. Go to the Bluetooth setting page of the device and delete the Bluetooth pairing with the keyboard.
  3. Now on the keyboard side: Enter Layer 3 and double tap the trackpad to delete the pairing information that is stored in the keyboard.
    In brief, if you want to delete the pairing, make sure to operate on both sides that the pairing information is deleted.

This keyboard supportes both USB and BLE output, here are some basic logics of the output select:

By default, output is sent to BLE when both USB and BLE are connected.

If the keyboard wasn't connected to any device or is out of the communication distance with a paired device, the output would be USB.

Once you toggle the output between USB and BLE by entering layer 3 and hold space key for more than a half second. The keyboard will remember this if you don't make any change for more than 10 seconds.

There are 4 LED controls on this keyboard:
1. Charging LED: the read led on the left side of the keyboard indicates if the battery of the keyboard is fully charged. When the battery is being charged, the light shows like this. When the battery is fully charged, the led will go out.
2. Keyboard backlight: When you power the keyboard on, the backlight of the QWERTY keyboard area will be turned on immediately. If the keyboard doesn't detect any key press for more than 30 seconds, the backlight will be turned off. Also the brightness of the backlight can be manuelly set. You can find the related action on layer 3. The brightness of the keyboard backlight is set at 40% by default. The brightness adjustment step in percent is 10%.
3. Big button backlight: The backlight of this area works as indicator of the current number of layer. At Layer 1, the backlight is turned off. At Layer2, the backlight is turned on. At Layer3, the backlight starts to breath.
4. Trackpad backlight: The backlight of the trackpad works as indicator of capslock. When capslock is on, the backlight will be turned on and also the trackpad will work as scroll wheel. You can now sweep your finger on the trackpad to quickly browse a webpage or file.

This keyboard uses the bootloader from nice!nano. Here are the steps that you need to do to update the firmware:

  1. Connect the keyboard with your computer with a cable with data transmitting wire.
  2. enter layer 3 and press the dollar key(left to the enter key).
  3. then your computer can find a storage device called NICENANO.
  4. drag the new firmware(.uf2 file) into the storage device and it's OK.
    PS:If there is an error showing from your computer after you drag the new .uf2 file, don't worry just ignore it.

I can type but the trackpad isn't working, what should I do?
First reboot the keyboard and see if the trackpad works. If not, enter Layer 3 and press t to check if the trackpad works.

I find that the mouse moves slower than my finger movement, what should I do?
Restart the keyboard.

I have paired successfully with my device, but I can't type anything and there is no mouse movement, what's wrong?
Maybe you toggled the USB/BLE output by mistake, Enter layer 3, press and hold space key for more than 500ms and check if you can type now.

When I press capslock key, the mouse will keep moving forward a certain direction, what's wrong?
When you press the capslock key, try not to make movement on the trackpad. You can press the capslock key to make the keyboard back to normal.

I can't connect my device with the keyboard, what's wrong?
First check the bluetooth version of your device, make sure it is 5.0 or higher. If you paired the device with the keyboard before, make sure that on the keyboard side the early pairing information is deleted by entering layer 3 and double tap the trackpad.

(rarely on windows computer) On the Bluetooth setting page of the device the keyboard stays between connected and paired. What's wrong?
Something went wrong in the windows system, try to restart the computer, if that not works, delete the pairing from both sides and make the pairing again.

If you need to use trackpad as mouse or scroll wheel function on iphone or ipad, there are some settings that you need to do:

  1. Go to Settings-> Accessibility-> Touch-> AssistiveTouch -> enable AssistiveTouch and you can use touchpad as mouse on iphone or ipad
  2. Go to Settings-> General-> Keyboard-> Hardware Keyboard-> disable Cpas Lock Language Switch and you can use the trackpad as scroll wheel when capslock is on.

Shortcuts and commands:
In IOS you can edit shortcuts and commands with the keyboard. How to set:
Go to Settings-> Accessibility -> Keyboards-> Full Keyboard Access On-> Command and you can edit shortcuts or command using this keyboard.
for example you can set Ctrl+B as back. Sometimes you need to hit back twice to exit a page(that's the setting of IOS).

How to adjust the mouse speed:
If you find the trackpad moving too fast, you can adjust the spped of mouse in IOS. Here are the steps:
Go to Settings-> General ->Trackpad&Mouse and you can adjust the tracking speed, by disable Natural Scrolling you can reverse the scroll direction when the trackpad works as scroll wheel.

How to switch between different keyboard languages: You may need to switch between englich and some other language keyboard in IOS, You need to hold ctrl and press space key to switch.

How to switch between different keyboard languages: First try shift, then try Alt+shift, if not works, try Ctrl+shift. If none works, pull down from the top of the screen and manuelly switch.

Shortcuts: There are some useful shortcuts on android phones:
Hold blackberry key and press N to check messages.
Hold blackberry key and press enter to go Home desktop.
Hold alt and press tab(hang up key) to enter multiapp control.

PS: The scroll wheel function of the trackpoad is very useful when you watch tiktok shortvideos.

The picture below shows the outerline dimension of the keyboard
BLE VERSION CHECK
Thickness of the keyboard: 13.1mm

Without the battery the weight of the keyboard is 41.3 g.
With the battery the weight of the keyboard is 60.7 g.

First, remove the battery cover like this:
BLE VERSION CHECK
After removing the battery cover, you need to corretly insert the battery:
BLE VERSION CHECK BLE VERSION CHECK

bb9900-usb_ble_keyboard's People

Contributors

zitaotech avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.