From MAILER-DAEMON Sun Jun 21 06:50:39 2026 Received: from list by lists.fsf.org with archive (Exim 4.90_1) id 1wbFl9-0004L2-EG for mharc-librephone@fsf.org; Sun, 21 Jun 2026 06:50:39 -0400 Received: from mail.fsf.org ([2001:470:142::13]) by lists.fsf.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wbFl7-0004Kq-UO for librephone@fsf.org; Sun, 21 Jun 2026 06:50:37 -0400 Received: from mail-yw1-x112c.google.com ([2607:f8b0:4864:20::112c]) by mail.fsf.org with esmtps (TLS1.3:ECDHE_X25519__RSA_PSS_RSAE_SHA256__AES_128_GCM:128) (Exim 4.93) (envelope-from ) id 1wbFl5-008qMv-T9 for librephone@fsf.org; Sun, 21 Jun 2026 06:50:37 -0400 Received: by mail-yw1-x112c.google.com with SMTP id 00721157ae682-7dc6fbf3e86so41070317b3.3 for ; Sun, 21 Jun 2026 03:50:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1782039034; cv=none; d=google.com; s=arc-20240605; b=TjetV2M9dwi6XuqoSKiDVk1iCx+7GD1B7cc1K9XMujm2ffvGQ4C0TyCqkaOI3WLyXn uvvQRL9f8smY+GlVKqTOMUIXH2JBNVU2FxBxfBhUQxyjJOYZJwiLZDvXhmOpCDfxcBmR uDiiDCQuGZVyw6rcJ5YPmWIGHlWPrx5FV2L3W00HJM6dY00ynplYmaKCvkDiF7KaebWk hkQcXuT1zZPo8VT3z85aumvYQJ9TPrGwLg1WLiQGu+fOkuEKJSw2ITmyWG1ksrhno2l2 16haMp6LM/SnVWSdbLsWC0tLqvxkE3hkrxcuZGrJfbzIjupAhd11BHI2G0Br7sd0uTUq CF1w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=to:subject:message-id:date:from:mime-version:dkim-signature; bh=4jI7iYWqyQrBoRqpBMxrWlyAcngMljDNW9tAnRkquDU=; fh=iEYYQ1IJuZrac3/e6lhfSVwcRs12hfOmoCfVqhaIeQE=; b=ApNanUKSgD0SlEK0ZeEbp/jAJYyNAeBdorV8TpFfXD2MdIrJbHdZS5qvVBKn5Nccj+ XMeBTLv27gnQh+fka9v2feLLJ85HOTHT7POBZZ61rrrf1uDP9JQQjhDpLUiinMONgNp/ 61PtCPiB0QyNTBG7Dpe4h1WCohySjFUOqMopI7TtS5pgslJLh4vKsqu+DrII50F6XD+f mC8eaDJgl9vAlK2Zalb/AFVtnH7dIZhzfAB3KrC4PTs/AiITa1CN+BAdYVsA7XpFViWv GtE7uG7sNajWIMogKSl08LwmqY066QWVAJymhHhRebUWnlcmc2g4S20/W1K7BBKao25I f5SA==; darn=fsf.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1782039034; x=1782643834; darn=fsf.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=4jI7iYWqyQrBoRqpBMxrWlyAcngMljDNW9tAnRkquDU=; b=hdKbGv7sPU/kEeY5yJUWNYufEj3aX+QCtEMls7rAuNZ1M1QR+z2GRw3xTwtlrofMyX pgm9GlSlzA/japvJ8vL2HaUhZzSgufs2Srkqc9pGINY7AFqCVvVV0hggJPy6WFVcrz2S fX7lis4Zj0Nd7fXNlEnMeVEjWOcHNBkNvRieL69sTEx57TuO52u0O4JgHNZtn4n2KdhW +6Uq+N/F7aEAXNhAtEAmX3YvBJx8vI4mp2XNeZ471sUhUr0/f23EqMCXPbVak5Bw4JHl OLQiEbJ2WayKc128rWXPI8JIJ9TIoGO/fw9ShVp9FWTEWklQkY7jiWuL9LAR8h1n9DOx XYhA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1782039034; x=1782643834; h=to:subject:message-id:date:from:mime-version:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=4jI7iYWqyQrBoRqpBMxrWlyAcngMljDNW9tAnRkquDU=; b=X6NBqmbYepanjOJuI0jsgo+3+BOm/NBYYYKMUb/7rh+do3aOcu25wjNaFGOdN9j2NZ XHslOY/d+LH4jl/zBOgg4FkEUHjBLZrSoy5mLNypjSXA5nbxADa8NjcAE07cz+LuPEnv Er4EgyrPvU7EX0/ONl4Dbj3z9S2+DoxB6Ezgi15YfSmjux6U5KLOu2pkocXV9XTfpNSl zccJIjnbuQRCGzV1yIOOByoSIXtYPSKwVn8iIRIdb9L54XFfLB9CBDDAcgTh+3mIJSv8 ctRfr+9jkEUqQ6FdZhqHHM9HYKn93MM46CYCYtWGRTMUClT8vZFSExBb4esemG/NUJ1Q TkUw== X-Gm-Message-State: AOJu0YwXfA4tkvv5V6TCs3jzwXkE3VjSBj5wAF6dCja2lvWSBDCHepjt 1Y8rCytzC680rmbZu1xDeuahzHskzR4vxhsx3WJ2I8h3o0q/uqPC7cSL0lTGqfAcp7OaDwtpj3K gC8VNb8Jg4dViENjCLbizLcxDXxuyYhNiYdk1pSE= X-Gm-Gg: AfdE7cmEqImfTLvViPj2ndccplrm4uDgreOaytgIlQwRulnCfHm4jUY20KmcAmc6eyf 3JXdBAoe35f7tVeIC/pUCjyBc6GLBfMSPlYbghKSwcsq/BtBLjFiv9g+605XOPz6uuCW7G4basZ SJX/OvNhGlf7T6Y/WNqybEc6aFFAFeB14rinqBzCInW96vyoYDR/9H0dcoy/1RXkf+MyMvT4/zL q1+5iQzPVgticZ89Q3hVEP40zlJTUY0LywS2aX4aiJt0nd8dpjClZiSH1ur75pRn+05hJfFaV8r 9zVi03kcbQwQUwdPHUbpryAZIH4+Aiy88xvd9wJdiYa3rsr4gIvFkHdwUFXg8zjxKQe5h4KX0pv CVwu7/R/I3Chlxg== X-Received: by 2002:a05:690c:6607:b0:7dc:c477:9e98 with SMTP id 00721157ae682-80177c8176emr95118257b3.31.1782039033537; Sun, 21 Jun 2026 03:50:33 -0700 (PDT) MIME-Version: 1.0 From: "Gustavo F. Paredes Delaloye - LU2JGP" Date: Sun, 21 Jun 2026 12:50:16 +0200 X-Gm-Features: AVVi8CdgS3EGdVeC9EEG5vTpECwZc0dY_bRUJx5I8JUCXHvPY7ldLS0VzcPCggA Message-ID: Subject: =?UTF-8?Q?Getting_started_=E2=80=94_HTT=2FHIF_documentation_draft_for_?= =?UTF-8?Q?WCN6750?= To: LibrePhone List Content-Type: multipart/alternative; boundary="00000000000091ea300654c14ba0" Received-SPF: pass client-ip=2607:f8b0:4864:20::112c; envelope-from=lu2jgp@gmail.com; helo=mail-yw1-x112c.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_KAM_HTML_FONT_INVALID=0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: librephone@fsf.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: This is for discussion about the librephone project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 21 Jun 2026 10:50:38 -0000 --00000000000091ea300654c14ba0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Rob, Following your guidance, I spent time reading through the sm7635-modules code (qca-wifi-host-cmn and qcacld-3.0) and cross-referencing it with the existing docs on the site. Here's what I found and what I'd like to contribute. What I documented so far: The fw-api/fw/htt.h file turned out to be the key source =E2=80=94 it's ~19= ,000 lines and acts as the complete contractual spec between the driver and the WPSS blob. I've drafted a new docs/htt.md file that covers: The full H2T message type enum (42 types, 0x00=E2=80=930x2a) The full T2H message type enum (63 types, 0x00=E2=80=930x3f) The mandatory initialization handshake sequence extracted from htt_attach_target() in qcacld-3.0/core/dp/htt/htt.c Physical transport: CE pipe 1 (T2H) and CE pipe 4 (H2T) Initialization sequence (extracted from htt_attach_target()): H2T VERSION_REQ (0x0) =E2=86=92 T2H VERSION_CONF (0x0) H2T FRAG_DESC_BANK_CFG (0x6) H2T RX_RING_CFG (0x2) H2T IPA_CFG (0x8) [optional] One correction I found in the existing docs: The ath11k.md doc says HIF "currently only supports PCI." For the WCN6750 this is not accurate =E2=80=94 the WCN6750 is integrated into the SM7635 So= C and uses the SNOC/AHB bus, not PCIe. The code is in qca-wifi-host-cmn/hif/src/snoc/. The HIF_TYPE_QCA6750 (ID 23) is defined separately in hif.h. I'd like to fix this in a PR along with adding the missing HTT layer to the stack diagram. Next step I'd like to tackle: The message type tables tell us what messages exist, but not the bit-field layout of each one. The highest-value next step seems to be documenting the exact wire format of the 4 mandatory initialization messages (VERSION_REQ/CONF, FRAG_DESC_BANK_CFG, RX_RING_CFG) =E2=80=94 those are the= minimum a re-implemented blob would need to handle to come alive. I also didn't find the "low-level testing API" for the WCN6750 that you mentioned. You said it's buried in the sm7635-modules =E2=80=94 could you p= oint me to the specific file or directory? I looked in qcacld-3.0/components/ but it's a large tree. Is the blobs directory at librephone.fsf.org/blobs/FP6/ accessible? I'm getting a 404 =E2=80=94 I'd like to cross-reference the actual blob files w= ith the protocol documentation. I'll send the draft docs as a PR to Codeberg once you confirm the direction is right. -- *"Per Aspera ad Astra"* Gustavo F. Paredes Delaloye -- My LinkedIn --00000000000091ea300654c14ba0 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Rob,

Following your guidance, I spent time = reading through the sm7635-modules code (qca-wifi-host-cmn and qcacld-3.0) = and cross-referencing it with the existing docs on the site. Here's wha= t I found and what I'd like to contribute.

What I documented so = far:

The fw-api/fw/htt.h file turned out to be the key source =E2=80= =94 it's ~19,000 lines and acts as the complete contractual spec betwee= n the driver and the WPSS blob. I've drafted a new docs/htt.md file tha= t covers:

The full H2T message type enum (42 types, 0x00=E2=80=930x2= a)
The full T2H message type enum (63 types, 0x00=E2=80=930x3f)
The m= andatory initialization handshake sequence extracted from htt_attach_target= () in qcacld-3.0/core/dp/htt/htt.c
Physical transport: CE pipe 1 (T2H) a= nd CE pipe 4 (H2T)
Initialization sequence (extracted from htt_attach_ta= rget()):

H2T VERSION_REQ (0x0) =E2=86=92 T2H VERSION_CONF (0x0)
H= 2T FRAG_DESC_BANK_CFG (0x6)
H2T RX_RING_CFG (0x2)
H2T IPA_CFG (0x8) [= optional]
One correction I found in the existing docs:

The ath11k= .md doc says HIF "currently only supports PCI." For the WCN6750 t= his is not accurate =E2=80=94 the WCN6750 is integrated into the SM7635 SoC= and uses the SNOC/AHB bus, not PCIe. The code is in qca-wifi-host-cmn/hif/= src/snoc/. The HIF_TYPE_QCA6750 (ID 23) is defined separately in hif.h. I&#= 39;d like to fix this in a PR along with adding the missing HTT layer to th= e stack diagram.

Next step I'd like to tackle:

The messag= e type tables tell us what messages exist, but not the bit-field layout of = each one. The highest-value next step seems to be documenting the exact wir= e format of the 4 mandatory initialization messages (VERSION_REQ/CONF, FRAG= _DESC_BANK_CFG, RX_RING_CFG) =E2=80=94 those are the minimum a re-implement= ed blob would need to handle to come alive.

I also didn't find t= he "low-level testing API" for the WCN6750 that you mentioned. Yo= u said it's buried in the sm7635-modules =E2=80=94 could you point me t= o the specific file or directory? I looked in qcacld-3.0/components/ but it= 's a large tree.

Is the blobs directory at librephone.fsf.org/blobs/FP6/ accessible? I= 'm getting a 404 =E2=80=94 I'd like to cross-reference the actual b= lob files with the protocol documentation.

I'll send the draft d= ocs as a PR to Codeberg once you confirm the direction is right.

--

"Per Asper= a ad Astra"
Gustavo F. Paredes Delaloye
--00000000000091ea300654c14ba0--