Skip to content

bjartek/atreus-firmware

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Atreus keyboard firmware

This repository contains firmware (called TMK) loaded into its controller to make the keyboard function. You can also use it to customize its layout or behavior. This branch makes use of the latest TMK release.

The main differences are:

  • Uses the latest branch of TMK
  • Makes use of actions codes, vs. keymaps.
  • Media keys enabled in build.
  • Updated keymap macros so keymaps are very easy to define.
  • The layers are not the same. I've been experimenting with it.
  • Try to guess the USB interface based upon uname, using usbmodem1441 on mac
  • If there is a keymap file that is the same as your username it is chosen by default
  • Move macros defined by alex/audibleblink and bjartek/me into common.h

Installing on Mac OS X

Install homebrew

$ brew tap osx-cross/avr
$ brew install avrdude
$ brew install teensy_loader_cli
$ brew install avr-libc
$ cd atreus
$ make upload KEYMAP=qwerty

Layout

Copy keymap_qwerty.c (or another) into a new file (if you name this file keymap_.c it will be chosen by default) to create your new layout, and change the keymaps array to place the actioncodes you want in the positions you want.

The FN_ARROW_LAYER and LAYER_TWO macros correspond to the default extra layers as defined in keymap_common.h; replace them with KEYMAP calls if you want to customize these layers.

Look into keymap_common.h for some macros that make it easier to map keys. For more details see the TMK documentation.

Compiling

This codebase defaults to targeting the most recent PCB-based design of the Atreus which uses the A-Star microcontroller, but it can also work with hand-wired boards that use the Teensy 2.

Keymaps are per default your username if it exists or qwerty.

USB interface on mac is usbmodem1441, else ttyACM0

Uploading to a Teensy 2 can be done with OPT_DEFS=-DTEENSY make teensy KEYMAP=qwerty.

Getting to the bootloader on the Teensy is simpler; if you can't do it in software simply press the hardware reset button once.

Bjartek layout

  • based upon norwegian layout in os since that is what all my coworkers use
  • layer 1 is idea shortcuts on the left and special characters on the right
  • layer 2 is movement keys on the left and numpad on the right
  • layer 3 is f keys on the left and mousepad on the right
  • all mods are oneshot
  • all layers are switched with holding down a key

About

Firmware for the atreus keyboard

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 86.3%
  • C++ 8.3%
  • Assembly 3.5%
  • Python 0.7%
  • HTML 0.6%
  • Makefile 0.4%
  • Other 0.2%