Follow-ups left open by the TX page-ring fix and its review follow-up (#451, #453)

オープン
#455 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
c, linux

調査の方向性

This issue collects several deferred items rather than a single change. Start with the relevant sections of docs/jaguar3-tx-ring.md and src/jaguar3/CLAUDE.md, then inspect the specific entry points named in the item you choose, such as IRadio::StopBeacon, IRtlRadio::GetTxDmaStatus, or src/jaguar3/TxQueueMap.h; tests/txqueue_selftest.cpp covers the queue-map behavior. Agree on one bounded item with maintainers first, and consider it done only when its behavior is measured or tested as appropriate.

索引モデルが issue の本文から書いたものです。

説明

enhancement

Items deferred out of #451 (the REG_CR 0xFF-before-LLT-init fix) and #453 (its review follow-up), all pre-existing on master or deliberately left as they are. None changes the fix itself.

Beacon lifecycle

  1. StopBeacon result contract. It returns false both for "nothing active" (the IRadio contract) and for "a disable write was refused", so a caller cannot tell them apart. txdemo's TxBeaconGuard therefore ends its loop on any false, and a refused disable on Jaguar2 (which has no teardown power-down) can leave the beacon airing until re-enumeration. Fix shape: a distinct result from StopBeacon (tri-state or a BeaconStopResult), after which the guard retries only the refused case. Interim without an API change: after a successful StartBeacon (armed == true) both Jaguar2 and Jaguar3 return false only on a refused disable and keep _bcn_hw_touched, so if (!dev->StopBeacon() && armed) continue; in the guard's loop already gives the retry that matters.
  2. A failed pre-touch step during a Jaguar2/3 re-arm leaves the old beacon airing (#451 review round 10).
  3. Jaguar1 StartBeacon returns true after a failed PinBeaconTbtt(0) re-download (#451 round 7).
  4. Kestrel has no StopBeacon: it inherits the IRadio no-op, so a Kestrel beaconing session cannot disarm mid-session (#451 round 3; untestable on that PR's bench).

Send path

  1. Jaguar1 and Jaguar2 copy _ampdu unsynchronized on the send path (#451 round 9); Jaguar3 was fixed there, the other two were not.
  2. Below 3 bulk-OUT endpoints the SetAmpduMode TID lands on data frames that ride endpoint 0: a descriptor/endpoint mismatch on the 1- and 2-endpoint shapes, deliberately kept and pinned by tests/txqueue_selftest.cpp (src/jaguar3/TxQueueMap.h). Neither the 1/2- nor the 4-endpoint shape has been measured; the DEVOURER_TX_QSEL override can produce the same mismatch on any shape.

TXDMA_STATUS decoding

  1. Only two bits of REG_TXDMA_STATUS are decoded (IRtlRadio::GetTxDmaStatus): bit 18 BIT_TXPKTBUF_REQ_ERR, the one measured with the wedge, and bit 13 BIT_PAYLOAD_OVF_8822C, which latches under max-duty USB2 backpressure while TX continues. The 8812BU's wedge read 0x10 then 0x15, undecoded. The bit-13 latch is intermittent: seen from the first sample on an 8812CU at DEVOURER_TX_GAP_US=0 on 2026-09-26/27, and absent in 26/26 samples of an otherwise identical cold-cycled run at #453's head. A poller that wants a "stopped" verdict needs the remaining bits decoded against halmac_bit_8822c.h / the 8822B equivalent and each one measured.

Bench

  1. The 8812EU cell is unusable at max-duty 1400-byte TX: the bare module (external 5 V, 0bda:a81a) drops off USB about 2 s in, every build, so #451 and #453 were validated on the 8812CU and 8812BU only. Consistent with the pre-existing 5 GHz flood NAK behaviour plus a likely supply brownout; needs a powered fixture before the EU die can be a witness for either fix.

Context and measurements: #451 and #453 bodies, docs/jaguar3-tx-ring.md, src/jaguar3/CLAUDE.md.

主要言語
C
スター
56
フォーク
29
平均マージ
3時間 43分
マージ済み PR(30日)
75

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

OpenIPC/devourer のほかの issue

OpenIPC/devourer の issue をすべて見る

似ている issue

C の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。