StartFirmware2.c.html 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. <?xml version='1.0' encoding='iso-8859-1'?>
  2. <!doctype html public '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
  3. <html xmlns='http://www.w3c.org/1999/xhtml' lang='en-us'>
  4. <head>
  5. <title>
  6. StartFirmware2.c
  7. </title>
  8. <meta http-equiv='content-type' content='text/html;iso-8859-1'/>
  9. <meta name='generator' content='motley-tools 1.9.4 13:40:33 Feb 18 2015'/>
  10. <meta name='author' content='cmaier@cmassoc.net'/>
  11. <meta name='robots' content='noindex,nofollow'/>
  12. <link href='toolkit.css' rel='stylesheet' type='text/css'/>
  13. </head>
  14. <body>
  15. <div class='headerlink'>
  16. [<a href='StartFirmware1.c.html' title=' StartFirmware1.c '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='StartFirmware.c.html' title=' StartFirmware.c '>NEXT</a>]
  19. </div>
  20. <pre>
  21. /*====================================================================*
  22. *
  23. * Copyright (c) 2013 Qualcomm Atheros, Inc.
  24. *
  25. * All rights reserved.
  26. *
  27. * Redistribution and use in source and binary forms, with or
  28. * without modification, are permitted (subject to the limitations
  29. * in the disclaimer below) provided that the following conditions
  30. * are met:
  31. *
  32. * * Redistributions of source code must retain the above copyright
  33. * notice, this list of conditions and the following disclaimer.
  34. *
  35. * * Redistributions in binary form must reproduce the above
  36. * copyright notice, this list of conditions and the following
  37. * disclaimer in the documentation and/or other materials
  38. * provided with the distribution.
  39. *
  40. * * Neither the name of Qualcomm Atheros nor the names of
  41. * its contributors may be used to endorse or promote products
  42. * derived from this software without specific prior written
  43. * permission.
  44. *
  45. * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
  46. * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE
  47. * COPYRIGHT HOLDERS AND CONTRIBUTORS &quot;AS IS&quot; AND ANY EXPRESS OR
  48. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  49. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  50. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
  51. * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  52. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  53. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  54. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  55. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  56. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  57. * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  58. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  59. *
  60. *--------------------------------------------------------------------*/
  61. /*====================================================================*
  62. *
  63. * struct StartFirmware2 (struct plc * plc, unsigned module, const struct nvm_header2 * nvm_header)
  64. *
  65. * plc.h
  66. *
  67. * This plugin starts software execution using VS_ST_MAC; despite
  68. * an affirmative respond from the device, there is no guarantee
  69. * that the firmware will actually start or continue to run so we
  70. * wait for a response and report the result;
  71. *
  72. * struct nvm_header1 must be little-endian order and ready to send
  73. * to the device;
  74. *
  75. *
  76. * Contributor(s):
  77. * Charles Maier &lt;cmaier@qca.qualcomm.com&gt;
  78. *
  79. *--------------------------------------------------------------------*/
  80. #ifndef STARTSOFTWARE2_SOURCE
  81. #define STARTSOFTWARE2_SOURCE
  82. #include &lt;stdint.h&gt;
  83. #include &lt;memory.h&gt;
  84. #include &quot;../tools/error.h&quot;
  85. #include &quot;../plc/plc.h&quot;
  86. signed StartFirmware2 (struct plc * plc, unsigned module, const struct nvm_header2 * nvm_header)
  87. {
  88. struct channel * channel = (struct channel *)(plc-&gt;channel);
  89. struct message * message = (struct message *)(plc-&gt;message);
  90. #ifndef __GNUC__
  91. #pragma pack (push,1)
  92. #endif
  93. struct __packed vs_st_mac_request
  94. {
  95. struct ethernet_hdr ethernet;
  96. struct qualcomm_hdr qualcomm;
  97. uint8_t MODULEID;
  98. uint8_t RESERVED [3];
  99. uint32_t IMAGEBOOT;
  100. uint32_t IMAGELENGTH;
  101. uint32_t IMAGECHECKSUM;
  102. uint32_t IMAGESTART;
  103. }
  104. * request = (struct vs_st_mac_request *) (message);
  105. struct __packed vs_st_mac_confirm
  106. {
  107. struct ethernet_hdr ethernet;
  108. struct qualcomm_hdr qualcomm;
  109. uint8_t MSTATUS;
  110. uint8_t MODULEID;
  111. }
  112. * confirm = (struct vs_st_mac_confirm *) (message);
  113. #ifndef __GNUC__
  114. #pragma pack (pop)
  115. #endif
  116. memset (message, 0, sizeof (* message));
  117. Request (plc, &quot;Start %s (%d) (%08X)&quot;, plc-&gt;NVM.name, module, LE32TOH (nvm_header-&gt;EntryPoint));
  118. EthernetHeader (&amp;request-&gt;ethernet, channel-&gt;peer, channel-&gt;host, channel-&gt;type);
  119. QualcommHeader (&amp;request-&gt;qualcomm, 0, (VS_ST_MAC | MMTYPE_REQ));
  120. plc-&gt;packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN);
  121. request-&gt;IMAGEBOOT = nvm_header-&gt;ImageAddress;
  122. request-&gt;IMAGELENGTH = nvm_header-&gt;ImageLength;
  123. request-&gt;IMAGECHECKSUM = nvm_header-&gt;ImageChecksum;
  124. request-&gt;IMAGESTART = nvm_header-&gt;EntryPoint;
  125. request-&gt;MODULEID = VS_MODULE_MAC;
  126. if (SendMME (plc) &lt;= 0)
  127. {
  128. error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
  129. return (-1);
  130. }
  131. if (ReadMME (plc, 0, (VS_ST_MAC | MMTYPE_CNF)) &lt;= 0)
  132. {
  133. error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD);
  134. return (-1);
  135. }
  136. if (confirm-&gt;MSTATUS)
  137. {
  138. Failure (plc, PLC_WONTDOIT);
  139. return (-1);
  140. }
  141. return (0);
  142. }
  143. #endif
  144. </pre>
  145. <div class='footerlink'>
  146. [<a href='StartFirmware1.c.html' title=' StartFirmware1.c '>PREV</a>]
  147. [<a href='toolkit.html' title=' Index '>HOME</a>]
  148. [<a href='StartFirmware.c.html' title=' StartFirmware.c '>NEXT</a>]
  149. </div>
  150. </body>
  151. </html>