Loading files
This file is pinned to the selected release. Download the original to open it in your design tool.
800221497This file is pinned to the selected release. Download the original to open it in your design tool.
<p align="center">
<br>
<img src="https://avatars.githubusercontent.com/u/117961102" width="150"/>
<br>
</p>
<p align="center">
<img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/MakerM0/MagiClick-esp32s3">
<img alt="GitHub top language" src="https://img.shields.io/github/languages/top/MakerM0/MagiClick-esp32s3">
</p>
https://github.com/user-attachments/assets/02206fc1-4ecb-459a-b24e-a9fd3fc22468
# MagiClick S3
This is a versatile, single-button keyboard based on the ESP32-S3 microcontroller, featuring a 0.85-inch color display and customizable functionality, perfect for educational purposes, macro keyboard creation, and desktop decoration.It supports multiple programming languages.
# Specifications
- **Dispaly**: 0.85-inch RGB, 128x128 resolution
- **MCU**: ESP32-S3 , Wi-Fi & BLE
- Main operation via central mechanical buttons, with auxiliary buttons on the sides
- Pluggable mechanical switch design, choice of silent or other types
- speaker
- motion sensor
- Expansion port
- USB Type-C interface
- Reset button at the bottom
- RGB LEDs
- more
# Purchase
[Browse products ](https://www.elecrow.com/store/MakerM0)
<a href="https://www.pcbway.com/project/shareproject/MagiClick_S3_Single_506b8396.html"><img src="https://www.pcbway.com/project/img/images/frompcbway-1220.png" alt="PCB from PCBWay" /></a>
# Hardware
| Version | |
| :------------------: | :-----------------------------------------------: |
| | |
| [2.4](hardware) | <img src="documents/images/2.4@1x.png" width=800> |
| [2.3c](hardware) | <img src="documents/images/7.png" width=800> |
| [2.3b ](hardware) | <img src="documents/images/19_1.png" width=800> |
| [2.0](hardware) | <img src="documents/images/1.jpg" width=400> |
| | |
### Difference
| | v2.0 | v2.3 | v2.4 |
| ---------------------------------------- | :----------------------------------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: |
| Supported MCU or Module | ESP32-S3-MINI-1-N4R2 or ESP32-S3-MINI-1-N8 | ESP32-S3FN8 | ESP32-S3R8 |
| FLASH | 4MB or 8MB | 8MB | 16MB |
| PSRAM | 2MB or ❌ | ❌ | 8MB |
| Display Driver | GC9107 | NV3023 | NV3023 |
| | <img src="https://github.com/user-attachments/assets/523d0a3c-ad5c-45c5-bae5-af37dbe8f4df" alt="GC9107" height=150 /> | <img src="https://github.com/user-attachments/assets/cd7b9db4-63ff-4de5-b79d-df9c267f4ca3" alt="NV3023" height=150 /> | <img src="https://github.com/user-attachments/assets/cd7b9db4-63ff-4de5-b79d-df9c267f4ca3" alt="NV3023" height=150 /> |
| Battery(with a protection circuit board) | 801230 | 602025 or 802025 | 602025 |
| | <img src="https://github.com/user-attachments/assets/7210dbef-53c5-4370-846a-e92d67251280" alt="18" height=150 /> | | |
| Keyboard switch | <img src="https://github.com/user-attachments/assets/591edf82-1dd9-41aa-b90f-4f15ff3cf00b" alt="16-09-2024 13 45 53" height=150/> | <img src="https://github.com/user-attachments/assets/6c8d2646-7472-4314-a1af-7253ca38c896" alt="16-09-2024 13 45 38" height=150 /> | <img src="https://github.com/user-attachments/assets/6c8d2646-7472-4314-a1af-7253ca38c896" alt="16-09-2024 13 45 38" height=150 /> |
| Audio | max98357 | ns4168 | es8311 |
| Microphone | ❌ | ❌ | 1x |
| Motion Sensor | lsm6ds3tr-c | lsm6ds3tr-c | lis2dh12 |
# Software
Supports development using Arduino, CircuitPython, and MicroPython.
The "software" and "firmware" folders in this repository primarily contains the source code related to the hardware version 2.0.
When you update the circuitpython firmware of the 2.0 hardware to version 9.x, the contents of the 2.3 software [here](https://github.com/MakerM0/MagiClick-S3-Single) folder can then be used by the 2.0 hardware.
For version 2.3, please click [here](https://github.com/MakerM0/MagiClick-S3-Single).
### 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
[help](documents/如何下载固件.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
# Mechanical
#### 3D Printings
Makeronline
- [2.3](https://www.makeronline.com/en/model/magiclick%20macropad%20keyboard%20%E7%A5%9E%E5%A5%87%E6%8C%89%E9%92%AE/113241.html)
- [PACKAGING BOX](https://makeronline.com/en/model/product%20packaging%20box/48433.html)
- [PACKAGING BOX_2](https://makeronline.com/en/model/product%20packaging%20box/48433.html)
Makerworld
- [2.0](https://makerworld.com/zh/models/404976#profileId-306794)
- [2.3](https://makerworld.com/zh/models/440612#profileId-346290)
- [2.3](https://makerworld.com/zh/models/584488#profileId-505582)
<img src="documents/images/172822164043371300-670291c869e3_thumbnail.jpg" alt="172822164043371300-670291c869e3_thumbnail" width = 600/>
## How to contribute
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
## Images
|  |  |  |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
|  | <img src="extention/MLX90640/images/5.jpg" alt="5" style="zoom:80%;" /> |  |
|  |  | <img src="extention/MLX90640/images/6.jpg" alt="6" style="zoom: 80%;" /> |
|  |  |  |
|  |  | |
# 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.
# License
(documents/hardware/mechanical)[Creative Commons — Attribution-NonCommercial-ShareAlike 4.0 International — CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)