.SILENT: .PHONY: \ build-feather \ circuitpy-deps \ circuitpy-freeze-kmk-nrf \ devdeps \ freeze-nrf-build-deps \ lint DOCKER_BASE_TAG ?= latest DOCKER_TAG ?= latest AMPY_PORT ?= /dev/ttyUSB0 AMPY_BAUD ?= 115200 AMPY_DELAY ?= 1.5 ARDUINO ?= /usr/share/arduino PIPENV ?= $(shell which pipenv) .docker_base: Dockerfile_base @echo "===> Building Docker base image kmkfw/base:${DOCKER_BASE_TAG}" @docker build -f Dockerfile_base -t kmkfw/base:${DOCKER_BASE_TAG} . @touch .docker_base docker-base: .docker_base docker-base-deploy: docker-base @echo "===> Pushing Docker base image kmkfw/base:${DOCKER_BASE_TAG} to Docker Hub" @docker push kmkfw/base:${DOCKER_BASE_TAG} .devdeps: Pipfile.lock @echo "===> Installing dependencies with pipenv" @$(PIPENV) install --dev --ignore-pipfile @touch .devdeps devdeps: .devdeps lint: devdeps @$(PIPENV) run flake8 fix-isort: devdeps @find kmk/ tests/ user_keymaps/ -name "*.py" | xargs $(PIPENV) run isort clean: clean-build-log @echo "===> Cleaning build artifacts" @rm -rf .submodules .circuitpy-deps .micropython-deps .devdeps build clean-build-log: @echo "===> Clearing previous .build.log" @rm -rf .build.log powerwash: clean @echo "===> Removing vendor/ to force a re-pull" @rm -rf vendor @echo "===> Removing pipenv-managed virtual environment" @$(PIPENV) --rm || true test: lint micropython-build-unix @echo "===> Testing keymap_sanity_check.py script" @echo " --> Known good layout should pass..." @MICROPYPATH=tests/test_data:./ ./bin/micropython.sh bin/keymap_sanity_check.py keymaps/known_good.py @echo " --> Layer with ghosted MO should fail..." @MICROPYPATH=tests/test_data:./ ./bin/micropython.sh bin/keymap_sanity_check.py keymaps/ghosted_layer_mo.py 2>/dev/null && exit 1 || exit 0 @echo " --> Sharing a pin between rows/cols should fail..." @MICROPYPATH=tests/test_data:./ ./bin/micropython.sh bin/keymap_sanity_check.py keymaps/duplicated_pins_between_row_col.py 2>/dev/null && exit 1 || exit 0 @echo " --> Sharing a pin between two rows should fail..." @MICROPYPATH=tests/test_data:./ ./bin/micropython.sh bin/keymap_sanity_check.py keymaps/duplicate_row_pins.py 2>/dev/null && exit 1 || exit 0 @echo "===> The sanity checker is sane, unlike klardotsh" .submodules: .gitmodules submodules.toml @echo "===> Pulling dependencies, this may take several minutes" @echo "===> Pulling dependencies, this may take several minutes" >> .build.log @git submodule sync 2>&1 >> .build.log @git submodule update --init --recursive 2>&1 >> .build.log @rsync -ah vendor/ build/ @touch .submodules .circuitpy-deps: .submodules @echo "===> Building circuitpython/mpy-cross" @echo "===> Building circuitpython/mpy-cross" >> .build.log @pipenv run $(MAKE) -C build/circuitpython/mpy-cross 2>&1 >> .build.log @echo "===> Pulling Nordic BLE stack" @echo "===> Pulling Nordic BLE stack" >> .build.log @cd build/circuitpython/ports/nrf && ./drivers/bluetooth/download_ble_stack.sh 2>/dev/null >/dev/null @touch .circuitpy-deps .micropython-deps: .submodules @echo "===> Building micropython/mpy-cross" @echo "===> Building micropython/mpy-cross" >> .build.log @pipenv run $(MAKE) -C build/micropython/mpy-cross 2>&1 >> .build.log @touch .micropython-deps submodules: .submodules circuitpy-deps: .circuitpy-deps micropython-deps: .micropython-deps build/micropython/ports/unix/micropython: micropython-deps build/micropython/ports/unix/modules/.kmk_frozen @echo "===> Building MicroPython for Unix" @echo "===> Building MicroPython for Unix" >> .build.log @pipenv run $(MAKE) -j4 -C build/micropython/ports/unix 2>&1 >> .build.log micropython-build-unix: build/micropython/ports/unix/micropython freeze-atmel-samd-build-deps: build/circuitpython/ports/atmel-samd/modules/.kmk_frozen freeze-nrf-build-deps: build/circuitpython/ports/nrf/freeze/.kmk_frozen freeze-stm32-build-deps: build/micropython/ports/stm32/freeze/.kmk_frozen build/micropython/ports/unix/modules/.kmk_frozen: upy-freeze.txt submodules.toml @echo "===> Preparing vendored dependencies for bundling into MicroPython for Unix" @echo "===> Preparing vendored dependencies for bundling into MicroPython for Unix" >> .build.log @rm -rf build/micropython/ports/unix/modules/* @cat upy-freeze.txt | egrep -v '(^#|^\s*$|^\s*\t*#)' | grep MICROPY | cut -d'|' -f2- | \ xargs -I '{}' rsync -ah {} build/micropython/ports/unix/modules/ @touch $@ build/circuitpython/ports/atmel-samd/modules/.kmk_frozen: upy-freeze.txt submodules.toml @echo "===> Preparing vendored dependencies for bundling into CircuitPython for atmel-samd" @echo "===> Preparing vendored dependencies for bundling into CircuitPython for atmel-samd" >> .build.log @rm -rf build/circuitpython/ports/atmel-samd/modules/* @cat upy-freeze.txt | egrep -v '(^#|^\s*$|^\s*\t*#)' | grep CIRCUITPY | cut -d'|' -f2- | \ xargs -I '{}' rsync -ah {} build/circuitpython/ports/atmel-samd/modules/ @touch $@ build/circuitpython/ports/nrf/freeze/.kmk_frozen: upy-freeze.txt submodules.toml @echo "===> Preparing vendored dependencies for bundling into CircuitPython for NRF" @echo "===> Preparing vendored dependencies for bundling into CircuitPython for NRF" >> .build.log @rm -rf build/circuitpython/ports/nrf/freeze/* @cat upy-freeze.txt | egrep -v '(^#|^\s*$|^\s*\t*#)' | grep CIRCUITPY | cut -d'|' -f2- | \ xargs -I '{}' rsync -ah {} build/circuitpython/ports/nrf/freeze/ @touch $@ build/micropython/ports/stm32/freeze/.kmk_frozen: upy-freeze.txt submodules.toml @echo "===> Preparing vendored dependencies for bundling into MicroPython for STM32" @echo "===> Preparing vendored dependencies for bundling into MicroPython for STM32" >> .build.log @mkdir -p build/micropython/ports/stm32/freeze/ @rm -rf build/micropython/ports/stm32/freeze/* @cat upy-freeze.txt | egrep -v '(^#|^\s*$|^\s*\t*#)' | grep MICROPY | cut -d'|' -f2- | \ xargs -I '{}' rsync -ah {} build/micropython/ports/stm32/freeze/ @touch $@ circuitpy-freeze-kmk-atmel-samd: freeze-atmel-samd-build-deps @echo "===> Preparing KMK source for bundling into CircuitPython for atmel-samd" @echo "===> Preparing KMK source for bundling into CircuitPython for atmel-samd" >> .build.log @rm -rf build/circuitpython/ports/atmel-samd/modules/kmk* @rsync -ah kmk build/circuitpython/ports/atmel-samd/modules/ --exclude kmk/micropython circuitpy-freeze-kmk-nrf: freeze-nrf-build-deps @echo "===> Preparing KMK source for bundling into CircuitPython for NRF" @echo "===> Preparing KMK source for bundling into CircuitPython for NRF" >> .build.log @rm -rf build/circuitpython/ports/nrf/kmk* @rsync -ah kmk build/circuitpython/ports/nrf/freeze/ --exclude kmk/micropython micropython-freeze-kmk-stm32: freeze-stm32-build-deps @echo "===> Preparing KMK source for bundling into MicroPython for STM32" @echo "===> Preparing KMK source for bundling into MicroPython for STM32" >> .build.log @rm -rf build/micropython/ports/stm32/freeze/kmk* @rsync -ah kmk build/micropython/ports/stm32/freeze/ --exclude kmk/circuitpython circuitpy-build-feather-m4-express: @echo "===> Building CircuitPython for atmel-samd - Feather M4 Express" @echo "===> Building CircuitPython for atmel-samd - Feather M4 Express" >> .build.log @pipenv run $(MAKE) -C build/circuitpython/ports/atmel-samd BOARD=feather_m4_express FROZEN_MPY_DIRS="modules" clean all 2>&1 >> .build.log circuitpy-build-itsybitsy-m4-express: @echo "===> Building CircuitPython for atmel-samd - ItsyBitsy M4 Express" @echo "===> Building CircuitPython for atmel-samd - ItsyBitsy M4 Express" >> .build.log @pipenv run $(MAKE) -C build/circuitpython/ports/atmel-samd BOARD=itsybitsy_m4_express FROZEN_MPY_DIRS="modules" clean all 2>&1 >> .build.log circuitpy-build-nrf: @echo "===> Building CircuitPython for NRF - Feather NRF52832" @echo "===> Building CircuitPython for NRF - Feather NRF52832" >> .build.log @pipenv run $(MAKE) -C build/circuitpython/ports/nrf BOARD=feather_nrf52832 SERIAL=${AMPY_PORT} SD=s132 FROZEN_MPY_DIR=freeze clean all 2>&1 >> .build.log circuitpy-flash-feather-m4-express: @echo @echo "!!!!!!!!!!!!!!!!!!!!" @echo "Flashing not available for Feather M4 Express over bossa right now" @echo "First, double tap the reset button on the Feather. You should see a red light near the USB port" @echo "Then, find and (if necessary) mount the USB drive that will show up (should be about 4MB)" @echo "Copy build/circuitpython/ports/atmel-samd/build-feather_m4_express/firmware.uf2 to this device" @echo "The device will auto-reboot. You may need to forcibly unmount the drive on Linuxes, with umount -f path/to/mountpoint" @echo "!!!!!!!!!!!!!!!!!!!!" @echo circuitpy-flash-itsybitsy-m4-express: @echo @echo "!!!!!!!!!!!!!!!!!!!!" @echo "Flashing not available for ItsyBitsy M4 Express over bossa right now" @echo "First, double tap the reset button on the ItsyBitsy. You should see a red light near the USB port" @echo "Then, find and (if necessary) mount the USB drive that will show up (should be about 4MB)" @echo "Copy build/circuitpython/ports/atmel-samd/build-itsybitsy_m4_express/firmware.uf2 to this device" @echo "The device will auto-reboot. You may need to forcibly unmount the drive on Linuxes, with umount -f path/to/mountpoint" @echo "!!!!!!!!!!!!!!!!!!!!" @echo circuitpy-flash-nrf: circuitpy-build-nrf @echo "===> Flashing CircuitPython with KMK and your keymap" @echo "===> Flashing CircuitPython with KMK and your keymap" >> .build.log @pipenv run $(MAKE) -C build/circuitpython/ports/nrf BOARD=feather_nrf52832 SERIAL=${AMPY_PORT} SD=s132 FROZEN_MPY_DIR=freeze dfu-gen dfu-flash 2>&1 >> .build.log micropython-build-pyboard: @echo "===> Building MicroPython for STM32 - PYBV11" @echo "===> Building MicroPython for STM32 - PYBV11" >> .build.log @pipenv run $(MAKE) -j4 -C build/micropython/ports/stm32/ BOARD=PYBV11 FROZEN_MPY_DIR=freeze all 2>&1 >> .build.log micropython-flash-pyboard: micropython-build-pyboard @echo "===> Flashing MicroPython with KMK and your keymap" @echo "===> Flashing MicroPython with KMK and your keymap" >> .build.log @pipenv run $(MAKE) -j4 -C build/micropython/ports/stm32/ BOARD=PYBV11 FROZEN_MPY_DIR=freeze deploy 2>&1 >> .build.log circuitpy-flash-nrf-entrypoint: @echo "===> Flashing entrypoint if it doesn't already exist" @sleep 2 @-timeout -k 5s 10s $(PIPENV) run ampy -p ${AMPY_PORT} -d ${AMPY_DELAY} -b ${AMPY_BAUD} rm main.py 2>/dev/null @-timeout -k 5s 10s $(PIPENV) run ampy -p ${AMPY_PORT} -d ${AMPY_DELAY} -b ${AMPY_BAUD} put entrypoints/feather_nrf52832.py main.py @echo "===> Flashed keyboard successfully!" ifndef USER_KEYMAP build-feather-m4-express: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 flash-feather-m4-express: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 else ifndef SKIP_KEYMAP_VALIDATION build-feather-m4-express: clean-build-log lint circuitpy-deps circuitpy-freeze-kmk-atmel-samd micropython-build-unix else build-feather-m4-express: clean-build-log lint circuitpy-deps circuitpy-freeze-kmk-atmel-samd endif @echo "===> Preparing keyboard script for bundling into CircuitPython for atmel-samd" ifndef SKIP_KEYMAP_VALIDATION @MICROPYPATH=./ ./bin/micropython.sh bin/keymap_sanity_check.py ${USER_KEYMAP} endif @rsync -ah ${USER_KEYMAP} build/circuitpython/ports/atmel-samd/modules/kmk_keyboard_user.py @rsync -ah kmk/entrypoints/global.py build/circuitpython/ports/atmel-samd/modules/_main.py @$(MAKE) circuitpy-build-feather-m4-express flash-feather-m4-express: build-feather-m4-express circuitpy-flash-feather-m4-express endif ifndef USER_KEYMAP build-feather-nrf52832: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 flash-feather-nrf52832: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 else build-feather-nrf52832: clean-build-log lint circuitpy-deps circuitpy-freeze-kmk-nrf @echo "===> Preparing keyboard script for bundling into CircuitPython for NRF" @rsync -ah ${USER_KEYMAP} build/circuitpython/ports/nrf/freeze/kmk_keyboard_user.py @$(MAKE) circuitpy-build-nrf flash-feather-nrf52832: clean-build-log build-feather-nrf52832 circuitpy-flash-nrf circuitpy-flash-nrf-endpoint endif ifndef USER_KEYMAP build-itsybitsy-m4-express: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 flash-itsybitsy-m4-express: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 else ifndef SKIP_KEYMAP_VALIDATION build-itsybitsy-m4-express: clean-build-log lint circuitpy-deps circuitpy-freeze-kmk-atmel-samd micropython-build-unix else build-itsybitsy-m4-express: clean-build-log lint circuitpy-deps circuitpy-freeze-kmk-atmel-samd endif @echo "===> Preparing keyboard script for bundling into CircuitPython for atmel-samd" ifndef SKIP_KEYMAP_VALIDATION @MICROPYPATH=./ ./bin/micropython.sh bin/keymap_sanity_check.py ${USER_KEYMAP} endif @rsync -ah ${USER_KEYMAP} build/circuitpython/ports/atmel-samd/modules/kmk_keyboard_user.py @rsync -ah kmk/entrypoints/global.py build/circuitpython/ports/atmel-samd/modules/_main.py @$(MAKE) circuitpy-build-itsybitsy-m4-express flash-itsybitsy-m4-express: build-itsybitsy-m4-express circuitpy-flash-itsybitsy-m4-express endif ifndef USER_KEYMAP build-pyboard: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 flash-pyboard: @echo "===> Must provide a USER_KEYMAP (usually from user_keymaps/...) to build!" && exit 1 else ifndef SKIP_KEYMAP_VALIDATION build-pyboard: clean-build-log lint micropython-deps micropython-freeze-kmk-stm32 micropython-build-unix else build-pyboard: clean-build-log lint micropython-deps micropython-freeze-kmk-stm32 endif @echo "===> Preparing keyboard script for bundling into MicroPython for STM32" ifndef SKIP_KEYMAP_VALIDATION @MICROPYPATH=./ ./bin/micropython.sh bin/keymap_sanity_check.py ${USER_KEYMAP} endif @rsync -ah ${USER_KEYMAP} build/micropython/ports/stm32/freeze/kmk_keyboard_user.py @rsync -ah kmk/entrypoints/global.py build/micropython/ports/stm32/freeze/_main.py @rsync -ah kmk/entrypoints/handwire/pyboard_boot.py build/micropython/ports/stm32/freeze/_boot.py @$(MAKE) AMPY_PORT=/dev/ttyACM0 AMPY_BAUD=115200 micropython-build-pyboard flash-pyboard: build-pyboard micropython-flash-pyboard endif reset-bootloader: @-timeout -k 5s 10s $(PIPENV) run ampy -p /dev/ttyACM0 -d ${AMPY_DELAY} -b ${AMPY_BAUD} run util/bootloader.py reset-board: @-timeout -k 5s 10s $(PIPENV) run ampy -p /dev/ttyACM0 -d ${AMPY_DELAY} -b ${AMPY_BAUD} run util/reset.py