Add basic rateless codec support

[joe-calderon-ditto]

Hello,

This PR adds basic support for a rateless codec, working toward the RaptorQ / non-systematic codec support discussed in #7.

What's included

• A new rateless codec path through the encoder/segment layers, with the necessary message and session plumbing to carry it. A new underspecified scheme was added because I was unsure if rateless feel under the umbrella of small block codes, and I didn't know if using 6 would conflate general rateless codes to RaptorQ.
• API additions in normApi.h / normApi.cpp to enable and configure it.
• An examples/normRatelessTest.cpp example demonstrating the feature.

Notes

• This is an initial, "basic" implementation intended as a starting point rather than a complete solution — feedback on the approach would be appreciated.
• I'd be happy to adjust naming, API shape, or integration points to better match how you'd like rateless/non-systematic codecs to be handled in NORM.
• I added NormTelemetry so rateless encoders could implement their own rate control for both proactive and reactive parity using metrics provided by norm.

If the interface looks ok, I can follow this pr with an actual implementation of a rateless codec.

[bebopagogo]

Wow - this has been on my "to do" list for some time. I will take a look and happy to dig in to help make it happen. I understand this has the plumbing but not not a specific associated FEC codec yet.

…

On Thu, Jun 18, 2026 at 5:24 PM joe-calderon-ditto ***@***.***> wrote: Hi, and thanks for NORM! This PR adds basic support for a rateless codec, working toward the RaptorQ / non-systematic codec support discussed in #7 <#7>. What's included - A new rateless codec path through the encoder/segment layers, with the necessary message and session plumbing to carry it. - API additions in normApi.h / normApi.cpp to enable and configure it. - An examples/normRatelessTest.cpp example demonstrating the feature. Notes - This is an initial, "basic" implementation intended as a starting point rather than a complete solution — feedback on the approach is very welcome. - I'd be happy to adjust naming, API shape, or integration points to better match how you'd like rateless/non-systematic codecs to be handled in NORM. Happy to iterate on anything here. Thanks for taking a look! ------------------------------ You can view, comment on, or merge this pull request online at: #102 Commit Summary - ae61d13 <ae61d13> basic rateless codec support File Changes (13 files <https://github.com/USNavalResearchLaboratory/norm/pull/102/files>) - *A* examples/normRatelessTest.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-6563b1e42eb2fce1b1a3b50c9cedbd02478628f0bbfefa1cdd2d8f5862c22697> (88) - *M* include/normApi.h <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-8eb79be75a5573f3dc4fcbc7c10b54eed0375fd8872cba1478388f22a21da5cd> (25) - *M* include/normEncoder.h <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-fb7ad839a6113c0b09f5c88d745ff10a37ef49a9ebdf4365027c56b698336595> (15) - *M* include/normMessage.h <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-9911dcfd8dfc3e1a02823efbd9ad1ff3c816d9f551885812e471b69c3b2d355f> (119) - *M* include/normSegment.h <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-056aed8ebabbb7114279285abe3f96e3e0778c1cacf2703dbb74350939b0e633> (6) - *M* include/normSession.h <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-8222cbf93cf5599c2d07e8dd0e2c325d24d62343ecd4cce512ba235f2ab946c7> (37) - *M* makefiles/Makefile.common <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-3d2ceb33e0b368b59c5c4810416b8306279e50eb91f899a733c669fc44847e4b> (10) - *M* src/common/normApi.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-680b29152839941d69b4be26dc22458a2e59c852acfd2ac99b49e0ed98dc982e> (30) - *M* src/common/normNode.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-96cb940e8c3c74bfc5464c5c9a8f33fb124c7110231158f434910331d40648d2> (133) - *M* src/common/normObject.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-3cd98c2cd78f3a9aea980bea194ac67364806223fc43c0db3485d34fea5a7806> (57) - *M* src/common/normSegment.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-aaacccbc9456e5ded80895c1d433e0acfcfe68fc19419f1f66a0893a5012fdd9> (30) - *M* src/common/normSession.cpp <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-a6282efb4f8010a67e0701fd87d5dc6a7756469158575df45866dd48570b482a> (61) - *M* wscript <https://github.com/USNavalResearchLaboratory/norm/pull/102/files#diff-b79856260b3cc9b3e958c83a55bae1e46e31d232125b925c581022786a7bc042> (2) Patch Links: - https://github.com/USNavalResearchLaboratory/norm/pull/102.patch - https://github.com/USNavalResearchLaboratory/norm/pull/102.diff — Reply to this email directly, view it on GitHub <#102?email_source=notifications&email_token=ABU46GP6WPR2U5KSBZSZBZD5ARM2HA5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF4ZTQOJUGUZTKMZQGWTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVRTG633UMVZF6Y3MNFRWW>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABU46GOWLORZLIRFYFWTEQL5ARM2HAVCNFSNUABFKJSXA33TNF2G64TZHMZDANZVGUZDMNBRHNEXG43VMU5TINRZGYYDMNRYGEYKC5QC> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/ABU46GKUN6YZM23G2DHGGRL5ARM2HA5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF4ZTQOJUGUZTKMZQGWTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVJTG633UMVZF62LPOM> and Android <https://github.com/notifications/mobile/android/ABU46GKMBUHFDVDUZFFYMND5ARM2HA5CNFSNUABEM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UF4ZTQOJUGUZTKMZQGWTHEZLBONXW5KTTOVRHGY3SNFRGKZFFMV3GK3TUVZTG633UMVZF6YLOMRZG62LE>. Download it today! You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

-- Brian Adamson ***@***.***>