/MagiClick-esp32s3

A single-button keyboard, based on ESP32-S3 v2.0

Primary LanguageC



GitHub release (latest by date) GitHub top language

afdian.net | bilibili | Circuitpython | OSHWHUB

Supported modules

  • ESP32-S3-MINI-1-N4R2
  • ESP32-S3-MINI-1-N8

Specifications

A single-button keyboard, based on ESP32-S3, with a color screen.

CircuitPython is used by default. You can also use MicroPython, Arduino.

  • 0.85-inch color screen, 128x128 resolution
  • esp32-s3, which supports WiFi, flash and RAM large enough to help add more functional scripts
  • The overall operation is mainly based on the mechanical axis buttons in the middle, and the left and right sides of the fuselage are generally used as auxiliaries
  • The keyboard axis uses a pluggable design, and you can freely choose the silent axis or others
  • Built-in a small speaker, listening to a sound is so easy
  • An on-board 6-axis motion sensor
  • There is an expansion port on the rear side of the fuselage
  • USB Type-C interface
  • One reset button at the bottom
  • On-board colorful LEDs

1

Guide

  1. Use the Flash Download Tool to burn the Combined .bin in the Firmware folder to the board
  2. After rebooting, Then copy the .uf2 file to a USB stick
  3. After rebooting, copy the contents of the softerware folder to the displayed USB stick

如何下载固件.pdf

Settings.toml

modify your wifi information, know the weather key (need to go to the official website to apply) and city

The main button is used to access the function options

The side button or flip button can exit the current function and return to the home page

How to add new features

Add the .py file to the app folder

How to add a contribution

Please use PR to submit contributions

In the thirdparty folder, create a project folder according to your own content, the naming needs to be intuitive and easy to understand, and the open source license should be added according to your own wishes

Please add a summary of the contributions in the file contributer.md, Add it at the end

请使用pr提交贡献内容

第三方文件夹内,根据自己的内容创建一个项目文件夹,命名需要直观易懂,开源协议请根据自我意愿添加

请添加所贡献的内容概要在文件contributer.md,在结尾添加即可

Images

4

5

6

7

8

9

10

6

5

Mechanical

2

3

License

(documents/hardware/mechanical)Creative Commons — Attribution-NonCommercial-ShareAlike 4.0 International — CC BY-NC-SA 4.0

About the Battery

Users can choose the 801230 battery with protection board.

However, choose a battery with safety certification.

Users need to control their own risks.

In the case of non-optimization, the battery will last at least 3 hours and the charging current is currently limited to 100mA.

The battery needs to be soldered to a board containing the MCU.

18

Extra

The most icons is from https://icons8.com/.

Other resource files come from the internet.

If there are copyright issues involved, please contact me to delete them.