HillSideView 开源项目教程

1. 项目介绍

HillSideView（HSV）是基于 Hillside 46 键盘的改进版本，它是一款无线或有线的 40% 分体式人体工学键盘，拥有 3x6+5 或 3x5+5 的列错位布局。HSV 在 Hillside 46 的基础上增加了以下主要特性：

• 集成 e-paper 显示屏以提升电池寿命
• 更干净的外侧小指列切割
• 支持在 PCB 本身上使用 cirque 触控板
• 案设计支持在 PCB 下方安装大型 750-3000 mAh 电池
• 带有磁性支座的帐篷式站立支持
• 在 PCB 下方安装 MCU，以便更清洁地安装顶部显示屏
• 可选的工厂焊接部分（PCBA），不包括开关、MCU、显示屏、TRRS、LEDs、电池开关和可选的热插拔插座

HSV 还具备以下特性：

• Choc-spaced 键帽，激进的错位设计，五个拇指键
• 可拆卸的外侧小指列
• 支持帐篷式底座
• QMK 和无线 ZMK 固件
• Nice!nano 电池电源开关
• 编码器支持
• 来自四个或五个 SK6812-MINI-E 的底光
• 可反转的 PCB
• 细致的物料清单（BOM）和默认键盘设计理由
• SMT 二极管、电阻器、电容器和重置开关

2. 项目快速启动

以下是快速启动 HSV 项目的步骤：

硬件准备

• PCB
• nice!nano x 2
• nice!view x 2
• 开关（如 Kailh Choc）x 5
• mill-max 插座 x 100
• 键帽（如 MBK）x 5
• 2x 750 mAh 电池
• MCU 插座 x 2
• 支架 x 8
• MCU 引脚 x 64
• 电源开关 x 2

软件安装

1. 从 HSV 仓库中克隆代码：

   git clone https://github.com/wannabecoffeenerd/HillSideView.git
   

2. 进入克隆的目录：

   cd HillSideView
   

3. 编译和上传固件（根据您的开发环境选择 QMK 或 ZMK）。

3. 应用案例和最佳实践

案例一：自定义键映射

HSV 支持自定义键映射，以适应不同用户的打字习惯。你可以通过编辑 keymap.c 文件来自定义键映射。

案例二：集成触控板

如果你打算集成 cirque 触控板，确保你的 ZMK 固件支持 cirque 触控板，并根据官方文档进行配置。

4. 典型生态项目

• Hillside 46：HSV 的基础项目，一款受欢迎的分体式人体工学键盘。
• Atreus：一款紧凑型 40% 键盘，影响力 HSV 的设计。
• Lily58：另一款影响力 HSV 的键盘项目。

以上就是 HSV 开源项目的教程。希望对您有所帮助！