int6kf.1.html 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  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. int6kf.1
  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='int6keth.1.html' title=' int6keth.1 '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='int6khost.1.html' title=' int6khost.1 '>NEXT</a>]
  19. </div>
  20. <pre>
  21. int6kf(1) Qualcomm Atheros Open Powerline Toolkit int6kf(1)
  22. NAME
  23. int6kf - INT6300 Flash Utility for Linux
  24. SYNOPSIS
  25. int6kf [options] -C file -N file -P file
  26. DESCRIPTION
  27. This program is deprecated. Use int6kboot when downloading firmware 3.3.4 or later on INT6300 devices or later.
  28. Download and start runtime firmware on a local Atheros powerline device that is in bootloader mode. A device stays in
  29. bootloader mode when it cannot load firmware from NVRAM. That can happen because there is no NVRAM or because the NVRAM
  30. is blank or corrupted. The bootloader only understands a subset of Atheros message types and cannot flash NVRAM. This
  31. program uses that subset to download runtime firmware and start execution. Optionally, it will proceed to flash NVRAM
  32. after the firmware has started.
  33. Booting a device is a two part operation. The first part downloads SDRAM configuration parameters then download runtime
  34. firmware and parameters into SDRAM and starts the firmware. The second part downloads runtime firmare and parameters
  35. (again) into scratch buffers and instructs the firmware to write them into to NVRAM. This program can perform the first
  36. part alone or the first then the second part but not the second part alone. The second part can be performed alone using
  37. program int6k.
  38. This program is part of the Atheros Powerline Toolkit. See the AMP man page for compilation and installation instruc‐
  39. tions.
  40. OPTIONS
  41. -a Wait until device sends a VS_HOST_ACTION.IND before downloading SDRAM configuration, firmware and PIB.
  42. -C filename
  43. Read the named SDRAM configuration file and write it to the device. This option and argument are required. Any
  44. file having an invalid SDRAM configuration file format will be rejected. No assumptions are made based on file‐
  45. name and no filename conventions are enforced.
  46. -e Redirects stderr messages to stdout. By convention status and error messages are printed on stderr while primary
  47. program output is printed on stdout. This option prints all output on stdout in cases where this is desired.
  48. -F[F] Write previously downloaded MAC and PIB to NVRAM using VS_MOD_NVM. Adding a second F here or another -F anywhere
  49. on the command line will force-flash a blank or corrupted NVRAM. Firmware loaded from NVRAM will treat force-
  50. flash as an error. This option can be used to create factory settings but cannot be used to change them once cre‐
  51. ated. Subsequent use creates and updates operational settings that can be erased using a factory reset. This
  52. option is executed after all others on the command line, except for the -R option.
  53. -i interface
  54. Select the host Ethernet interface. All requests are sent via this interface and only reponses received via this
  55. interface are recognized. The default interface is eth1 because most people use eth0 as their principle network
  56. connection; however, if environment string &quot;PLC&quot; is defined then it takes precedence over the default interface.
  57. This option then takes precedence over either default.
  58. -N filename
  59. Read the named NVM file and write it to the device. This option and argument are required. Any file having an
  60. invalid NVM file format will be rejected. No assumptions are made based on filename and no filename conventions
  61. are enforced.
  62. -P filename
  63. Read the named PIB file and write it to the device. This option and argument are required. Any file having an
  64. invalid PIB file format will be rejected. No assumptions are made based on filename and no filename conventions
  65. are enforced.
  66. -q Suppresses status messages on stderr.
  67. -t timer
  68. Read timeout or capture period in milliseconds. Values range from 0 through UINT_MAX. This value has different
  69. effects on Linux and Windows. On Linux, where native raw sockets are used, this is the maximum time allowed for a
  70. response and so larger values should not affect performance. On Windows, where WinPcap is used, this is the time
  71. allotted for packet capture and so larger values will certainly affect performance. The default is shown in
  72. brackets on the program menu.
  73. -v Prints additional information on stdout. In particular, this option dumps outgoing Ethernet packets on stdout.
  74. -?,--help
  75. Print program help summary on stdout. This option takes precedence over other options on the command line.
  76. -!,--version
  77. Print program version information on stdout. This option takes precedence over other options on the command line.
  78. Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of
  79. the Linux Toolkit you are using.
  80. ARGUMENTS
  81. None.
  82. REFERENCES
  83. See the Atheros HomePlug AV Firmware Technical Reference Manual for more information.
  84. EXAMPLES
  85. The -C, -N and -P options are always required. Their order is not important. Notice that no MAC address is needed
  86. because devices use address 00:B0:52:00:00:01, the program default address, when in bootloader mode.
  87. int6kf -C test.cfg -N test.nvm -P test.pib
  88. &gt; eth0 00:B0:52:00:00:01 Write SDRAM Configuration
  89. &gt; eth0 00:B0:52:00:00:01 Written.
  90. &gt; eth0 00:B0:52:00:00:01 Write to device memory
  91. &gt; eth0 00:B0:52:00:00:01 Written.
  92. &gt; eth0 00:B0:52:00:00:01 Write to device memory
  93. &gt; eth0 00:B0:52:00:00:01 Written.
  94. &gt; eth0 00:B0:52:00:00:01 Start Firmware
  95. &gt; eth0 00:B0:52:00:00:01 Started.
  96. Downloads SDRAM configuration file test.cfg with VS_SET_SDRAM then firmware from file test.nvm with VS_WR_MEM then PIB
  97. from file test.pib then starts firmware execution with VS_ST_MAC. This operation is common on flash-less systems.
  98. int6kf -C test.cfg -N test.nvm -P test.pib -F
  99. &gt; eth0 00:B0:52:00:00:01 Write SDRAM Configuration
  100. &gt; eth0 00:B0:52:00:00:01 Written.
  101. &gt; eth0 00:B0:52:00:00:01 Write to device memory
  102. &gt; eth0 00:B0:52:00:00:01 Written.
  103. &gt; eth0 00:B0:52:00:00:01 Write to device memory
  104. &gt; eth0 00:B0:52:00:00:01 Written.
  105. &gt; eth0 00:B0:52:00:00:01 Start Firmware
  106. &gt; eth0 00:B0:52:00:00:01 Started.
  107. &gt; eth0 00:B0:52:00:00:01 Write MAC as module
  108. &gt; eth0 00:B0:52:00:00:01 Written.
  109. &gt; eth0 00:B0:52:00:00:01 Write PIB as module
  110. &gt; eth0 00:B0:52:00:00:01 Written.
  111. &gt; eth0 00:B0:52:00:00:01 Flash Device
  112. &gt; eth0 00:B0:52:00:00:01 Flashed.
  113. Perform the same actions as before with some extra steps. After starting firmware execution, the same firmware and PIB
  114. are downloaded again, using VS_WR_MOD instead of VS_WR_MEM, and written to NVRAM using VS_MOD_NVM with force. The force
  115. option is only recognized by firmware that has been started by the bootloader and will fail when no flash memory is
  116. present.
  117. DISCLAIMER
  118. Atheros HomePlug AV Vendor Specific Management Message Entry structure and content is proprietary to Atheros Communica‐
  119. tions, Ocala FL USA. Consequently, public information may not be available. Atheros Communications reserves the right
  120. to modify message structure and content in future firmware releases without any obligation to notify or compensate users
  121. of this program.
  122. SEE ALSO
  123. AMP(1), int6k(1), int6kid(1), int6krate(1), int6kwait(1)
  124. CREDITS
  125. Charles Maier &lt;cmaier@qca.qualcomm.com&gt;
  126. open-plc-utils-0.0.3 Mar 2014 int6kf(1)
  127. </pre>
  128. <div class='footerlink'>
  129. [<a href='int6keth.1.html' title=' int6keth.1 '>PREV</a>]
  130. [<a href='toolkit.html' title=' Index '>HOME</a>]
  131. [<a href='int6khost.1.html' title=' int6khost.1 '>NEXT</a>]
  132. </div>
  133. </body>
  134. </html>