self__programming_8h.html

AVR106 读写Flash程序空间的C函数

        <tr>
          <td class="md" nowrap valign="top">typedef unsigned char __flash* <a class="el" href="Self__programming_8h.html#2fcb8b22c8cdb1abe50824d192e43170">MyFlashCharPointer</a>          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>

<p>
Definition at line <a class="el" href="Self__programming_8h-source.html#l00105">105</a> of file <a class="el" href="Self__programming_8h-source.html">Self_programming.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="ccc9c42b0a998824046b26acfb726a7c"></a><!-- doxytag: member="Self_programming.h::MyFlashIntPointer" ref="ccc9c42b0a998824046b26acfb726a7c" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">typedef unsigned int __flash* <a class="el" href="Self__programming_8h.html#ccc9c42b0a998824046b26acfb726a7c">MyFlashIntPointer</a>          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>

<p>
Definition at line <a class="el" href="Self__programming_8h-source.html#l00106">106</a> of file <a class="el" href="Self__programming_8h-source.html">Self_programming.h</a>.    </td>
  </tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="968efe3412fbf2252905db9c760c6aff"></a><!-- doxytag: member="Self_programming.h::AddressCheck" ref="968efe3412fbf2252905db9c760c6aff" args="(MyAddressType flashAdr)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">unsigned char AddressCheck           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>flashAdr</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
The function checks if input argument is a valid Flash page address for writing. Returns TRUE only if:<ul>
<li>Address points to the beginning of a Flash page</li><li>Address is within the limits defined in <a class="el" href="Self__programming_8h.html">Self_programming.h</a></li><li>Address is not equal to page address used for buffring by the Flash recovery functions (if enabled). Returns FALSE else. </li></ul>

<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00207">207</a> of file <a class="el" href="Self__programming_8c-source.html">Self_programming.c</a>.
<p>
References <a class="el" href="Self__programming_8h-source.html#l00045">ADR_FLASH_BUFFER</a>, <a class="el" href="Self__programming_8h-source.html#l00050">ADR_LIMIT_HIGH</a>, <a class="el" href="Self__programming_8h-source.html#l00047">ADR_LIMIT_LOW</a>, <a class="el" href="Self__programming_8h-source.html#l00134">FALSE</a>, and <a class="el" href="Self__programming_8h-source.html#l00133">TRUE</a>.
<p>
Referenced by <a class="el" href="Self__programming_8c-source.html#l00082">WriteFlashByte()</a>, and <a class="el" href="Self__programming_8c-source.html#l00130">WriteFlashPage()</a>.<div class="fragment"><pre class="fragment"><a name="l00207"></a>00207                                                   {
<a name="l00208"></a>00208 <span class="preprocessor">  #ifdef __FLASH_RECOVER</span>
<a name="l00209"></a>00209 <span class="preprocessor"></span>  <span class="comment">// The next line gives a warning 'pointless comparison with zero' if ADR_LIMIT_LOW is 0. Ignore it.</span>
<a name="l00210"></a>00210   <span class="keywordflow">if</span>( (flashAdr &gt;= <a class="code" href="Self__programming_8h.html#53e0ab773e1383596056656041ceb630">ADR_LIMIT_LOW</a>) &amp;&amp; (flashAdr &lt;= <a class="code" href="Self__programming_8h.html#356b068aabf148d88bb44104bd07f6de">ADR_LIMIT_HIGH</a>) &amp;&amp;
<a name="l00211"></a>00211       (flashAdr != <a class="code" href="Self__programming_8h.html#7344bf2129730480f9e46fb7f2cb1ceb">ADR_FLASH_BUFFER</a>) &amp;&amp; !(flashAdr &amp; (PAGESIZE-1)) )
<a name="l00212"></a>00212     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Address is a valid page address</span>
<a name="l00213"></a>00213   <span class="keywordflow">else</span>
<a name="l00214"></a>00214     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;                           <span class="comment">// Address is not a valid page address</span>
<a name="l00215"></a>00215   #<span class="keywordflow">else</span>
<a name="l00216"></a>00216   <span class="keywordflow">if</span>((flashAdr &gt;= <a class="code" href="Self__programming_8h.html#53e0ab773e1383596056656041ceb630">ADR_LIMIT_LOW</a>) &amp;&amp; (flashAdr &lt;= <a class="code" href="Self__programming_8h.html#356b068aabf148d88bb44104bd07f6de">ADR_LIMIT_HIGH</a>) &amp;&amp; !(flashAdr &amp; (PAGESIZE-1) ) )
<a name="l00217"></a>00217     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Address is a valid page address</span>
<a name="l00218"></a>00218   <span class="keywordflow">else</span>
<a name="l00219"></a>00219     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;                           <span class="comment">// Address is not a valid page address</span>
<a name="l00220"></a>00220 <span class="preprocessor">  #endif</span>
<a name="l00221"></a>00221 <span class="preprocessor"></span>}
</pre></div>
<p>
    </td>
  </tr>
</table>
<a class="anchor" name="6c0d2f39df7714f493c214ed2ec42493"></a><!-- doxytag: member="Self_programming.h::LpmReplaceSpm" ref="6c0d2f39df7714f493c214ed2ec42493" args="(MyAddressType flashAddr, unsigned char data)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void LpmReplaceSpm           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>flashAddr</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>unsigned char&nbsp;</td>
          <td class="mdname" nowrap> <em>data</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
The function reads Flash page given by flashAddr, replaces one byte given by flashAddr with data, and stores entire page in Flash temporary buffer. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00247">247</a> of file <a class="el" href="Self__programming_8c-source.html">Self_programming.c</a>.
<p>
Referenced by <a class="el" href="Self__programming_8c-source.html#l00082">WriteFlashByte()</a>.<div class="fragment"><pre class="fragment"><a name="l00247"></a>00247                                                                {
<a name="l00248"></a>00248 <span class="preprocessor">#pragma diag_suppress=Pe1053 // Suppress warning for conversion from long-type address to flash ptr.</span>
<a name="l00249"></a>00249 <span class="preprocessor"></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> index, oddByte, pcWord;
<a name="l00250"></a>00250   <a class="code" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>  pageAdr;
<a name="l00251"></a>00251   oddByte=(<span class="keywordtype">unsigned</span> char)flashAddr &amp; 1;
<a name="l00252"></a>00252   pcWord=(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>)flashAddr &amp; (PAGESIZE-2); <span class="comment">// Used when writing FLASH temp buffer</span>
<a name="l00253"></a>00253   pageAdr=flashAddr &amp; ~(PAGESIZE-1);        <span class="comment">// Get FLASH page address from byte address</span>
<a name="l00254"></a>00254   <span class="keywordflow">for</span>(index=0; index &lt; PAGESIZE; index+=2){
<a name="l00255"></a>00255     <span class="keywordflow">if</span>(index==pcWord){
<a name="l00256"></a>00256       <span class="keywordflow">if</span>(oddByte){
<a name="l00257"></a>00257         _SPM_FILLTEMP( index, (*(<a class="code" href="Self__programming_8h.html#2fcb8b22c8cdb1abe50824d192e43170">MyFlashCharPointer</a>)(flashAddr &amp; ~1) | ((<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>)data&lt;&lt;8)) );
<a name="l00258"></a>00258       }                                     <span class="comment">// Write odd byte in temporary buffer</span>
<a name="l00259"></a>00259       <span class="keywordflow">else</span>{
<a name="l00260"></a>00260         _SPM_FILLTEMP( index, ( (*( (<a class="code" href="Self__programming_8h.html#2fcb8b22c8cdb1abe50824d192e43170">MyFlashCharPointer</a>)flashAddr+1)&lt;&lt;8)  | data ) );
<a name="l00261"></a>00261       }                                     <span class="comment">// Write even byte in temporary buffer</span>
<a name="l00262"></a>00262     }
<a name="l00263"></a>00263     <span class="keywordflow">else</span>{
<a name="l00264"></a>00264       _SPM_FILLTEMP(index, *( (<a class="code" href="Self__programming_8h.html#ccc9c42b0a998824046b26acfb726a7c">MyFlashIntPointer</a>)(pageAdr+index) ) );
<a name="l00265"></a>00265     }                                       <span class="comment">// Write Flash word directly to temporary buffer</span>
<a name="l00266"></a>00266   }
<a name="l00267"></a>00267 <span class="preprocessor">#pragma diag_default=Pe1053 // Back to default.</span>
<a name="l00268"></a>00268 <span class="preprocessor"></span>}
</pre></div>
<p>
    </td>
  </tr>
</table>
<a class="anchor" name="d115e127ecf9b9b686dc55a1e1e39e2c"></a><!-- doxytag: member="Self_programming.h::ReadFlashByte" ref="d115e127ecf9b9b686dc55a1e1e39e2c" args="(MyAddressType flashAdr)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">unsigned char ReadFlashByte           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>flashStartAdr</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>