Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
Dockerfile.archlinux
Dockerfile.ubuntu
README.md
all.bash
archlinux.bash
common.bash
docker.bash
ubuntu.bash

README.md

Kiibohd Controller - Dockerfiles

Instead of installing all of the dependencies manually, it's recommended to use a Dockerfile to install all the necessary dependencies automatically.

Setting up Docker

You'll need to setup Docker for your system. This is usually pretty straight-forward if you haven't already installed it.

Linux

Usually this just entails installing the docker package and starting the docker service. You'll also want to enable non-root access to the docker daemon.

After you're finished, make sure you're able to run docker info in your terminal window.

macOS

After you're finished, make sure you're able to run docker info in your terminal window.

Windows

After you're finished, make sure you're able to run docker info in your terminal window.

Using a Dockerfile

Using a terminal where you can successfully call docker info run the following commands. The Ubuntu Environment is the default supported environment. However, most developers are using Arch Linux for their testing.

Ubuntu Environment

To generate the environment, only need to do this once, or whenever you update the git repo.

cd controller/Dockerfiles
docker build -f Dockerfile.ubuntu -t controller.ubuntu .
cd ..

To enter the build environment.

docker run -it --rm -v "$(pwd):/controller" controller.ubuntu

To exit the docker environment.

exit

Arch Linux Environment

To generate the environment, only need to do this once, or whenever you update the git repo.

cd controller/Dockerfiles
docker build -f Dockerfile.archlinux -t controller.archlinux .
cd ..

To enter the build environment.

docker run -it --rm -v "$(pwd):/controller" controller.archlinux

To exit the docker environment.

exit

Building Firmware

Once in the docker environment, you'll already be inside the Keyboards folder. So you can just build firmware for a keyboard.

./k-type.bash

The contents will be located in linux-gnu.K-Type.gcc.ninja.

Files