https://github.com/wraith13/sandglass-m5stickcplus
Sandglass application for M5StickC Plus
https://github.com/wraith13/sandglass-m5stickcplus
m5stickc-plus
Last synced: about 2 months ago
JSON representation
Sandglass application for M5StickC Plus
- Host: GitHub
- URL: https://github.com/wraith13/sandglass-m5stickcplus
- Owner: wraith13
- License: bsl-1.0
- Created: 2022-06-11T03:41:29.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T22:15:15.000Z (over 2 years ago)
- Last Synced: 2025-04-05T20:02:15.554Z (3 months ago)
- Topics: m5stickc-plus
- Language: C++
- Homepage:
- Size: 43 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE_1_0.txt
Awesome Lists containing this project
README
# sandglass for M5StickC Plus

## features
- software sanglass
- timer preset: 30s, 1m, 1m30s, 2m, 3m, 5m, 10m, 15m, 30m, 60m
- battery gauge
- auto power off
- repeat mode
- mute mode## requirements
- [M5StickC Plus ( K016-P )](https://docs.m5stack.com/en/core/m5stickc_plus)
- [Arduino IDE](https://www.arduino.cc/en/software)
- [VCP Drivers](https://ftdichip.com/drivers/vcp-drivers/)
- [Visual Studio Code](https://code.visualstudio.com/)
- [Arduino for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.vscode-arduino)## preparation for build
0. Start Arduino IDE
1. `Preferences` -> Set `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` to `Additional Board Manager URLs`
2. `Board Manager`( `Arduino: Board Manager` command in VS Code ) -> filter `esp32` -> install `esp32`
3. `Library Manager`( `Arduino: Library Manager` command in VS Code ) -> filter `M5StickCPlus` -> install `M5StickCPlus`## how to build & upload
0. Start VS Code
1. Run `Arduino: Board Config` Command from Command Palette. Select `M5Stick-C (esp32)` on `Select Board`.
2. Connect a M5StickC Plus to your PC with USB cable.
3. Run `Arduino: Select Serial Port` Command from Command Palette. Select a M5StickC Plus's Port.
4. Run `Arduino: Upload` Command from Command Palette## user interface
### button
|button|description|
|---|---|
|main|change timer|
|left side(power off)|power on|
|left side( < 1s)|reset to top|
|left side( < 4s)|reset to bottom|
|left side( >= 4s)|power off|
|right siede|change mode|### battery gauge
|color|description|
|---|---|
|blue|charging ( gyro off )|
|green|normal|
|yellow|low battery|
|red|almost empty battery|### mode
|mode|description|
|---|---|
|R|repeat|
|M|mute|### timer preset
|timer|color|
|---|---|
|30s|blue|
|1m|red|
|1m30s|green|
|2m|cyan|
|3m|magenta|
|5m|yellow|
|10m|orange|
|15m|green yellow|
|30m|pink|
|60m|white|You can edit timer preset in [`config.h`](./config.h).
## License
[Boost Software License](./LICENSE_1_0.txt)