# KiCadOpenSourceProjectCollection

**Repository Path**: perfectd/KiCadOpenSourceProjectCollection

## Basic Information

- **Project Name**: KiCadOpenSourceProjectCollection
- **Description**: KiCad 开源项目合集
- **Primary Language**: 其他
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2022-06-08
- **Last Updated**: 2022-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KiCadOpenSourceProjectCollection

#### 介绍

KiCad 开源项目合集

#### 软件架构

本仓库使用 `git submodule` 方式收集 KiCad 开源项目合集

#### 安装教程

1. 克隆本仓库

```bash
git clone https://gitee.com/KiCAD-CN/KiCadOpenSourceProjectCollection.git
```

2. 使用子模块仓库

```bash
// 初始化子模块仓库
git submodule init 

// 更新子模块仓库
git submodule update
```

或：

```bash
// 初始化和更新子模块仓库组合命令
git submodule update --init --recursive
```

### KiCad 官网收集[使用 KiCad 设计](https://www.kicad.org/made-with-kicad/) 的工程

这些是一些由用户制作的 KiCad 设计的项目。

如果您想与本页上的其他展示案例一起展示，请在 [GitLab 上](https://gitlab.com/kicad/services/kicad-website) 提交合并请求 (如果您符合添加项目要求的贡献指南)！

#### 使用说明

1. [dvk-mx8m-bsb](dvk-mx8m-bsb) 开源的智能手机，仓库地址：https://source.puri.sm/Librem5/dvk-mx8m-bsb


> # dvk-mx8m-bsb
> 
> Librem 5 Developer Kit using EmCraft's i.MX 8M System-on-Module.
> 
> KiCad v5.0.0 has been used to create this design.
> 
> ## License
> 
> dvk-mx8m-bsb is [licensed under the GNU GPLv3+](https://source.puri.sm/Librem5/dvk-mx8m-bsb/blob/master/LICENSE).


2. [usbarmory](usbarmory) 仓库地址：https://github.com/f-secure-foundry/usbarmory/

> # usbarmory
> Introduction
> ============
> 
> USB armory | https://github.com/f-secure-foundry/usbarmory  
> Copyright (c) F-Secure Corporation
> 
> The USB armory from [F-Secure Foundry](https://foundry.f-secure.com) is an open
> source hardware design, implementing a flash drive sized computer.
> 
> This repository is aimed towards developers, if you wish to purchase a USB
> armory board please see the [USB armory project page](https://www.f-secure.com/en/consulting/foundry/usb-armory).
> 
> Authors
> =======
> 
> Andrea Barisani  
> andrea.barisani@f-secure.com | andrea@inversepath.com  
> 
> Andrej Rosano  
> andrej.rosano@f-secure.com   | andrej@inversepath.com  
> 
> Daniele Bianco  
> daniele.bianco@f-secure.com   | daniele@inversepath.com  
> 
> Documentation
> =============
> 
> The main documentation can be found on the
> [project wiki](https://github.com/f-secure-foundry/usbarmory/wiki).
> 
> Board revisions
> ===============
> 
> * [USB armory Mk II](https://github.com/f-secure-foundry/usbarmory/wiki/Mk-II-Introduction)
> 
> ![Mk II Top](https://github.com/f-secure-foundry/usbarmory/wiki/images/armory-mark-two-top.png)
> ![Mk II Bottom](https://github.com/f-secure-foundry/usbarmory/wiki/images/armory-mark-two-bottom.png)
> 
> * USB armory Mk I: first production release.
> 
> ![USB armory Mk I](https://github.com/f-secure-foundry/usbarmory/wiki/images/armory-mark-one.png)
> 
> License
> =======
> 
> USB armory | https://github.com/f-secure-foundry/usbarmory  
> Copyright (c) F-Secure Corporation
> 
> This is an open hardware design licensed under the terms of the CERN Open
> Hardware Licence (OHL) v1.2.
> 
> You may redistribute and modify this documentation under the terms of the CERN
> OHL v.1.2 (http://ohwr.org/cernohl). This documentation is distributed WITHOUT
> ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING OF MERCHANTABILITY, SATISFACTORY
> QUALITY AND FITNESS FOR A PARTICULAR PURPOSE. Please see the CERN OHL v.1.2 for
> applicable conditions.


3. [H7PI](H7PI) 仓库地址：https://gitee.com/htctek/H7PI
> # H7PI
> 简介
> ============
> H7PI基于STM32H750VBT6, 设计初衷是为了做一个通用平台，在这个设计上，按照一个场景一个
> 应用的模式扩展出其他扩展功能，同时实现如代码复用一般的硬件复用。板载8M QSPI Flash程序空间，8M SPI Flasn文件空间，支持扩展SD卡，支持扩展LCD.[参考说明](https://pinno.cc/2020/02/28/H7PI/)
> 
> #### KiCad v5.1.5 has been used to create this design.    
> ![H7PI](https://pinno.cc/2020/02/28/H7PI/wp.jpg)
> 
> license
> ============
> 
> H7PI is [licensed under the BSD 3-Clause](https://gitee.com/htctek/H7PI/blob/master/LICENSE).


4. [ESP32PI](ESP32PI) 仓库地址：https://gitee.com/htctek/ESP32PI
> # H7PI
> 简介
> ============
> ESP32PI基于ESP32-PICO-D4, 为快速开发wifi，ble应用提供方案验证的可能
> * 板载CP2102，可通过USB转串口直接更新固件，无需手动按按键
> * 板载Micro SD Card接口，扩展文件系统
> * 板载天线，可直接链接WiFi和蓝牙，无需额外购买天线
> * 板载PSRAM，增加应用内存空间
> * 所有IO引出，方便复用，可扩展多种功能
> [参考说明](https://pinno.cc/2020/04/07/ESP32PI/)
> 
> #### KiCad v5.1.5 has been used to create this design.    
> ![ESP32PI](https://pinno.cc/2020/04/07/ESP32PI/ESP32PI.JPG)
> 
> license
> ============
> 
> ESP32PI is [licensed under the BSD 3-Clause](https://gitee.com/htctek/ESP32PI/blob/master/LICENSE).

5. [reform](reform) 开源的笔记本电脑，仓库地址：https://source.mntmn.com/MNT/reform

> # MNT Reform
> 
> This is the main repository for the MNT Reform open source laptop.
> 
> For details, check out [Finishing Reform](https://mntre.com/media/reform_md/2020-01-18-finishing-reform.html) and related articles.
> 
> ## Impressions
> 
> ![Reform Version 2 Prototype](https://mntre.com/media/reform_v2_images/reform_v2_prototype_top.jpg)
> ![Reform Version 2 Motherboard](https://mntre.com/media/reform_v2_images/reform_v2_motherboard.jpg)
> 
> ## License
> 
> Copyright 2018-2020 MNT Research GmbH.
> 
> The following licenses are used in the project, unless specified differently in a particular subfolder:
> 
> - Schematics, PCBs: [CERN-OHL-S v2](https://www.ohwr.org/project/cernohl/wikis/uploads/002d0b7d5066e6b3829168730237bddb/cern_ohl_s_v2.txt)
> - Other documentation, artwork, photos and drawings that are not trademarks (see below): [CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode)
> - Software, firmware: Various. [GPL 3.0](https://www.gnu.org/licenses/gpl-3.0.en.html) if not specified otherwise in the file/subdirectory.
> 
> The "MNT" and "MNT REFORM" logos are trademarks of MNT Research GmbH. You may not use these in derived works. The reason for this is that we cannot be responsible for regulatory issues with derived boards and we cannot support them. If someone sees an MNT brand on a product, it has to be clear that it comes from MNT Research and not from a third party.
> 
> ## Made With
> 
> * [KiCAD EDA](http://kicad-pcb.org/)
> * [OpenSCAD](https://www.openscad.org/)
> * [LUFA](http://www.fourwalledcubicle.com/LUFA.php)
> * Autodesk Fusion (Case parts)
> 
> ## MNT Reform Team
> 
> * **Lukas F. Hartmann (mntmn)** - *Schematics, PCB*
> * **Ana Dantas** - *Industrial Design*
> * **Greta Melnik** - *Quality & Assembly, Sleeve*
> 
> ## Credits and Contributions
> 
> * [fully automated technologies](https://fully.automated.ee/) - *inrush limiter circuit*

6. [hs-probe](hs-probe) 开源的高速探针调试器，仓库地址：https://github.com/probe-rs/hs-probe 

> # The Rusty High-speed Probe
> 
> This is an open hardware probe for the Serial Wire Debug (SWD) and JTAG protocol. It utilizes an
> STM32F723 MCU which has an USB 2.0 High-speed Phy.
> 
> ## Firmware
> 
> The firmware is available here and is open-source: https://github.com/probe-rs/hs-probe-firmware
> 
> ## Features
> 
> There is an USB MUX on the board, so when the probe starts it enumerates in USB FS where one can
> access the internal bootloader, and then when the firmware takes over it can switch to the USB HS.
> 
> * The output connector can either be:
>     * The STDC14 connector used on STLink/V3 which is mounted by default.
>     * Or the standard Cortex-M Debug (1.27mm, 10 pin) connector if one bends/removes the outer 2 pins on the connector.
> * The programming connector is the Tag Connect TC2030, however for just loading firmware the USB bootloader is recommended.
> * USB MUX between USB HS/FS.
> * Castellated vias for all programming pins, power and 2 GPIOs.
> * USB-C connector.
> * Target 5V and 3.3V is protected with an ideal diode circuit to not have current flow from the target to the host.
> * For compatibility (mainly with Tag-Connect TC2050), pin 7 on the STDC 14 can be connected to the protected 5V.
> 
> The schematic can be found in [the schematic PDF](schematic-v1.3.pdf).
> 
> ![alt text](https://github.com/probe-rs/hs-probe/raw/master/hs-probe-top.jpg "probe")
> ![alt text](https://github.com/probe-rs/hs-probe/raw/master/hs-probe-bot.jpg "probe")
> 
> ## License
> 
> This work is licensed under [CERN-OHL-P](cern_ohl_p_v2.txt).

7. [launch](launch) 开源的可换键轴的机械键盘，仓库地址：https://github.com/system76/launch

> # System76 Launch Configurable Keyboard
> 
> The System76 Launch Configurable Keyboard is designed to provide the ultimate
> user controlled keyboard experience, with open source mechanical and electrical
> design, open source firmware and associated software, and a large number of
> user configuration opportunities.
> 
> - [Mechanical Design](#mechanical-design)
> - [Electrical Design](#electrical-design)
> - [Firmware and Software](#firmware-and-software)
> 
> ## Mechanical Design
> 
> ![Chassis Image](./chassis/launch-chassis.png)
> 
> ### Open Source Chassis
> 
> The Launch chassis is licensed CC-BY-SA-4.0 and can be viewed in the
> [chassis](./chassis/) folder using [FreeCAD](https://www.freecadweb.org/).
> 
> ### Milled Aluminum
> 
> The chassis is milled from two solid blocks of aluminum and powder coated to
> provide excellent fit and finish. Each pocket, port, and hole is designed and
> precisely machined so that swapping switches and plugging in cables is easy and
> secure for the user.
> 
> ### Detachable Lift Bar
> 
> The included lift bar can be magnetically secured to add 15 degrees of angle to
> your keyboard for ergonomics.
> 
> ### Innovative Layout
> 
> The layout is designed to provide a large number of remapping opportunities.
> The default layout can be viewed
> [here](http://www.keyboard-layout-editor.com/#/gists/8ec5e9026d616ebad6b2c7e9d943e7c0),
> and the extra keys included can be viewed
> [here](http://www.keyboard-layout-editor.com/#/gists/a3ad8710b27f78fd938077b2bf6d3ef5).
> 
> ### Swappable Keycaps
> 
> The keycaps are PBT material with a dye sublimation legend and XDA profile to
> provide excellent feel and lifespan. Extras are provided for common replacements
> and color preference. An included keycap puller can be used to move and replace
> the keycaps.
> 
> ### Swappable Switches
> 
> The switches are mounted in sockets that support any RGB switch with an MX
> compatible footprint. Examples are the Cherry MX RGB switches and the Kailh
> BOX switches. Switches can be removed easily at any time with the included
> switch puller.
> 
> ## Electrical Design
> 
> ![PCB Image](./pcb/launch-pcb.png)
> 
> ### Open Source PCB
> 
> The Launch PCB is licensed GPLv3 and can be viewed in the
> [pcb](./pcb/) folder using [KiCad](https://kicad.org/).
> 
> ### Integrated Dock
> 
> Launch connects to a computer using the included USB-C to USB-C cable or USB-C
> to USB-A cable. It supports USB 3.2 Gen 2 with speeds up to 10 Gbps with either
> cable, provided the computer supports these speeds. It provides 2 USB-C and 2
> USB-A connectors that also support USB 3.2 Gen 2, with the 10 Gbps bandwidth
> shared between them on demand.
> 
> ### Independent RGB Lighting
> 
> Each switch has an RGB LED that is independently controlled by firmware. This
> allows for a number of RGB LED patterns to be selected.
> 
> ### N-Key Rollover
> 
> The keyboard matrix uses diodes on all intersections, providing full independent
> scanning of each key position.
> 
> ## Firmware and Software
> 
> ### Open Source Firmware
> 
> The Launch firmware is based on [QMK](https://github.com/system76/qmk_firmware),
> licensed GPLv2, and the latest version is linked in the `firmware` submodule.
> 
> ### Open Source Software
> 
> Projects that integrate with Launch are open source software, such as the
> [System76 Keyboard Configurator](https://github.com/pop-os/keyboard-configurator),
> licensed GPLv3, and [fwupd](https://github.com/fwupd/fwupd/), licensed LGPLv2.1.
> 
> ### Easy Remapping
> 
> The keyboard can be remapped at runtime using the
> [System76 Keyboard Configurator](https://github.com/pop-os/keyboard-configurator).
> This utility runs on Linux, Mac OS, and Windows.
> 
> ### Firmware Updates
> 
> Firmware updates are supported through the
> [fwupd](https://github.com/fwupd/fwupd/) project, and are distributed using the
> related Linux Vendor Firmware Service. Settings are stored on EEPROM and are
> maintained through firmware updates.


8. [cantact-pro-hw](cantact-pro-hw) 开源 USB 到控制器局域网（CAN）设备。仓库地址：https://github.com/linklayer/cantact-pro-hw

> # CANtact Pro User Guide
> 
> ![CANtact Pro](https://github.com/linklayer/cantact-book/blob/master/src/cantact-pro/cantact-pro.jpgg)
> 
> CANtact Pro is [available from CrowdSupply](https://www.crowdsupply.com/linklayer-labs/cantact-pro)
> 
> ## Getting Started
> 
> Thank you for buying a CANtact Pro 🙂
> 
> To start using CANtact, connect it via USB. Before using, you should update to the latest 
> firmware following the instructions in this document.
> 
> After updating, the device will work on Linux via SocketCAN. For details, see [SocketCAN](https://github.com/linklayer/cantact-book/blob/master/src/tools/socketcan.html). 
> 
> On all platforms, you can install the CANtact CLI. For details, see [CANtact CLI](https://github.com/linklayer/cantact-book/blob/master/src/tools/cantact-cli.html).
> 
> For more information on software support, see [Software Tools](https://github.com/linklayer/cantact-book/blob/master/src/tools/software-tools.html).
> 
> ## Features & Specifications
> - 2x CAN Interfaces
>   - 1x CAN/CAN-FD/SWCAN
>   - 1x CAN/CAN-FD
> - High Speed USB interface (480 Mbit/s)
> - Isolation between CAN and USB
> - Industry standard DB9 connectors
> - Software support for Windows, macOS, and Linux
>   - Cross-platform USB driver, command line interface, and APIs:
>     - Python (via [python-can](https://github.com/hardbyte/python-can/))
>     - C / C++
>     - Rust
>   - [ETAS BUSMASTER](https://rbei-etas.github.io/busmaster/) support on Windows
>   - SocketCAN support on Linux
> 
> 
> ## Pin Assignments
> 
> |Pin | Function | CAN 0 Only? |
> |----|----------|-------------|
> |1   |          |
> |2   | CAN -    |
> |3   | GND      |
> |4   | SWCAN    | Yes
> |5   |          |
> |6   | GND      |
> |7   | CAN +    |
> |8   |          |
> |9   | +12 V In | Yes
> 
> Note that single-wire CAN is only available on the CAN 0 connector.
> 
> ## LED Indicators
> 
> The device has four LEDs, two for each CAN channel. When powered on, the LEDs will blink in sequence. The LED indications during normal operations are shown here.
> 
> |Color  | State   | Meaning |
> |-------|---------|---------|
> | Green | Solid   | channel enabled, no activity
> | Green | Blinking| receive activity 
> | Red   | Solid   | channel transmit enabled, no activity
> | Red   | Blinking| transmit activity 
> 
> When using SocketCAN, each CAN interface can be identified by blinking the corresponding LEDs using `ethtool`. This is especially useful when using multiple devices.
> 
> ```
> sudo ethtool --identify can0
> ```
> 
> ## Configuring Permissions on Linux
> 
> By default, root privileges are required to interact with the device. To allow other users to access the device, 
> create a file at `/etc/udev/rules.d/99-cantact.rules`:
> ```
> SUBSYSTEM=="usb", ATTRS{idVendor}=="1d50", ATTRS{idProduct}=="6070", MODE="0666"
> ```
> 
> After creating the file, reload the udev rules:
> ```
> sudo udevadm control --reload-rules
> sudo udevadm trigger
> ```
> 
> This will make the device accessible to all users. 
> 
> ## Flashing Firmware
> 
> 1. Download the newest firmware binary [from Github](https://github.com/linklayer/cantact-pro-fw/releases).
> 2. To enter bootloader mode, hold down the button beside the USB connector while connecting the device
> to your computer.
> 
> ![Holding the button to enter bootloader mode](https://github.com/linklayer/cantact-book/blob/master/src/cantact-pro/enter-bootloader.jpg)

#### 参与贡献

1.  Fork 本仓库

2.  新建 Feat_xxx 分支

3.  添加新的子模块仓库

```bash
// `URL` 为子模块的路径，`PATH` 为该子模块存储的目录路径
git submodule add [URL] [PATH]
```
例如：

```bash
// 仓库后缀的 `.git` 可加可不加
git submodule add https://source.puri.sm/Librem5/dvk-mx8m-bsb
```

4. 从子模块的远端仓库更新并合并到本仓库

```bash
// 从子模块远端仓库更新并合并
git submodule update --remote --merge
```
5.  提交子模块的更改

```bash
// 提交修改
// -s : 在提交日志消息的末尾添加提交人签名行。
// 签约的含义取决于项目，但它通常证明提交者有权在相同的许可证下提交此作品，
// 并同意开发者原产地证书(有关更多信息，请参阅 http://developercertificate.org/)。

git commit -sa 
```

修改本仓库的 `README` 自述文件，增加对新增子模块仓库的描述。
```bash
// 使用文本编辑器编辑 `README.md`, 如：
// vim notepad gedit notepad++ nano emacs ...
vim README.md
// vim 批量处理 markdown(md) 语法引用操作 >
// 在 vim 编辑界面下，如给 usbarmory 批量添加引用符号 >
// : 编辑模式 54 开始行号 110 结束行号 s 搜索 ^ 行首 > 替换内容 g 替换
:54,110 s/^/> /g
// 修改完后记得保存退出，并清理文本编辑的缓存文件。
// 或者将缓存文件的格式添加到 `.gitignore` 文件中。


// 提交 README.md 修改 
git commit -am "此次修改的描述"
// 例如：
git commit -am "Add dvk-mx8m-bsb"
git commit -am "新增 dvk-mx8m-bsb"
git commit -am "Update dvk-mx8m-bsb"
git commit -am "更新 dvk-mx8m-bsb"
git commit -am "Delete dvk-mx8m-bsb"
git commit -am "删除 dvk-mx8m-bsb"
```

推送到自己的仓库
```bash
git push 
```
6.  新建 Pull Request


#### 码云特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  码云官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解码云上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是码云最有价值开源项目，是码云综合评定出的优秀开源项目
5.  码云官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  码云封面人物是一档用来展示码云会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)