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
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
|
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
TOLLGATE_IP ?= 10.192.45.1
.PHONY: help setup detect-ports detect-chip detect-all
.PHONY: flash flash-a flash-b monitor monitor-a monitor-b
.PHONY: test test-unit test-integration test-e2e test-all
.PHONY: test-smoke test-api test-network test-portal test-payment
.PHONY: test-reset-auth test-session-expiry test-dns-firewall
.PHONY: tokens wallet-setup wallet-info wallet-balance mint-token send-token
.PHONY: clean erase-nvs reset serial-log 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 "Testing:"
@echo " test-unit Host C unit tests (no hardware)"
@echo " test-integration Node.js integration tests (live board)"
@echo " test-e2e Playwright browser E2E tests"
@echo " test-all Run all three test layers"
@echo " test-smoke Quick 30s smoke test"
@echo " test-reset-auth Reset auth + per-client NAT filter test"
@echo " test-dns-firewall DNS hijack + NAT filter test"
@echo " test-session-expiry Session lifecycle with 65s expiry wait"
@echo ""
@echo "Wallet:"
@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 ""
@echo "Utilities:"
@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
# ──────────────────────────────────────────────
# Testing
# ──────────────────────────────────────────────
test-unit:
@echo "=== Running host unit tests ==="
$(MAKE) -C tests/unit test
test-integration: test-api test-network test-reset-auth test-dns-firewall
@echo "=== Integration tests passed ==="
test-e2e:
@echo "=== Running Playwright E2E tests ==="
cd tests/e2e && npx playwright test
test-all: test-unit test-integration test-e2e
@echo "=== All test layers passed ==="
test: test-unit test-integration
@echo "=== Tests passed ==="
test-smoke:
@echo "=== Running smoke test (30s) ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/smoke.mjs
test-api:
@echo "=== Running API tests ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/api.mjs
test-network:
@echo "=== Running network tests ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/network.mjs
test-portal:
@echo "=== Running Playwright portal tests ==="
cd tests/e2e && npx playwright test captive-portal.spec.mjs
test-payment:
@echo "=== Running payment tests ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/phase2.mjs
test-reset-auth:
@echo "=== Running reset auth test ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/test-reset-auth.mjs
test-session-expiry:
@echo "=== Running session expiry test (65s wait, ~80s total) ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/test-session-expiry.mjs
test-dns-firewall:
@echo "=== Running DNS + firewall test ==="
TOLLGATE_IP=$(TOLLGATE_IP) $(NODE) tests/integration/test-dns-firewall.mjs
# ──────────────────────────────────────────────
# 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:
@AMOUNT=$${AMOUNT:-21}; \
echo "=== Minting test token ($$AMOUNT sats) ==="; \
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
# ──────────────────────────────────────────────
# 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"
|