self__programming_8c.html

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

<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="1d6ded0de0674f00a82507424c862431"></a><!-- doxytag: member="Self_programming.c::ReadFlashByte" ref="1d6ded0de0674f00a82507424c862431" args="(MyAddressType flashStartAdr)" --><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>

<p>
The function Returns one byte located on Flash address given by ucFlashStartAdr. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00053">53</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#l00065">ReadFlashPage()</a>.<div class="fragment"><pre class="fragment"><a name="l00053"></a>00053                                                         {
<a name="l00054"></a>00054 <span class="preprocessor">#pragma diag_suppress=Pe1053 // Suppress warning for conversion from long-type address to flash ptr.</span>
<a name="l00055"></a>00055 <span class="preprocessor"></span>  <span class="keywordflow">return</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">char</span>)*((<a class="code" href="Self__programming_8h.html#2fcb8b22c8cdb1abe50824d192e43170">MyFlashCharPointer</a>)flashStartAdr);
<a name="l00056"></a>00056 <span class="preprocessor">#pragma diag_default=Pe1053 // Back to default.</span>
<a name="l00057"></a>00057 <span class="preprocessor"></span>} <span class="comment">// Returns data from Flash</span>
</pre></div>
<p>
    </td>
  </tr>
</table>
<a class="anchor" name="8b290614a2b685c107c6eed5a9db96d4"></a><!-- doxytag: member="Self_programming.c::ReadFlashPage" ref="8b290614a2b685c107c6eed5a9db96d4" args="(MyAddressType flashStartAdr, unsigned char *dataPage)" --><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 ReadFlashPage           </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>flashStartAdr</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>dataPage</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 one Flash page from address flashStartAdr and stores data in array dataPage[]. The number of bytes stored is depending upon the Flash page size. The function returns FALSE if input address is not a Flash page address, else TRUE. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00065">65</a> of file <a class="el" href="Self__programming_8c-source.html">Self_programming.c</a>.
<p>
References <a class="el" href="Self__programming_8c-source.html#l00053">ReadFlashByte()</a>, and <a class="el" href="Self__programming_8h-source.html#l00133">TRUE</a>.<div class="fragment"><pre class="fragment"><a name="l00065"></a>00065                                                                                  {
<a name="l00066"></a>00066   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> index;
<a name="l00067"></a>00067   <span class="keywordflow">if</span>(!(flashStartAdr &amp; (PAGESIZE-1))){      <span class="comment">// If input address is a page address</span>
<a name="l00068"></a>00068     <span class="keywordflow">for</span>(index = 0; index &lt; PAGESIZE; index++){
<a name="l00069"></a>00069       dataPage[index] = <a class="code" href="Self__programming_8c.html#1d6ded0de0674f00a82507424c862431">ReadFlashByte</a>(flashStartAdr + index);
<a name="l00070"></a>00070     }
<a name="l00071"></a>00071     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Return TRUE if valid page address</span>
<a name="l00072"></a>00072   }
<a name="l00073"></a>00073   <span class="keywordflow">else</span>{
<a name="l00074"></a>00074     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;                           <span class="comment">// Return FALSE if not valid page address</span>
<a name="l00075"></a>00075   }
<a name="l00076"></a>00076 }
</pre></div>
<p>

<p>
Here is the call graph for this function:<p><center><img src="Self__programming_8c_8b290614a2b685c107c6eed5a9db96d4_cgraph.png" border="0" usemap="#Self__programming_8c_8b290614a2b685c107c6eed5a9db96d4_cgraph_map" alt=""></center>
<map name="Self__programming_8c_8b290614a2b685c107c6eed5a9db96d4_cgraph_map">
<area href="Self__programming_8c.html#1d6ded0de0674f00a82507424c862431" shape="rect" coords="173,7,285,33" alt="">
</map>
    </td>
  </tr>
</table>
<a class="anchor" name="dab3fc05882b5f5511a24d423119e003"></a><!-- doxytag: member="Self_programming.c::RecoverFlash" ref="dab3fc05882b5f5511a24d423119e003" 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">unsigned char RecoverFlash           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </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 global variable <a class="el" href="Self__programming_8c.html#9acb44549b41563697bb490144ec6258">FlashBackup.status</a> indicates that Flash recovery buffer contains data that needs to be written to Flash. Writes data from Flash recovery buffer to Flash page address given by FLASH_recovery.pageAdr. This function should be called at program startup if FLASH recovery option is enabeled. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00178">178</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#l00132">FLASH_BUFFER_FULL_ID</a>, <a class="el" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>, <a class="el" href="Self__programming_8h-source.html#l00133">TRUE</a>, and <a class="el" href="Self__programming_8c-source.html#l00228">WriteBufToFlash()</a>.
<p>
Referenced by <a class="el" href="Self__programming__main_8c-source.html#l00032">main()</a>.<div class="fragment"><pre class="fragment"><a name="l00178"></a>00178                             {
<a name="l00179"></a>00179 <span class="preprocessor">#ifdef __FLASH_RECOVER</span>
<a name="l00180"></a>00180 <span class="preprocessor"></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> index;
<a name="l00181"></a>00181   <span class="keywordflow">if</span>(<a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status == <a class="code" href="Self__programming_8h.html#d1d89ef93c516c3d36de362a540a082e">FLASH_BUFFER_FULL_ID</a>){ <span class="comment">// Checks if Flash recovery</span>
<a name="l00182"></a>00182                                                   <span class="comment">//  buffer contains data</span>
<a name="l00183"></a>00183     <span class="keywordflow">for</span>(index=0; index &lt; PAGESIZE; index+=2){     <span class="comment">// Writes to Flash write buffer</span>
<a name="l00184"></a>00184         _SPM_FILLTEMP( index, *((<a class="code" href="Self__programming_8h.html#ccc9c42b0a998824046b26acfb726a7c">MyFlashIntPointer</a>)(<a class="code" href="Self__programming_8h.html#7344bf2129730480f9e46fb7f2cb1ceb">ADR_FLASH_BUFFER</a>+index)) );