self__programming_8h.html

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

<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 WriteFlashByte           </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 writes byte data to Flash address flashAddr. Returns FALSE if input address is not valid Flash byte address for writing, else TRUE. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00082">82</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#l00043">__FLASH_RECOVER</a>, <a class="el" href="Self__programming_8c-source.html#l00207">AddressCheck()</a>, <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_8c-source.html#l00247">LpmReplaceSpm()</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>.<div class="fragment"><pre class="fragment"><a name="l00082"></a>00082                                                                          {
<a name="l00083"></a>00083   <a class="code" href="Self__programming_8h.html#b6f1b2644de7b0bfdbda193929167b4a">MyAddressType</a>  pageAdr;
<a name="l00084"></a>00084   <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> eepromInterruptSettings;
<a name="l00085"></a>00085   <span class="keywordflow">if</span>( <a class="code" href="Self__programming_8c.html#968efe3412fbf2252905db9c760c6aff">AddressCheck</a>( flashAddr &amp; ~(PAGESIZE-1) )){
<a name="l00086"></a>00086 
<a name="l00087"></a>00087     eepromInterruptSettings= EECR &amp; (1&lt;&lt;EERIE); <span class="comment">// Stores EEPROM interrupt mask</span>
<a name="l00088"></a>00088     EECR &amp;= ~(1&lt;&lt;EERIE);                    <span class="comment">// Disable EEPROM interrupt</span>
<a name="l00089"></a>00089     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));                <span class="comment">// Wait if ongoing EEPROM write</span>
<a name="l00090"></a>00090 
<a name="l00091"></a>00091     pageAdr=flashAddr &amp; ~(PAGESIZE-1);      <span class="comment">// Gets Flash page address from byte address</span>
<a name="l00092"></a>00092 
<a name="l00093"></a>00093     #ifdef <a class="code" href="Self__programming_8h.html#d0d1a75143c5082aa629ae78c02cb71f">__FLASH_RECOVER</a>
<a name="l00094"></a>00094     <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status=0;                   <span class="comment">// Inicate that Flash buffer does</span>
<a name="l00095"></a>00095                                             <span class="comment">// not contain data for writing</span>
<a name="l00096"></a>00096     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00097"></a>00097     <a class="code" href="Self__programming_8c.html#6c0d2f39df7714f493c214ed2ec42493">LpmReplaceSpm</a>(flashAddr, data);         <span class="comment">// Fills Flash write buffer</span>
<a name="l00098"></a>00098     <a class="code" href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39">WriteBufToFlash</a>(<a class="code" href="Self__programming_8h.html#7344bf2129730480f9e46fb7f2cb1ceb">ADR_FLASH_BUFFER</a>);      <span class="comment">// Writes to Flash recovery buffer</span>
<a name="l00099"></a>00099     <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.pageNumber = (<span class="keywordtype">unsigned</span> int) (pageAdr/PAGESIZE); <span class="comment">// Stores page address</span>
<a name="l00100"></a>00100                                                        <span class="comment">// data should be written to</span>
<a name="l00101"></a>00101     <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">// Indicates that Flash recovery buffer</span>
<a name="l00102"></a>00102                                                <span class="comment">// contains unwritten data</span>
<a name="l00103"></a>00103     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00104"></a>00104 <span class="preprocessor">    #endif</span>
<a name="l00105"></a>00105 <span class="preprocessor"></span>
<a name="l00106"></a>00106     <a class="code" href="Self__programming_8c.html#6c0d2f39df7714f493c214ed2ec42493">LpmReplaceSpm</a>(flashAddr, data);         <span class="comment">// Fills Flash write buffer</span>
<a name="l00107"></a>00107     <a class="code" href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39">WriteBufToFlash</a>(pageAdr);               <span class="comment">// Writes to Flash</span>
<a name="l00108"></a>00108 
<a name="l00109"></a>00109 <span class="preprocessor">    #ifdef __FLASH_RECOVER</span>
<a name="l00110"></a>00110 <span class="preprocessor"></span>    <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status = 0;                 <span class="comment">// Indicates that Flash recovery buffer</span>
<a name="l00111"></a>00111                                             <span class="comment">// does not contain unwritten data</span>
<a name="l00112"></a>00112     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00113"></a>00113 <span class="preprocessor">    #endif</span>
<a name="l00114"></a>00114 <span class="preprocessor"></span>
<a name="l00115"></a>00115     EECR |= eepromInterruptSettings;        <span class="comment">// Restore EEPROM interrupt mask</span>
<a name="l00116"></a>00116     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Return TRUE if address</span>
<a name="l00117"></a>00117                                             <span class="comment">// valid for writing</span>
<a name="l00118"></a>00118   }
<a name="l00119"></a>00119   <span class="keywordflow">else</span>
<a name="l00120"></a>00120     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;                           <span class="comment">// Return FALSE if address not</span>
<a name="l00121"></a>00121                                             <span class="comment">// valid for writing</span>
<a name="l00122"></a>00122 }
</pre></div>
<p>

<p>
Here is the call graph for this function:<p><center><img src="Self__programming_8h_37868fe819d4b22e28890f3c0d3797fa_cgraph.png" border="0" usemap="#Self__programming_8h_37868fe819d4b22e28890f3c0d3797fa_cgraph_map" alt=""></center>
<map name="Self__programming_8h_37868fe819d4b22e28890f3c0d3797fa_cgraph_map">
<area href="Self__programming_8c.html#968efe3412fbf2252905db9c760c6aff" shape="rect" coords="177,7,287,33" alt="">
<area href="Self__programming_8c.html#6c0d2f39df7714f493c214ed2ec42493" shape="rect" coords="169,57,295,84" alt="">
<area href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39" shape="rect" coords="172,108,292,135" alt="">
</map>
    </td>
  </tr>
</table>
<a class="anchor" name="fc13c9dcc9565c691d73a8e35ea3c3b0"></a><!-- doxytag: member="Self_programming.h::WriteFlashPage" ref="fc13c9dcc9565c691d73a8e35ea3c3b0" 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 WriteFlashPage           </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 writes data from array dataPage[] to Flash page address flashStartAdr. The Number of bytes written is depending upon the Flash page size. Returns FALSE if input argument ucFlashStartAdr is not a valid Flash page address for writing, else TRUE. 
<p>
Definition at line <a class="el" href="Self__programming_8c-source.html#l00130">130</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#l00207">AddressCheck()</a>, <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>.<div class="fragment"><pre class="fragment"><a name="l00131"></a>00131 {
<a name="l00132"></a>00132   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> index;
<a name="l00133"></a>00133   <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> eepromInterruptSettings;
<a name="l00134"></a>00134   <span class="keywordflow">if</span>( <a class="code" href="Self__programming_8c.html#968efe3412fbf2252905db9c760c6aff">AddressCheck</a>(flashStartAdr) ){
<a name="l00135"></a>00135     eepromInterruptSettings = EECR &amp; (1&lt;&lt;EERIE); <span class="comment">// Stoes EEPROM interrupt mask</span>
<a name="l00136"></a>00136     EECR &amp;= ~(1&lt;&lt;EERIE);                    <span class="comment">// Disable EEPROM interrupt</span>
<a name="l00137"></a>00137     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));                <span class="comment">// Wait if ongoing EEPROM write</span>
<a name="l00138"></a>00138 
<a name="l00139"></a>00139 <span class="preprocessor">    #ifdef __FLASH_RECOVER</span>
<a name="l00140"></a>00140 <span class="preprocessor"></span>    <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status=0;                   <span class="comment">// Inicate that Flash buffer does</span>
<a name="l00141"></a>00141                                             <span class="comment">// not contain data for writing</span>
<a name="l00142"></a>00142     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00143"></a>00143     <span class="keywordflow">for</span>(index = 0; index &lt; PAGESIZE; index+=2){ <span class="comment">// Fills Flash write buffer</span>
<a name="l00144"></a>00144       _SPM_FILLTEMP(index, (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>)dataPage[index]+((<span class="keywordtype">unsigned</span> int)dataPage[index+1] &lt;&lt; 8));
<a name="l00145"></a>00145     }
<a name="l00146"></a>00146     <a class="code" href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39">WriteBufToFlash</a>(<a class="code" href="Self__programming_8h.html#7344bf2129730480f9e46fb7f2cb1ceb">ADR_FLASH_BUFFER</a>);      <span class="comment">// Writes to Flash recovery buffer</span>
<a name="l00147"></a>00147     <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.pageNumber=(<span class="keywordtype">unsigned</span> int)(flashStartAdr/PAGESIZE);
<a name="l00148"></a>00148     <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">// Indicates that Flash recovery buffer</span>
<a name="l00149"></a>00149                                            <span class="comment">// contains unwritten data</span>
<a name="l00150"></a>00150     <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00151"></a>00151 <span class="preprocessor">    #endif</span>
<a name="l00152"></a>00152 <span class="preprocessor"></span>    <span class="keywordflow">for</span>(index = 0; index &lt; PAGESIZE; index+=2){ <span class="comment">// Fills Flash write buffer</span>
<a name="l00153"></a>00153       _SPM_FILLTEMP(index, (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>)dataPage[index]+((<span class="keywordtype">unsigned</span> int)dataPage[index+1] &lt;&lt; 8));
<a name="l00154"></a>00154     }
<a name="l00155"></a>00155     <a class="code" href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39">WriteBufToFlash</a>(flashStartAdr);         <span class="comment">// Writes to Flash</span>
<a name="l00156"></a>00156 <span class="preprocessor">    #ifdef __FLASH_RECOVER</span>
<a name="l00157"></a>00157 <span class="preprocessor"></span>      <a class="code" href="Self__programming_8c.html#e43874319c89f039d4c684ca71e3cc89">FlashBackup</a>.status=0;                 <span class="comment">// Inicate that Flash buffer does</span>
<a name="l00158"></a>00158                                             <span class="comment">// not contain data for writing</span>
<a name="l00159"></a>00159       <span class="keywordflow">while</span>(EECR &amp; (1&lt;&lt;EEWE));
<a name="l00160"></a>00160 <span class="preprocessor">    #endif</span>
<a name="l00161"></a>00161 <span class="preprocessor"></span>
<a name="l00162"></a>00162     EECR |= eepromInterruptSettings;        <span class="comment">// Restore EEPROM interrupt mask</span>
<a name="l00163"></a>00163     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#c0d83f0b82a6b30de8811e69e6d95c61">TRUE</a>;                            <span class="comment">// Return TRUE if address</span>
<a name="l00164"></a>00164                                             <span class="comment">// valid for writing</span>
<a name="l00165"></a>00165   }
<a name="l00166"></a>00166   <span class="keywordflow">else</span>
<a name="l00167"></a>00167     <span class="keywordflow">return</span> <a class="code" href="Self__programming_8h.html#946003f97ccc52d5d3b54ac0ec31bbfc">FALSE</a>;                           <span class="comment">// Return FALSE if not address not</span>
<a name="l00168"></a>00168                                             <span class="comment">// valid for writing</span>
<a name="l00169"></a>00169 }
</pre></div>
<p>

<p>
Here is the call graph for this function:<p><center><img src="Self__programming_8h_fc13c9dcc9565c691d73a8e35ea3c3b0_cgraph.png" border="0" usemap="#Self__programming_8h_fc13c9dcc9565c691d73a8e35ea3c3b0_cgraph_map" alt=""></center>
<map name="Self__programming_8h_fc13c9dcc9565c691d73a8e35ea3c3b0_cgraph_map">
<area href="Self__programming_8c.html#968efe3412fbf2252905db9c760c6aff" shape="rect" coords="179,7,288,34" alt="">
<area href="Self__programming_8c.html#d29e91755e1d3695b74c15e89019db39" shape="rect" coords="173,58,293,84" alt="">
</map>
    </td>
  </tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Wed Jan 18 16:19:25 2006 for AVR106 - C Functions for Reading and Writing to Flash Memory by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.5 </small></address>
</body>
</html>