WriteExecuteFirmware2.c 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. /*====================================================================*
  2. *
  3. * Copyright (c) 2013 Qualcomm Atheros, Inc.
  4. *
  5. * All rights reserved.
  6. *
  7. * Redistribution and use in source and binary forms, with or
  8. * without modification, are permitted (subject to the limitations
  9. * in the disclaimer below) provided that the following conditions
  10. * are met:
  11. *
  12. * * Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * * Redistributions in binary form must reproduce the above
  16. * copyright notice, this list of conditions and the following
  17. * disclaimer in the documentation and/or other materials
  18. * provided with the distribution.
  19. *
  20. * * Neither the name of Qualcomm Atheros nor the names of
  21. * its contributors may be used to endorse or promote products
  22. * derived from this software without specific prior written
  23. * permission.
  24. *
  25. * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
  26. * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE
  27. * COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
  28. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  29. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  30. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
  31. * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  32. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  33. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  34. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  35. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  36. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  37. * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  38. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  39. *
  40. *--------------------------------------------------------------------*/
  41. /*====================================================================*
  42. *
  43. * signed WriteExecuteFirmware2 (struct plc * plc, unsigned module, const struct nvm_header2 * nvm_header);
  44. *
  45. * plc.h
  46. *
  47. * use VS_WRITE_AND_EXECUTE_APPLET write a firmware image into SDRAM and
  48. * start execution when the image is stored in the new image file
  49. * format;
  50. *
  51. * the boot loader must be running for this to work since runtime
  52. * firmware ignores VS_WRITE_AND_EXECUTE_APPLET messages;
  53. *
  54. *
  55. * Contributor(s):
  56. * Charles Maier
  57. *
  58. *--------------------------------------------------------------------*/
  59. #ifndef WRITEEXECUTEFIRMWARE2_SOURCE
  60. #define WRITEEXECUTEFIRMWARE2_SOURCE
  61. #include "../tools/files.h"
  62. #include "../tools/error.h"
  63. #include "../plc/plc.h"
  64. signed WriteExecuteFirmware2 (struct plc * plc, unsigned module, const struct nvm_header2 * nvm_header)
  65. {
  66. struct channel * channel = (struct channel *)(plc->channel);
  67. struct message * message = (struct message *)(plc->message);
  68. #ifndef __GNUC__
  69. #pragma pack (push,1)
  70. #endif
  71. struct __packed vs_write_execute_request
  72. {
  73. struct ethernet_hdr ethernet;
  74. struct qualcomm_hdr qualcomm;
  75. uint32_t CLIENT_SESSION_ID;
  76. uint32_t SERVER_SESSION_ID;
  77. uint32_t FLAGS;
  78. uint8_t ALLOWED_MEM_TYPES [8];
  79. uint32_t TOTAL_LENGTH;
  80. uint32_t CURR_PART_LENGTH;
  81. uint32_t CURR_PART_OFFSET;
  82. uint32_t START_ADDR;
  83. uint32_t CHECKSUM;
  84. uint8_t RESERVED2 [8];
  85. uint8_t IMAGE [PLC_MODULE_SIZE];
  86. }
  87. * request = (struct vs_write_execute_request *) (message);
  88. struct __packed vs_write_execute_confirm
  89. {
  90. struct ethernet_hdr ethernet;
  91. struct qualcomm_hdr qualcomm;
  92. uint32_t MSTATUS;
  93. uint32_t CLIENT_SESSION_ID;
  94. uint32_t SERVER_SESSION_ID;
  95. uint32_t FLAGS;
  96. uint8_t ALLOWED_MEM_TYPES [8];
  97. uint32_t TOTAL_LENGTH;
  98. uint32_t CURR_PART_LENGTH;
  99. uint32_t CURR_PART_OFFSET;
  100. uint32_t START_ADDR;
  101. uint32_t CHECKSUM;
  102. uint8_t RESERVED2 [8];
  103. uint32_t CURR_PART_ABSOLUTE_ADDR;
  104. uint32_t ABSOLUTE_START_ADDR;
  105. }
  106. * confirm = (struct vs_write_execute_confirm *) (message);
  107. #ifndef __GNUC__
  108. #pragma pack (pop)
  109. #endif
  110. unsigned action = PLC_MODULE_ABSOLUTE;
  111. uint32_t length = PLC_MODULE_SIZE;
  112. uint32_t offset = LE32TOH (nvm_header->ImageAddress);
  113. uint32_t extent = LE32TOH (nvm_header->ImageLength);
  114. Request (plc, "Write %s (%d) (%08X:%d)", plc->NVM.name, module, offset, extent);
  115. while (extent)
  116. {
  117. memset (message, 0, sizeof (* message));
  118. EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type);
  119. QualcommHeader (&request->qualcomm, 0, (VS_WRITE_AND_EXECUTE_APPLET | MMTYPE_REQ));
  120. if (length > extent)
  121. {
  122. if (!(LE32TOH(nvm_header->EntryPoint) % sizeof(nvm_header->EntryPoint)))
  123. {
  124. Request (plc, "Start %s (%d) (%08X)", plc->NVM.name, module, LE32TOH (nvm_header->EntryPoint));
  125. action |= PLC_MODULE_EXECUTE;
  126. }
  127. length = extent;
  128. }
  129. if (read (plc->NVM.file, request->IMAGE, length) != (signed)(length))
  130. {
  131. error (1, errno, FILE_CANTREAD, plc->NVM.name);
  132. }
  133. request->CLIENT_SESSION_ID = HTOLE32 (plc->cookie);
  134. request->SERVER_SESSION_ID = HTOLE32 (0);
  135. request->FLAGS = HTOLE32 (action);
  136. request->ALLOWED_MEM_TYPES [0] = 1;
  137. request->TOTAL_LENGTH = nvm_header->ImageLength;
  138. request->CURR_PART_LENGTH = HTOLE32 (length);
  139. request->CURR_PART_OFFSET = HTOLE32 (offset);
  140. request->START_ADDR = nvm_header->EntryPoint;
  141. request->CHECKSUM = nvm_header->ImageChecksum;
  142. plc->packetsize = sizeof (* request);
  143. if (SendMME (plc) <= 0)
  144. {
  145. error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
  146. return (-1);
  147. }
  148. do {
  149. if (ReadMME (plc, 0, (VS_WRITE_AND_EXECUTE_APPLET | MMTYPE_CNF)) <= 0)
  150. {
  151. error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD);
  152. return (-1);
  153. }
  154. } while (confirm->CLIENT_SESSION_ID != HTOLE32 (plc->cookie));
  155. if (confirm->MSTATUS)
  156. {
  157. Failure (plc, PLC_WONTDOIT);
  158. return (-1);
  159. }
  160. if (LE32TOH (confirm->CURR_PART_LENGTH) != length)
  161. {
  162. error (PLC_EXIT (plc), 0, PLC_ERR_LENGTH);
  163. return (-1);
  164. }
  165. if (LE32TOH (confirm->CURR_PART_OFFSET) != offset)
  166. {
  167. error (PLC_EXIT (plc), 0, PLC_ERR_OFFSET);
  168. return (-1);
  169. }
  170. offset += length;
  171. extent -= length;
  172. }
  173. return (0);
  174. }
  175. #endif