# Cyberdeck Chat

The Meshberry is a mesh chat app for the CYD + M5Stack CardKB v1.1, built for The Hmm cyberdeck workshop. 
Devices in range talk to each other over ESP-NOW, and forward messages for other users. When not in range of other users, the device can be used for Note taking and as a Bluetooth keybaord.

All the mesh chat functionality was directly ported from https://github.com/7h30th3r0n3/Evil-M5Project/wiki/EvilChatMesh

## Hardware

- **Board**: We used a non-standard CYD variant; [1005008564907457] from Aliexpress also known as E32R28T, mostly for the price and USB-C connector. The peripheral connectors are placed a little differently from the commonly documented ESP32-2432S028R. The pin configuration in this project is specific to this board and may not work on other CYD revisions without changes to the GPIO assignments.

- **Keyboard**: M5Stack CardKB v1.1, wired to the board's 1.25 mm
  peripheral headers (GPIO23/19) over I2C. 3.3V and GND are available on the other header, so a custom cable is needed. 
  See `include/config.h` for pin assignments. The keyboard uses pins IO19 and IO23 for I2C, which are also wired to the SD card SPI pins. So no SD card support regrettably.

## Build & flash

I've used PIOArduino for building, but regular PIO should work fine. 
The source can be found in `/src`. 
`src/meshberry` hold the source for the chat / notes applciuation
`src/chat-relay` is a slightly modified version of https://github.com/7h30th3r0n3/Evil-M5Project/blob/main/slave/EvilChatMesh-Relay.ino with the callback functions modified for the new signatures. Upload this to a 'regular' ESP32 module/devkit to extend your mesh chat network. 


```
pio run --target upload
```

Upload LittleFS `data/config.txt`. This deletes whats already there, so existing notes etc are lost.

```
pio run --target uploadfs
```

## config.txt reference

All values have hardcoded defaults, so any key can be left out entirely.

| Key | Meaning |
|---|---|
| `nick` | Set nickname. Max 15 characters, no spaces. `/nick <name>` in the app also updates this. |
| `brightness` | Backlight, 0 (off) - 255 (max). Default 200 |
| `touch_threshold` | Threshold for touch to wake on Touch7 pin. Higher = easier to trigger. Not recommended for now. |
| `color_*` | 6-digit hex RGB (no `#`), same format as CSS, e.g. `ff0000` is red. See the table below for which UI element each one controls. |
| `tones_msg` and  `tones_sys` | Set the new message and system message melodies in MML format, see below. |

| Color key | Controls |
|---|---|
| `color_bg` | Screen background |
| `color_header_bg` | Header and Footer bar background |
| `color_msg` | Message body text |
| `color_nick_other` | Nickname color for other people's messages |
| `color_nick_own` | Nickname color for your own messages |
| `color_system` | System messages (joins, nick changes, errors) |
| `color_input_prompt` | The `>` prompt on the input line |

Colors can also be changed from the device itself with `/set <key> <hex>`
(e.g. `/set color_bg ff0000`), see below.

## Sounds

You can set the new message [`tones_msg`] and system message [`tones_sys`] sounds (like a new user entering the chat) using a MML music notation string using the `/set` command. 

Example:
`/set tones_msg t300 o4`

The defaults are:
- New message: `t300 d8 a+4`, Tempo 300bpm, D for 1/8, A for 1/4
- System message: `t300 a8 d+4`, Tempo 300bpm, A for 1/8, D for 1/4

More information here: https://github.com/maxint-rd/MmlMusic
And to listen to a MML string: https://matarillo.github.io/mmlplayer/


## Chat commands

Typed into the input line, same as any chat message:

| Command | Effect |
|---|---|
| `/nick <name>` | Change your nickname (saved to `config.txt`) |
| `/me <action>` | Roleplay-style action message |
| `/people` | List currently connected peers |
| `/clear` | Clear the chat window |
| `/clearnotes` | Erase all saved notes |
| `/set <color_key> <hex>` | Change a color setting; saved to `config.txt`, visible after sleep/restart |
| `/set <tones_key> <tones>` | Change a tones setting; saved to `config.txt`, audible after sleep/restart |
| `/bt` | Toggle BT send mode (see below) |
| `/sleep` | Put the device to deep sleep (wake via BOOT button or touch7) |
| `/help` | List commands on-device |
| `/help colors` | extended help information for settings colors |
| `/help notes` | extended help information for settings message tones |

## Notes mode

Press **Tab** to switch between chat and the notepad. What you type in notes mode is saved to a file on the device instead of broadcast on the chat. Press **Tab** agian to go back to chat mode. 

## BT mode
Your cyberdeck can also act as a Bluetooth keyboard. 
To activate BT mode, Type `/bt` on your deck. The device is visible as Bluetooth HID device with your nickname as the device name.

This has two functions:
1. Use it as a keyboard to remote control your computer / phone / tv etc.
2. It can type out the notes you stored in Notes-mode automatically into whatever text area you have open on your device.
To activate this press the `FN` key, then press `ESC`. 

**MAKE SURE YOU HAVE A TEXT EDITOR (NOTES, AN EMAIL) OPEN BEFORE YOU ACTIVATE THIS.**

Notes are *not* cleared automatically after sending, use `/clearnotes`
when you're done with them.