nrf52-keyboard

Overview

This is a TMK keyboard firmware for nRF52810, nRF51822 version see here.

概述

这是一个基于nrf52蓝牙键盘的固件，使用了nRF SDK 15.3作为底层硬件驱动，并使用TMK键盘库作为键盘功能的上部实现。

此固件中的USB部分和KeymapDownloader部分重用了 nrf51822-keyboard 的代码。

目录结构

• application/ 固件相关
  • main/ 主程序
    • src/ 源码
      • ble/ 蓝牙相关代码
      • tmk/ tmk桥接相关
      • config/ 硬件配置相关
    • project/ 工程
  • bootloader/
    • src/ 源码
    • project/ 工程
• keyboard/ 各个键盘实现相关
• SDK/ nRF52 SDK
• tmk/ tmk core 相关
• usb/ USB部分代码

功能亮点

• 蓝牙/USB双模切换
• USB全键无冲
• 配列下载更新
• 电量上传
• 支持多媒体按键
• 耗电量低至400ua（使用lot60-ble硬件在关闭所有灯光条件下测得，不代表所有条件下的状态）
• 高度自定义的事件系统

硬件支持

当前支持nrf52810和nrf52832两种主控硬件，此固件支持的键盘列表见Keyboard目录。

编译

首先下载 nRF5 SDK 15.3, 解压并放入SDK文件夹。 然后安装 gcc-arm-none-eabi-7-2018-q2-update，将template目录中对应平台的配置文件模板复制一份，重命名为Makefile.posix或Makefile.windows，修改里面工具路径为你的安装目录。

然后安装 SDCC 用于编译CH554相关代码。

Bootloader 的编译

参见这篇文章，先编译uECC库，然后再编译Bootloader

cd application/bootloader/project/armgcc
make

蓝牙程序和USB控制器的编译

现在蓝牙和USB控制器程序的Makefile都放在一起了。进入对应的硬件目录，直接make即可。

cd keyboard/lot60-ble
make

硬件的烧录

对于nrf52，若要通过JLink直接写入，则需要安装JLink的驱动；若使用DAP-Link写入，则需要安装pyocd；若使用蓝牙DFU进行升级，则需要安装nrfutil

对于ch554，你可以使用官方的windows烧写工具，或三方的usbisp烧写。

请使用make help查看所有的烧写和打包指令。

硬件移植

请参考Keyboard目录下的template移植模板，并查看doc目录下的对应说明。