1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
SHELL := /bin/bash
.DEFAULT_GOAL := help
-include .env
export
IDF_PATH ?= $(HOME)/esp/esp-idf
PROJECT_DIR := $(shell pwd)
BUILD_DIR := $(PROJECT_DIR)/build
PORT_A ?= /dev/ttyACM0
PORT_B ?= /dev/ttyACM1
PORT ?= $(PORT_A)
BAUD ?= 460800
TARGET ?= esp32s3
NODE ?= node
NPM ?= npm
PYTHON ?= python3
.PHONY: help setup detect-ports detect-chip detect-all
.PHONY: flash flash-a flash-b monitor monitor-a monitor-b
.PHONY: test smoke test-api test-portal test-network test-full
.PHONY: tokens test-payment wallet-setup wallet-info wallet-balance mint-token send-token
.PHONY: clean erase-nvs reset serial-log
.PHONY: bootstrap-config
help:
@echo "TollGate ESP32 — Makefile"
@echo ""
@echo "Discovery:"
@echo " detect-ports List connected ESP32 serial ports"
@echo " detect-chip Identify chip type on PORT"
@echo " detect-all Full device inventory"
@echo ""
@echo "Build & Flash:"
@echo " flash Build + flash to PORT (default: PORT_A)"
@echo " flash-a Flash to PORT_A"
@echo " flash-b Flash to PORT_B"
@echo " monitor Serial monitor on PORT"
@echo ""
@echo "Test (Phase 1):"
@echo " test Run all Phase 1 tests"
@echo " smoke Quick 30s smoke test"
@echo " test-api curl API endpoint tests"
@echo " test-portal Playwright captive portal tests"
@echo " test-network DNS/NAT connectivity tests"
@echo " test-full All 14 Phase 1 tests"
@echo ""
@echo "Test (Phase 2):"
@echo " wallet-setup Initialize nutshell wallet for test mint"
@echo " wallet-info Show mint info"
@echo " wallet-balance Show wallet balance"
@echo " mint-token Invoice + send test token (AMOUNT=21)"
@echo " send-token Send cashuA token (AMOUNT=21)"
@echo " tokens Alias for send-token"
@echo " test-payment Payment flow tests"
@echo ""
@echo "Utilities:"
@echo " setup One-time: install esptool, deps"
@echo " clean Clean build"
@echo " erase-nvs Erase NVS partition on PORT"
@echo " reset Hardware reset on PORT"
@echo " bootstrap-config Write .env values to SPIFFS config.json"
@echo " serial-log Capture serial output"
# ──────────────────────────────────────────────
# Discovery
# ──────────────────────────────────────────────
detect-ports:
@echo "=== Serial Ports ==="
@ls /dev/ttyACM* /dev/ttyUSB* 2>/dev/null || echo "No serial ports found"
@echo ""
@echo "=== USB Devices ==="
@lsusb 2>/dev/null | grep -i -E "serial|uart|cp210|ch340|ftdi|esp" || true
@echo ""
@echo "=== By ID ==="
@ls -la /dev/serial/by-id/ 2>/dev/null || true
detect-chip:
@echo "=== Detecting chip on $(PORT) ==="
@python3 -m esptool --port $(PORT) chip_id 2>&1 || \
$(PYTHON) -c "import esptool; esptool.main(['--port','$(PORT)','chip_id'])" 2>&1 || \
echo "esptool not found. Run: pip install esptool"
@echo ""
@python3 -m esptool --port $(PORT) flash_id 2>&1 || true
detect-all: detect-ports
@for port in /dev/ttyACM* /dev/ttyUSB*; do \
[ -e "$$port" ] || continue; \
echo ""; \
echo "=== Device at $$port ==="; \
python3 -m esptool --port $$port chip_id 2>&1 | head -5 || true; \
python3 -m esptool --port $$port flash_id 2>&1 | head -5 || true; \
done
# ──────────────────────────────────────────────
# Setup
# ──────────────────────────────────────────────
setup:
@echo "=== Installing esptool ==="
pip install esptool 2>/dev/null || pip3 install esptool
@echo ""
@echo "=== Checking ESP-IDF ==="
@test -d $(IDF_PATH) && echo "ESP-IDF found at $(IDF_PATH)" || \
echo "ESP-IDF not found at $(IDF_PATH). Install from https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/"
@echo ""
@echo "=== Installing Node deps ==="
$(NPM) install
@echo ""
@echo "=== Installing Python deps ==="
pip install pyserial 2>/dev/null || pip3 install pyserial
@echo ""
@echo "Setup complete!"
# ──────────────────────────────────────────────
# Build & Flash
# ──────────────────────────────────────────────
flash: build
@echo "=== Flashing to $(PORT) ==="
. $(IDF_PATH)/export.sh && idf.py -p $(PORT) -b $(BAUD) flash
flash-a: PORT=$(PORT_A)
flash-a: flash
flash-b: PORT=$(PORT_B)
flash-b: flash
build:
@echo "=== Building $(TARGET) ==="
. $(IDF_PATH)/export.sh && \
idf.py set-target $(TARGET) 2>/dev/null; \
idf.py build
monitor:
. $(IDF_PATH)/export.sh && idf.py -p $(PORT) monitor
monitor-a: PORT=$(PORT_A)
monitor-a: monitor
monitor-b: PORT=$(PORT_B)
monitor-b: monitor
# ──────────────────────────────────────────────
# Test Infrastructure
# ──────────────────────────────────────────────
test: test-api test-network
@echo "=== All tests passed ==="
smoke:
@echo "=== Running smoke test (30s) ==="
$(NODE) tests/smoke.mjs $(PORT)
test-api:
@echo "=== Running API tests ==="
$(NODE) tests/api.mjs
test-portal:
@echo "=== Running Playwright portal tests ==="
npx playwright test tests/captive-portal.spec.mjs
test-network:
@echo "=== Running network tests ==="
$(NODE) tests/network.mjs
test-full: test-api test-portal test-network
@echo "=== Full test suite passed ==="
# ──────────────────────────────────────────────
# Phase 2: Payment Testing (Nutshell wallet)
# ──────────────────────────────────────────────
wallet-setup:
@echo "=== Setting up Nutshell wallet for $(TEST_MINT) ==="
cashu --env-mint $(TEST_MINT) info 2>/dev/null || \
cashu --env-mint $(TEST_MINT) restore
wallet-info:
@echo "=== Mint info ==="
cashu --env-mint $(TEST_MINT) info
wallet-balance:
@echo "=== Wallet balance ==="
cashu --env-mint $(TEST_MINT) balance
mint-token:
@echo "=== Minting test token (AMOUNT=$(or $(AMOUNT),21)) ==="
@AMOUNT=$${AMOUNT:-21}; \
cashu --env-mint $(TEST_MINT) invoice $$AMOUNT && \
echo "--- Token (cashuA legacy) ---" && \
cashu --env-mint $(TEST_MINT) send --legacy $$AMOUNT
send-token:
@AMOUNT=$${AMOUNT:-21}; \
echo "=== Sending $$AMOUNT sats as cashuA token ===" && \
cashu --env-mint $(TEST_MINT) send --legacy $$AMOUNT
tokens: send-token
test-payment:
@echo "=== Running payment tests ==="
$(NODE) tests/phase2.mjs
# ──────────────────────────────────────────────
# Utilities
# ──────────────────────────────────────────────
clean:
rm -rf $(BUILD_DIR) sdkconfig sdkconfig.old
. $(IDF_PATH)/export.sh && idf.py fullclean
erase-nvs:
@echo "=== Erasing NVS on $(PORT) ==="
. $(IDF_PATH)/export.sh && \
partition_offset=$$(idf.py partition-table 2>/dev/null | grep nvs | awk '{print $$2}'); \
python3 -m esptool --port $(PORT) erase_region $$partition_offset 0x6000
reset:
@echo "=== Resetting device on $(PORT) ==="
python3 -m esptool --port $(PORT) run 2>/dev/null || true
serial-log:
@echo "=== Capturing serial output from $(PORT) ==="
python3 -c "import serial; s=serial.Serial('$(PORT)',115200,timeout=1); \
[print(s.readline().decode(errors='replace'),end='') for _ in iter(lambda: s.readline(), b'')]"
bootstrap-config:
@echo "=== Bootstrapping config.json ==="
@echo '{"wifi_networks":[{"ssid":"$(WIFI_SSID)","password":"$(WIFI_PASSWORD)"}],"ap_ssid":"$(AP_SSID)","ap_password":"$(AP_PASSWORD)","mint_url":"$(MINT_URL)","lnurl_url":"$(LNURL_URL)","price_per_step":$(PRICE_PER_STEP),"step_size_ms":$(STEP_SIZE)}' > main/config.json
@echo "Config written to main/config.json"
|