Skip to content

Latest commit

 

History

History
106 lines (78 loc) · 2.64 KB

README.md

File metadata and controls

106 lines (78 loc) · 2.64 KB
Raw

keyboard

Setup arduino-cli

Follow the instructions on the website of Arduino to setup arduino-cli:

sudo pacman -S arduino-cli

After this, you need to install your board. In my case, this is the Atreus of keyboardio. To install the board, run:

arduino-cli core install keyboardio:avr

Configuration

Place the following config at ~/.arduino15/arduino-cli.yaml:

board_manager:
  additional_urls:
    - https://raw.githubusercontent.com/keyboardio/arduino-kaleidoscope-master/main/package_kaleidoscope_master_index.json
daemon:
  port: "50051"
directories:
  data: $HOME/.arduino15
  downloads: $HOME/.arduino15/staging
  user: $HOME/Arduino
library:
  enable_unsafe_install: false
logging:
  file:
  format: text
  level: debug
metrics:
  addr: :9090
  enabled: true
output:
  no_color: false
sketch:
  always_export_binaries: true
updater:
  enable_notification: true

Chances are that you need to change some details in the config file.

Compiling

Follow the instructions on the site of kaleidoscope to enable compiling and uploading *.ino sketches to the keyboard.

The compile script will do the following:

  • Create a header file that may contain macros with personal info. This header need to be completed by the user before compiling. After creation, compilation is aborted.
  • If the personal_macros.h file exists, arduino-cli will be called to compile the sketch.

Uploading

Similarly to the compile script, the upload script uploads the firmware to the keyboard. Make sure you hold the left key on the bottom row during uploading (in case of the Atreus). This will put the keyboard in "program mode".

If you encounter a permission error for accessing the /dev/ttyACM0 device, you can solve this in two ways:

  1. Run the script as root:

     sudo ./upload --config-file $HOME/.arduino15/arduino-cli.yaml

  2. Run the following command:

    sudo chmod a+rw /dev/ttyACM0

    Which will give all users read and write permissions to the device.

Version tags

  • Major increase means a breaking change.
  • Minor increase means a change in keymaps was done.
  • Patch increase means a code improvement

Tips

  • Factory reset the Atreus using Chrysalis before uploading sketches for the first time.
  • In neovim add the arduino-language-server using lsp-config.
  • Save a backup of your latest layout using Chrysalis.