meshcore-cardputer-adv

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #android #machine-learning #deep-learning #linux #docker #nodejs #java #vue #ios #open-source

meshcore-cardputer-adv

(★ 13)

MeshCore Cardputer-Adv + Cap LoRa-1262 variant. Still in development 🚧

meshcore-cardputer-adv Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## MeshCore Cardputer-Adv + Cap LoRa-1262 variant

![photo](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/logo.jpg)

![settings](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/settings.jpg)

![chat](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/chat.jpg)

![ping](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/ping.jpg)

This variant designed to not change the original codebase. I tried to make the implementation as clean as possible.

### Building

1. Get a copy of [MeshCore](https://github.com/meshcore-dev/MeshCore). Current development is based on v1.16.0.

2. Copy the `variants/cardputer_adv` directory from this repository into the `variants` directory of the MeshCore source tree.

3. Run in the MeshCore directory:

Build:

```bash
platformio run --environment cardputer_adv_companion_radio_ble
```

Build and flash:

```bash
platformio run --target upload --environment cardputer_adv_companion_radio_ble
```

### Flashing pre-build binaries

1. Grab .bin file from [Releases](https://github.com/MultiMote/meshcore-cardputer-adv/releases) page. The "merged" firmware will not erase your settings because they are stored on the SD card.
2. Flash with https://meshcore.io/flasher or with any other ESP32S3 flaser.

### State

> [!WARNING]
> Firmware is under development. Some settings may reset after flashing a new version. Back up your data if you don't want to lose anything.

Currently implemented (companion):

- Cap LoRa-1262 initialization (+ port extender)
- BLE connection
- GPS support
- GPS power management with CAS commands (Cap LoRa-1262 does not have a GPS switch pin)
- Store data to SD card
  * All default MeshCore settings (data is not grouped into single directory because the default paths are hardcoded)
  * Custom settings, chat history (`meshcore_custom` directory)
- Basic speaker support (keyboard/message beeps)
- Keyboard support
- Settings menu (press `OPT` at main screen)
- Tools menu (press `T` at main screen)
   * Advert (flood / zero hop)
   * Discover repeaters (testing)
- Power optimizations
   - Light sleep
      * Power consumption drops to ~22mA after display off
      * Can be enabled in settings menu
      * Bluetooth connection is not preserved
   - Audio codec power control
- Battery ADC correction
- Channels list
   * Press `Enter` on channel to start conversation
- Contacts list
   * Press `Enter` on repeater/room to ping
   * Press `Enter` on contact to start conversation
   * Press `r` to reset path
- Compose and send messages
   * After sending group message, "Heard repeats" appears (if any)
   * After sending direct message, "Message delivered" appears (if ACK received)
   * Retry direct message sending if ACK is not received
   * Press `Ctrl+Up` to insert last sent message into the text field
   * Press `Ctrl+T` to break resending

- Chat history
   * Full history stored on SD card
   * Last 15 messages stored in buffer
   * When contact/channel is selected, history is loaded from SD card
   * Press `Up`/`Down` to scroll
- Unread counter
   * On main screen
   * Near contact/channel
- Basic display unicode support. Font is `DejaVu Sans 12` converted with `Processing 4` to vlw format.

Included unicode blocks:
   * Basic Latin (U+0000-U+007F)
   * Latin-1 Supplement (U+0080-U+00FF)
   * Latin Extended-A (U+0100-U+017F)
   * Cyrillic (U+0400-U+04FF)
   * Currency Symbols (U+20A0-U+20CF)
   * Arrows (U+2190-U+21FF)

- Keyboard layouts

* Enabled if `/meshcore_custom/keyboard_alt.txt` file is present on SD card
   * Switch with Ctrl+Space
   * Create own layout with [Layout Editor](https://github.com/MultiMote/cardputer-adv-layout-editor).
   * Up to 3 byte character replacement (UTF-8)
   * Ready to use: [keyboard_layouts](keyboard_layouts)
   * More info: https://github.com/MultiMote/meshcore-cardputer-adv/wiki/Keyboard-layout-format

Todo:

- Find a way to include MeshCore as submodule in this repository and build it from here
- Change display brightness
- Custom notification sounds (.wav files from SD card)
- Import contacts from SD card
- Delete contacts
- Add hash channels

### Thoughts on Cardputer

Due to the high power consumption of this device, I don't think it's a good choice for always-on MeshCore companion.

It draws about 130-180 mA in idle state.

I also don't quite understand the decisions made by M5Stack:

1. GPS is always on in the Cap LoRa-1262 as ON/OFF pin is connected to 3.3v. Cap LoRa-1262 has IO expander IC (PI4IOE) with 7 unused pins. Why not use them?

![gps](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/gps.png)

2. To enable radio, you need to set P0 of IO expander IC to high level. Without this, FM8625H remains unpowered.
   Usually radio might be damaged when antenna is not connected during transmission.

![sw1](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/sw1.png)

![sw2](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/sw2.png)

3. Cardputer has 1750mAh battery, but PROG resistor of TP4057 is 3.3k. Maximum charge current is 303mA.
   Also Cardputer charges only if power switch is on.

![prog](https://raw.githubusercontent.com/MultiMote/meshcore-cardputer-adv/main/images/prog.png)

meshcore-cardputer-adv

meshcore-cardputer-adv Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

meshcore-cardputer-adv

meshcore-cardputer-adv Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README