jpmschweitzer/desklock

Fork 0

Files

T

jpmschweitzerandClaude Fable 5 cb5826e02b

Test, Build and Push / test-gateway (push) Successful in 12s

Details

Test, Build and Push / release (push) Skipped

Details

Test, Build and Push / build-gateway (push) Skipped

Details

Fork fix: the SDIO wedge is FIXED (esp-hosted-mcu #167 )

Root cause (verified against our exact IDF tree, not the community guess):
the "258" in "sdio_write_task: Failed to send data: 258" is NOT a timeout
(that is 263). 258 = 0x102 = ESP_ERR_INVALID_ARG. On the ESP32-P4, block-
mode CMD53 writes require the SOURCE buffer to be 64-byte (cache-line)
aligned; the IDF sdmmc driver rejects a misaligned source with INVALID_ARG
BEFORE any bus activity. esp_hosts write loop then declares "Unrecoverable
host sdio state" and reboots the whole P4. The audio TX payload is not
64-aligned, so streaming mic audio wedged on the very FIRST frame (which is
exactly what we saw: listening -> instant Failed to send -> reboot).

This also explains why buffer/queue/clock/retry tuning all did nothing: the
write never reached the bus. And why our symptom was instant, not after
~100 writes (the community block-mode-desync theory) — it is the first
misaligned buffer, every time.

Fix: vendored esp_hosted 2.12.11 as an editable local component (overrides
the registry copy) and bounce a misaligned TX payload through one aligned
DMA scratch buffer in hosted_sdio_write_block (port_esp_hosted_host_sdio.c).
TX is serialized by the bus lock so a single static bounce buffer is safe;
freed in hosted_sdio_deinit. Host-only change — no C6 reflash.

VERIFIED ON HARDWARE (autonomous self-test): 40s of continuous mic-audio
upstream streaming — the traffic that previously wedged on the first frame
— ran clean, zero timeouts, zero reboots. A guarded SDIO_TX_SELFTEST harness
is kept (compiled out) for future SDIO stress testing.

Credit: root cause + patch designed via multi-agent investigation; the
precise 258=INVALID_ARG decode (correcting the upstream community timeout
assumption) came from checking our actual esp_err.h.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-15 09:50:27 +02:00

9.7 KiB

Raw Blame History

List of RPC Commands implmenented in ESP-Hosted

A list of RPC Commands implemented in ESP-Hosted based on release version.

The RPC IDs listed here are for requests and events. Each request will have a corresponding response.

List of RPC Requests

No.	RPC ID	RPC Command	Added in Release
1	257	GetMacAddress	0.0.6
2	258	SetMacAddress	0.0.6
3	259	GetMode	0.0.6
4	260	SetMode	0.0.6
5	261	SuppDppInit	2.4.3
6	262	SuppDppDeinit	2.4.3
7	263	SuppDppBootstrapGen	2.4.3
8	264	SuppDppStartListen	2.4.3
9	265	SuppDppStopListen	2.4.3
10	270	SetPs	0.0.6
11	271	GetPs	0.0.6
12	272	OTABegin	0.0.6
13	273	OTAWrite	0.0.6
14	274	OTAEnd	0.0.6
15	275	WifiSetMaxTxPower	0.0.6
16	276	WifiGetMaxTxPower	0.0.6
17	277	ConfigHeartbeat	0.0.6
18	278	WifiInit	0.0.6
19	279	WifiDeinit	0.0.6
20	280	WifiStart	0.0.6
21	281	WifiStop	0.0.6
22	282	WifiConnect	0.0.6
23	283	WifiDisconnect	0.0.6
24	284	WifiSetConfig	0.0.6
25	285	WifiGetConfig	0.0.6
26	286	WifiScanStart	0.0.6
27	287	WifiScanStop	0.0.6
28	288	WifiScanGetApNum	0.0.6
29	289	WifiScanGetApRecords	0.0.6
30	290	WifiClearApList	0.0.6
31	291	WifiRestore	0.0.6
32	292	WifiClearFastConnect	0.0.6
33	293	WifiDeauthSta	0.0.6
34	294	WifiStaGetApInfo	0.0.6
35	297	WifiSetProtocol	0.0.6
36	298	WifiGetProtocol	0.0.6
37	299	WifiSetBandwidth	0.0.6
38	300	WifiGetBandwidth	0.0.6
39	301	WifiSetChannel	0.0.6
40	302	WifiGetChannel	0.0.6
41	303	WifiSetCountry	0.0.6
42	304	WifiGetCountry	0.0.6
43	311	WifiApGetStaList	0.0.6
44	312	WifiApGetStaAid	0.0.6
45	313	WifiSetStorage	0.0.6
46	325	WifiSetInactiveTime	2.2.2
47	326	WifiGetInactiveTime	2.2.2
48	334	WifiSetCountryCode	0.0.6
49	335	WifiGetCountryCode	0.0.6
50	337	WifiDisablePmfConfig	2.12.9
51	338	WifiStaGetAid	0.0.10
52	339	WifiStaGetNegotiatedPhymode	1.1.3
53	341	WifiStaGetRssi	0.0.6
54	342	WifiSetProtocols	0.0.10
55	343	WifiGetProtocols	0.0.10
56	344	WifiSetBandwidths	0.0.10
57	345	WifiGetBandwidths	0.0.10
58	346	WifiSetBand	0.0.10
59	347	WifiGetBand	0.0.10
60	348	WifiSetBandMode	0.0.10
61	349	WifiGetBandMode	0.0.10
62	350	GetCoprocessorFwVersion	1.0.0
63	351	WifiScanGetApRecord	1.1.3
64	352	SetDhcpDnsStatus	2.1.0
65	353	GetDhcpDnsStatus	2.1.0
66	354	WifiStaTwtConfig	2.2.2
67	355	WifiStaItwtSetup	2.2.2
68	356	WifiStaItwtTeardown	2.2.2
69	357	WifiStaItwtSuspend	2.2.2
70	358	WifiStaItwtGetFlowIdStatus	2.2.2
71	359	WifiStaItwtSendProbeReq	2.2.2
72	360	WifiStaItwtSetTargetWakeTimeOffset	2.2.2
73	361	WifiStaEnterpriseEnable	2.4.0
74	362	WifiStaEnterpriseDisable	2.4.0
75	363	EapSetIdentity	2.4.0
76	364	EapClearIdentity	2.4.0
77	365	EapSetUsername	2.4.0
78	366	EapClearUsername	2.4.0
79	367	EapSetPassword	2.4.0
80	368	EapClearPassword	2.4.0
81	369	EapSetNewPassword	2.4.0
82	370	EapClearNewPassword	2.4.0
83	371	EapSetCaCert	2.4.0
84	372	EapClearCaCert	2.4.0
85	373	EapSetCertificateAndKey	2.4.0
86	374	EapClearCertificateAndKey	2.4.0
87	375	EapGetDisableTimeCheck	2.4.0
88	376	EapSetTtlsPhase2Method	2.4.0
89	377	EapSetSuiteb192bitCertification	2.4.0
90	378	EapSetPacFile	2.4.0
91	379	EapSetFastParams	2.4.0
92	380	EapUseDefaultCertBundle	2.4.0
93	381	WifiSetOkcSupport	2.4.0
94	382	EapSetDomainName	2.4.0
95	383	EapSetDisableTimeCheck	2.4.0
96	384	EapSetEapMethods	2.4.0
97	385	IfaceMacAddrSetGet	2.5.2
98	386	IfaceMacAddrLenGet	2.5.2
99	387	FeatureControl	2.5.2
100	266	OTAActivate	2.6.0
101	267	AppGetDesc	2.6.7
102	388	CustomRpc	2.8.1
103	389	GpioConfig	2.10.0
104	390	GpioResetPin	2.10.0
105	391	GpioSetLevel	2.10.0
106	392	GpioGetLevel	2.10.0
107	393	GpioSetDirection	2.10.0
108	394	GpioInputEnable	2.10.0
109	395	GpioSetPullMode	2.10.0
110	268	MemMonitor	2.11.7
111	269	WifiScanParams	2.12.0
112	396	ExtCoex	2.12.1

List of RPC Events

No.	RPC ID	RPC Event	Added in Release
1	769	ESPInit	0.0.6
2	770	Heartbeat	0.0.6
3	771	AP_StaConnected	0.0.6
4	772	AP_StaDisconnected	0.0.6
5	773	WifiEventNoArgs	0.0.6
6	774	StaScanDone	0.0.6
7	775	StaConnected	0.0.6
8	776	StaDisconnected	0.0.6
9	777	DhcpDnsStatus	2.0.17
10	778	StaItwtSetup	2.2.2
11	779	StaItwtTeardown	2.2.2
12	780	StaItwtSuspend	2.2.2
13	781	StaItwtProbe	2.2.2
14	782	SuppDppUriReady	2.4.3
15	783	SuppDppCfgRecvd	2.4.3
16	784	SuppDppFail	2.4.3
17	785	WifiDppUriReady	2.4.3
18	786	WifiDppCfgRecvd	2.4.3
19	787	WifiDppFail	2.4.3
20	788	CustomRpc	2.8.1
21	789	MemMonitor	2.11.7

9.7 KiB Raw Blame History

List of RPC Commands implmenented in ESP-Hosted

List of RPC Requests

List of RPC Events

9.7 KiB

Raw Blame History