Files
mjgodatandClaude Opus 5.5 5681898ad4 Add M5Stack Cardputer-Adv variant with keyboard/display companion UI
New variant variants/m5stack_cardputer_adv for the Cardputer-Adv
(ESP32-S3, 8 MB) with the Cap LoRa-1262 (SX1262 + GNSS):

- Envs: companion_radio_ble, companion_radio_usb, repeater, room_server.
- Board: enables the Cap's antenna path via the PI4IOE5V6408 on the
  internal I2C bus (Wire1, G8/G9); Wire stays on the Grove port. LoRa and
  microSD share FSPI because the display owns SPI3. TCXO 1.8 V.
- Companion UI adapted from MultiMote/meshcore-cardputer-adv (MIT,
  LICENSE.MultiMote), running on the standard companion so the USB
  terminal CLI stays available. Contacts/identity stay in internal
  SPIFFS; the microSD card is optional (chat history, keyboard layouts).
- Sticky Shift, one-shot Fn with Fn+letter shortcuts, top button (G0)
  sends a flood advert, brightness control.
- Text size setting (Normal/Large/Extra large) with DejaVu Sans fonts
  generated by tools/gen_vlw_font.py; layouts derive from the font size.
- Power save maps to the companion's powersaving pref; the UI vetoes
  light sleep while the screen is on. Low-battery power-off at 3.4 V.
- win_long_cmdline.py: Windows-only -iprefix include shortening so the
  ESP32 compile command stays under the 32,767-character limit.

Shared companion changes are guarded by CARDPUTER_ADV_UI: main.cpp
selects CardputerDataStore/CardputerUITask/CardputerMesh, and MyMesh.h
maps the_mesh to the subclass like the PSRAM storage path does.

Tested on hardware (910.525 MHz mesh): radio RX/TX, USB CLI, BLE, UI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 16:24:43 -07:00

151 lines
2.6 KiB
C++

#pragma once
#include <Adafruit_TCA8418.h>
#include <stdint.h>
// Non normalized
// 1 5 11 15 21 25 31 35 41 45 51 55 61 65
// 2 6 12 16 22 26 32 36 42 46 52 56 62 66
// 3 7 13 17 23 27 33 37 43 47 53 57 63 67
// 4 8 14 18 24 28 34 38 44 48 54 58 64 68
// Normalized
// 1 5 9 13 17 21 25 29 33 37 41 45 49 53
// 2 6 10 14 18 22 26 30 34 38 42 46 50 54
// 3 7 11 15 19 23 27 31 35 39 43 47 51 55
// 4 8 12 16 20 24 28 32 36 40 44 48 52 56
namespace Keyboard {
// Normalized key codes
enum Key : uint8_t {
KEY_NONE = 0,
// Column 1
KEY_ESC = 1,
KEY_TAB = 2,
KEY_FN = 3,
KEY_CTRL = 4,
// Column 2
KEY_1 = 5,
KEY_Q = 6,
KEY_SHIFT = 7,
KEY_OPT = 8,
// Column 3
KEY_2 = 9,
KEY_W = 10,
KEY_A = 11,
KEY_ALT = 12,
// Column 4
KEY_3 = 13,
KEY_E = 14,
KEY_S = 15,
KEY_Z = 16,
// Column 5
KEY_4 = 17,
KEY_R = 18,
KEY_D = 19,
KEY_X = 20,
// Column 6
KEY_5 = 21,
KEY_T = 22,
KEY_F = 23,
KEY_C = 24,
// Column 7
KEY_6 = 25,
KEY_Y = 26,
KEY_G = 27,
KEY_V = 28,
// Column 8
KEY_7 = 29,
KEY_U = 30,
KEY_H = 31,
KEY_B = 32,
// Column 9
KEY_8 = 33,
KEY_I = 34,
KEY_J = 35,
KEY_N = 36,
// Column 10
KEY_9 = 37,
KEY_O = 38,
KEY_K = 39,
KEY_M = 40,
// Column 11
KEY_0 = 41,
KEY_P = 42,
KEY_L = 43,
KEY_COMMA = 44,
// Column 12
KEY_MINUS = 45,
KEY_LBRACKET = 46,
KEY_SEMICOLON = 47,
KEY_PERIOD = 48,
// Column 13
KEY_PLUS = 49,
KEY_RBRACKET = 50,
KEY_APOSTROPHE = 51,
KEY_SLASH = 52,
// Column 14
KEY_BACKSPACE = 53,
KEY_BACKSLASH = 54,
KEY_RETURN = 55,
KEY_SPACE = 56
};
enum Arrow : uint8_t {
ARROW_LEFT = 44,
ARROW_UP = 47,
ARROW_DOWN = 48,
ARROW_RIGHT = 52,
};
struct Modifiers {
bool fn = false;
bool ctrl = false;
bool shift = false;
bool opt = false;
bool alt = false;
bool any() const { return fn || ctrl || shift || opt || alt; }
};
struct Event {
Key key = KEY_NONE;
bool changed = false;
bool down = false;
Modifiers modifiers;
};
class CardputerKeyboard {
private:
Adafruit_TCA8418 tio;
Keyboard::Modifiers modifiers;
bool isModifier(Keyboard::Key key);
void updateModifier(Keyboard::Key key, bool down);
public:
CardputerKeyboard() {}
void begin();
Keyboard::Event poll();
// Shift latches on/off per press (caps lock); Fn arms for the next key
// only; Ctrl, Opt and Alt are held.
Keyboard::Modifiers getModifiers() const { return modifiers; }
void setModifiers(const Keyboard::Modifiers &m) { modifiers = m; }
};
}; // namespace Keyboard
using Keyboard::CardputerKeyboard;