self__programming_8h.html

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

<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.h::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_8h_8b290614a2b685c107c6eed5a9db96d4_cgraph.png" border="0" usemap="#Self__programming_8h_8b290614a2b685c107c6eed5a9db96d4_cgraph_map" alt=""></center>
<map name="Self__programming_8h_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.h::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)) );
<a name="l00185"></a>00185     }
<a name="l00186"></a>00186     <a class="code" href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39">WriteBufToFlash</a>((<a class="code" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>)<a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.pageNumber * PAGESIZE);
<a name="l00187"></a>00187     <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status=0;                   <span class="comment">// Inicate that Flash buffer does</span>
<a name="l00188"></a>00188                                             <span class="comment">// not contain data for writing</span>
<a name="l00189"></a>00189     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00190"></a>00190     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Returns TRUE if recovery has</span>
<a name="l00191"></a>00191                                             <span class="comment">// taken place</span>
<a name="l00192"></a>00192   }
<a name="l00193"></a>00193 <span class="preprocessor">#endif</span>
<a name="l00194"></a>00194 <span class="preprocessor"></span>  <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;
<a name="l00195"></a>00195 }
</pre></div>
<p>

<p>
Here is the call graph for this function:<p><center><img src="Self__programming_8h_dab3fc05882b5f5511a24d423119e003_cgraph.png" border="0" usemap="#Self__programming_8h_dab3fc05882b5f5511a24d423119e003_cgraph_map" alt=""></center>
<map name="Self__programming_8h_dab3fc05882b5f5511a24d423119e003_cgraph_map">
<area href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39" shape="rect" coords="163,7,283,33" alt="">
</map>
    </td>
  </tr>
</table>
<a class="anchor" name="d29e91755e1d3695b74c15e89019db39"></a><!-- doxytag: member="Self_programming.h::WriteBufToFlash" ref="d29e91755e1d3695b74c15e89019db39" 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">void WriteBufToFlash           </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 writes Flash temporary buffer to Flash page address given by input argument. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00228">228</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#l00125">SPMControllRegister</a>.
<p>
Referenced by <a class="el" href="Self__programming_8c-source.html#l00178">RecoverFlash()</a>, <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="l00228"></a>00228                                                  {
<a name="l00229"></a>00229 <span class="preprocessor">#pragma diag_suppress=Pe1053 // Suppress warning for conversion from long-type address to flash ptr.</span>
<a name="l00230"></a>00230 <span class="preprocessor"></span><span class="preprocessor">  #ifdef __HAS_RAMPZ__</span>
<a name="l00231"></a>00231 <span class="preprocessor"></span>  RAMPZ = (<span class="keywordtype">unsigned</span> char)(flashStartAdr &gt;&gt; 16);
<a name="l00232"></a>00232 <span class="preprocessor">  #endif</span>
<a name="l00233"></a>00233 <span class="preprocessor"></span>  _SPM_ERASE(flashStartAdr);
<a name="l00234"></a>00234   <span class="keywordflow">while</span>( <a class="code" href="Self__programming_8h.html#b6249f3eaad49b380d1e0a387a3fdb31">SPMControllRegister</a> &amp; (1&lt;&lt;SPMEN) ); <span class="comment">// Wait until Flash write completed</span>
<a name="l00235"></a>00235   _SPM_PAGEWRITE(flashStartAdr);
<a name="l00236"></a>00236   <span class="keywordflow">while</span>( <a class="code" href="Self__programming_8h.html#b6249f3eaad49b380d1e0a387a3fdb31">SPMControllRegister</a> &amp; (1&lt;&lt;SPMEN) ); <span class="comment">// Wait until Flash write completed</span>
<a name="l00237"></a>00237 <span class="preprocessor">  #ifdef RWWSRE</span>
<a name="l00238"></a>00238 <span class="preprocessor"></span>  __DataToR0ByteToSPMCR_SPM( 0, (<span class="keywordtype">unsigned</span> <span class="keywordtype">char</span>)(1&lt;&lt;RWWSRE)|(1&lt;&lt;SPMEN)); <span class="comment">// Enable RWW</span>
<a name="l00239"></a>00239 <span class="preprocessor">  #endif</span>
<a name="l00240"></a>00240 <span class="preprocessor"></span><span class="preprocessor">#pragma diag_default=Pe1053 // Back to default.</span>
<a name="l00241"></a>00241 <span class="preprocessor"></span>}
</pre></div>
<p>
    </td>
  </tr>
</table>
<a class="anchor" name="37868fe819d4b22e28890f3c0d3797fa"></a><!-- doxytag: member="Self_programming.h::WriteFlashByte" ref="37868fe819d4b22e28890f3c0d3797fa" args="(MyAddressType flashAddr, unsigned char data)" --><p>