Deploying to doxygen from @ c14f3a0 🚀

Author: pschatzmann

_abstract_meta_data_8h_source.html

@@ -89,10 +89,10 @@
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span> </div>
 <div class="line"><a id="l00008" name="l00008"></a><span class="lineno"><a class="line" href="group__metadata.html#ga27477aa4d162c65da12c7ffd964f5779">    8</a></span><span class="keyword">enum</span> <a class="code hl_enumeration" href="group__metadata.html#ga27477aa4d162c65da12c7ffd964f5779">ID3TypeSelection</a> { SELECT_ID3V1=0b001, SELECT_ID3V2=0b010, SELECT_ID3=0b011, SELECT_ICY=0b100, SELECT_ANY=0b111 };</div>
 <div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span> </div>
-<div class="line"><a id="l00011" name="l00011"></a><span class="lineno"><a class="line" href="group__metadata.html#ga6760f423085f8a63374b1e2db102a6d1">   11</a></span><span class="keyword">enum</span> <a class="code hl_enumeration" href="group__metadata.html#ga6760f423085f8a63374b1e2db102a6d1">MetaDataType</a> { Title, Artist, Album, Genre, Name, Description };</div>
+<div class="line"><a id="l00011" name="l00011"></a><span class="lineno"><a class="line" href="group__metadata.html#ga6760f423085f8a63374b1e2db102a6d1">   11</a></span><span class="keyword">enum</span> <a class="code hl_enumeration" href="group__metadata.html#ga6760f423085f8a63374b1e2db102a6d1">MetaDataType</a> { Title, Artist, Album, Genre, Name, Description, Corrupted };</div>
 <div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span> </div>
-<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment">// Description for meta info </span></div>
-<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* MetaDataTypeStr[] = {<span class="stringliteral">&quot;Title&quot;</span>, <span class="stringliteral">&quot;Artist&quot;</span>, <span class="stringliteral">&quot;Album&quot;</span>, <span class="stringliteral">&quot;Genre&quot;</span>,<span class="stringliteral">&quot;Name&quot;</span>, <span class="stringliteral">&quot;Description&quot;</span>};</div>
+<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment">// Description for meta info</span></div>
+<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* MetaDataTypeStr[] = {<span class="stringliteral">&quot;Title&quot;</span>, <span class="stringliteral">&quot;Artist&quot;</span>, <span class="stringliteral">&quot;Album&quot;</span>, <span class="stringliteral">&quot;Genre&quot;</span>,<span class="stringliteral">&quot;Name&quot;</span>, <span class="stringliteral">&quot;Description&quot;</span>, <span class="stringliteral">&quot;Corrupted&quot;</span>};</div>
 <div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span> </div>
 <div class="foldopen" id="foldopen00017" data-start="{" data-end="}">
 <div class="line"><a id="l00017" name="l00017"></a><span class="lineno"><a class="line" href="group__metadata.html#ga55cd7bcc38a921b447d479220d59d5ca">   17</a></span><span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code hl_function" href="group__metadata.html#ga55cd7bcc38a921b447d479220d59d5ca">toStr</a>(<a class="code hl_enumeration" href="group__metadata.html#ga6760f423085f8a63374b1e2db102a6d1">MetaDataType</a> t){</div>

_http_line_reader_8h_source.html

@@ -149,15 +149,75 @@
 <div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span>    }</div>
 <div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span>    str[result - 1] = 0;</div>
 <div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span>    <span class="keywordflow">if</span> (is_buffer_overflow) {</div>
-<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span>      LOGE(<span class="stringliteral">&quot;Line cut off: %s&quot;</span>, str);</div>
-<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span>    }</div>
-<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span> </div>
-<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span>    <span class="keywordflow">return</span> result;</div>
-<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span>  }</div>
-<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span>};</div>
+<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span>      <span class="comment">// SAFETY FIX: Don&#39;t print potentially corrupted binary data with %s</span></div>
+<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span>      <span class="comment">// Binary garbage can contain terminal escape codes or invalid UTF-8 that crashes Serial.printf()</span></div>
+<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span>      <span class="comment">//</span></div>
+<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span>      <span class="comment">// This fix prevents ESP32 hard resets when HTTP servers send malformed headers</span></div>
+<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span>      <span class="comment">// Real-world trigger: http://fast.citrus3.com:2020/stream/wtmj-radio</span></div>
+<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span>      <span class="comment">//</span></div>
+<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span>      <span class="comment">// Strategy:</span></div>
+<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span>      <span class="comment">// 1. Sanitize the actual buffer (prevents parser poisoning downstream)</span></div>
+<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span>      <span class="comment">// 2. Count printable vs binary content</span></div>
+<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span>      <span class="comment">// 3. Use hex dump for binary garbage (safer than string masking)</span></div>
+<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span>      <span class="comment">// 4. Limit output to 256 bytes (prevents log spam)</span></div>
+<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span> </div>
+<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span>      <span class="keywordtype">int</span> printable = 0;</div>
+<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span>      <span class="keywordtype">int</span> non_printable = 0;</div>
+<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span>      <span class="keywordtype">int</span> actual_len = 0;</div>
+<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span> </div>
+<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span>      <span class="comment">// First pass: count and find actual length</span></div>
+<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span>      <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i &lt; len &amp;&amp; str[i] != 0; i++) {</div>
+<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span>        actual_len = i + 1;</div>
+<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span>        <span class="keywordflow">if</span> (str[i] &gt;= 32 &amp;&amp; str[i] &lt;= 126) {</div>
+<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span>          printable++;</div>
+<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span>        } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (str[i] != <span class="charliteral">&#39;\r&#39;</span> &amp;&amp; str[i] != <span class="charliteral">&#39;\n&#39;</span> &amp;&amp; str[i] != <span class="charliteral">&#39;\t&#39;</span>) {</div>
+<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span>          non_printable++;</div>
+<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span>          <span class="comment">// CRITICAL: Sanitize the actual buffer to prevent parser poisoning</span></div>
+<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span>          <span class="comment">// Replace binary garbage with space to avoid confusing HTTP header parser</span></div>
+<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span>          str[i] = <span class="charliteral">&#39; &#39;</span>;</div>
+<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span>        }</div>
+<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span>      }</div>
+<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span> </div>
+<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span>      <span class="comment">// Limit logging output to 256 bytes to prevent excessive serial spam</span></div>
+<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span>      <span class="keywordtype">int</span> log_len = (actual_len &gt; 256) ? 256 : actual_len;</div>
+<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span> </div>
+<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span>      <span class="comment">// If mostly binary garbage (&gt;50% non-printable), use hex dump for safety</span></div>
+<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span>      <span class="keywordflow">if</span> (non_printable &gt; printable) {</div>
+<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span>        LOGE(<span class="stringliteral">&quot;Line cut off: [%d bytes, %d binary chars - showing hex dump of first %d bytes]&quot;</span>,</div>
+<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span>             actual_len, non_printable, (log_len &gt; 32 ? 32 : log_len));</div>
+<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span> </div>
+<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span>        <span class="comment">// Hex dump (safer than string output - never misinterpreted)</span></div>
+<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span>        <span class="comment">// Show first 32 bytes maximum</span></div>
+<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span>        <span class="keywordtype">int</span> hex_len = (log_len &gt; 32) ? 32 : log_len;</div>
+<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span>        <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i &lt; hex_len; i += 16) {</div>
+<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span>          <span class="keywordtype">char</span> hex_line[64];</div>
+<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span>          <span class="keywordtype">int</span> line_len = (hex_len - i &gt; 16) ? 16 : (hex_len - i);</div>
+<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span>          <span class="keywordtype">int</span> pos = 0;</div>
+<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span>          <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j = 0; j &lt; line_len; j++) {</div>
+<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span>            pos += snprintf(hex_line + pos, <span class="keyword">sizeof</span>(hex_line) - pos, <span class="stringliteral">&quot;%02X &quot;</span>, (uint8_t)str[i + j]);</div>
+<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span>          }</div>
+<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span>          LOGE(<span class="stringliteral">&quot;  %04X: %s&quot;</span>, i, hex_line);</div>
+<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span>        }</div>
+<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span>      } <span class="keywordflow">else</span> {</div>
+<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span>        <span class="comment">// Mostly printable - safe to log as string (already sanitized in-place above)</span></div>
+<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span>        <span class="comment">// Truncate to 256 bytes for logging</span></div>
+<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span>        <span class="keywordflow">if</span> (log_len &lt; actual_len) {</div>
+<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span>          <span class="keywordtype">char</span> saved = str[log_len];</div>
+<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span>          str[log_len] = 0;</div>
+<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span>          LOGE(<span class="stringliteral">&quot;Line cut off: %s... [%d more bytes]&quot;</span>, str, actual_len - log_len);</div>
+<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span>          str[log_len] = saved;</div>
+<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span>        } <span class="keywordflow">else</span> {</div>
+<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span>          LOGE(<span class="stringliteral">&quot;Line cut off: %s&quot;</span>, str);</div>
+<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span>        }</div>
+<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span>      }</div>
+<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span>    }</div>
+<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span> </div>
+<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span>    <span class="keywordflow">return</span> result;</div>
+<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span>  }</div>
+<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span>};</div>
 </div>
-<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span> </div>
-<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span>}  <span class="comment">// namespace audio_tools</span></div>
+<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span> </div>
+<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span>}  <span class="comment">// namespace audio_tools</span></div>
 <div class="ttc" id="aclassaudio__tools_1_1_http_line_reader_html"><div class="ttname"><a href="classaudio__tools_1_1_http_line_reader.html">audio_tools::HttpLineReader</a></div><div class="ttdoc">We read a single line. A terminating 0 is added to the string to make it compliant for c string funct...</div><div class="ttdef"><b>Definition</b> HttpLineReader.h:14</div></div>
 <div class="ttc" id="aclassaudio__tools_1_1_stream_html"><div class="ttname"><a href="classaudio__tools_1_1_stream.html">audio_tools::Stream</a></div><div class="ttdef"><b>Definition</b> NoArduino.h:142</div></div>
 <div class="ttc" id="anamespaceaudio__tools_html"><div class="ttname"><a href="namespaceaudio__tools.html">audio_tools</a></div><div class="ttdoc">Generic Implementation of sound input and output for desktop environments using portaudio.</div><div class="ttdef"><b>Definition</b> AudioCodecsBase.h:10</div></div>