MIT License

项目介绍

Chris-Johnston/BinaryKeyboard 是一个托管在 GitHub 上的开源项目,主要使用 Arduino 编写,采用 MIT License 许可证,目前获得 143 个 Star、6 次 Fork。

仓库全名
Chris-Johnston/BinaryKeyboard
开源许可证
MIT License
Star 数
143
Fork 数
6
未关闭 Issue
1

README 摘要

BinaryKeyboard A two-button backlit mechanical keyboard that types ASCII values, one bit at a time. Photos GIFS Typing the backspace character, followed by switching between modes. Demonstrating left to right input. New animations added to '1/0' mode. (Still working on a name for that). Demonstrating compatibility with USB OTG. Boot up sequence. Demonstrating right to left input. Demonstrating switching between…

完整内容见 GitHub 原始 README 或本页 。

常见问题

BinaryKeyboard 用什么语言开发?

主要使用 Arduino 编写,采用 MIT License 许可证,目前有 143 个 Star。

BinaryKeyboard 可以免费商用吗?

仓库采用 MIT License 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 BinaryKeyboard 的源码?

可以直接克隆仓库:git clone https://github.com/Chris-Johnston/BinaryKeyboard.git,默认分支为 master;安装与运行步骤见仓库 README。

BinaryKeyboard 最近还在维护吗?

仓库最近一次更新为 2017年12月21日,当前有 1 个未关闭 Issue;Star 数为 143,可作为社区活跃度的参考。

关于

GitHub 原始描述(英文)

A keyboard with two buttons that types in binary.

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

简要分析

热度分
162
价值分
88
活跃状态
活跃

语言占比

Arduino
C

README

BinaryKeyboard

A two-button backlit mechanical keyboard that types ASCII values, one bit at a time.

Photos

Photo of Binary Keyboard Photo of Screen Top Down Photo

GIFS

Mode switching and typing backspace

Typing the backspace character, followed by switching between modes.

Demonstrating left to right input

Demonstrating left to right input.

Showing off animations in updated alternate mode

New animations added to ‘1/0’ mode. (Still working on a name for that).

Sample input using phone

Demonstrating compatibility with USB OTG.

Boot up sequence

Boot up sequence.

Normal use

Demonstrating right to left input.

Switching modes

Demonstrating switching between typing modes.

Fancy backlighting

Close-up of the blue led backlit keys.

Technical Info

Schematic

Image of Schematic

Components

Arduino Library Requirements

These libraries are used to drive the SSD1306 OLED display.

Eagle Schematic Details

Because I could not locate a part to represent the SSD1306 OLED Display, I created my own. This can be found in the CSJ Library file for Eagle. A word of warning, this was my first time using Eagle. The part works, but could be improved.

Uses c0z3n/cherrymx-eagle library as well.

Usage

Each byte can either be typed from most significant bit to least significant bit (left to right), or least significant bit to most significant bit (right to left). This is configured before compiling and uploading to the board. After all 8 bits have been entered, it will type out the ASCII value equivalent of that binary value. The Pro Micro has USB HID support, which means it acts just like any other keyboard.

If both keys are held down, the keyboard will switch to “1/0 mode” / “single button press mode” (I’m bad at names). In this mode, each key will represent a ‘1’ or a ‘0’ just like on a traditional keyboard, no binary involved.

Arduino Problems

Initially I was going to use a DigiStump board for this, but I found issues with not having enough memory to work with after importing libraries and not enough I/O. I’m using an Arduino Pro Micro knockoff. The reason that there is electrical tape covering it is because I found that shorting the contacts with a finger would cause it to stop working. I’m still not really sure why.

Keyboard Class Limitations

This project relies on the Arduino Keyboard library to handle all USB HID support. It works great for printing standard characters and most operations, however, a downside of using this means that not all ASCII values are supported. Most of the values below 0x20 are not actually supported.

User dtwilliamson added a feature that repurposes these values as control commands. Here is a list of some control key commands.

The functionality of Backspace, Tab, and Enter is still preserved by setting HID_MODE to true.

Binary HID_MODE false HID_MODE true
00000001 L_CTRL + A L_CTRL + A
00000010 L_CTRL + B L_CTRL + B
00001000 L_CTRL + H Backspace
00001001 L_CTRL + I Tab
00001010 L_CTRL + J Enter
00100000 (whitespace) (whitespace)
00100001 ! !
01100001 a a
01000001 A A

Note that CTRL+H, CTRL+I, and CTRL+J function the same in a Unix command line as the keys do. Up to you which setting to use. HID_MODE true works just fine in Windows and the GNOME desktop environment.

Contribution and Modifications

Please feel free to fork this project for your own purposes. If you build one, I would love to see it!

If you have suggestions/improvements/feedback/bug reports/etc., submitting a pull request or an issue through GitHub is the best way to contribute.

Acknowledgments

Special thanks goes to everyone in the UWB Makerspace that helped make this possible.

Pixel art for screen animations by @Omrii_ https://github.com/OmriN7.

Please see the Binary Keyboard contributors page for a list of contributors. Many thanks to each of you for your support!

评论

暂无评论