Provided by: plc-utils-extra_0.0.6+git20230504.1ba7d5a0-1_amd64 bug

NAME

       int64host - INT6400 Host Emulator

SYNOPSIS

       int64host [options] -N file -P file -n file -p file

DESCRIPTION

       The  INT6400  Host  Emulator  waits for VS_HST_ACTION.IND messages from a local device and
       services them as described in the INT6400 Technical Reference Manual.  It can be  used  to
       demonstrate or verify proper device/host interaction for flash-less devices.  This program
       is not production grade and will stop dead - like a bug! - when things go wrong.  Use  the
       Qualcomm Atheros Embedded API for real-time, production-grade applications.

       Host  emulation applies to flash-less device designs where a local host processor provides
       the persistent storage.  The local host can provide a wide range  of  intelligent  storage
       functions for a device but this program offers one.  Options -N and -P name existing files
       that store the factory default runtime firmware and parameters, respectively.  Options  -n
       and  -p  name  scratch  files  that will store user firmware and parameters, respectively.
       This is similiar to the standard Atheros NVRAM scheme but is not the same.

       To use the program, connect a flash-less device to the host via ethernet then  start  this
       program  with  the  correct  filenames.   The program will automatically respond to device
       requests to download memory configuration, firmware and/or parameters and upload  firmware
       or  and/or  parameters  under device control.  See the Qualcomm Atheros Firmware Technical
       Reference Manual for more information.

       This program is part of the Qualcomm Atheros Powerline Toolkit.  See the plc man page  for
       an overview and installation instructions.

OPTIONS

       -F[F]  Flash  NVRAM  once  downloaded firmware has started.  The same firmware and PIB are
              downloaded, again, using VS_WR_MOD and written to NVRAM using VS_MOD_NVM.  Adding a
              second  F  here  or  another  -F anywhere on the command line will perform a forced
              flash.  When no NVRAM is present, normal and force flash cause the device to upload
              to  the  host.   When  blank  or corrupted NVRAM is present, forced flash writes to
              NVRAM.  This operation will fail when no NVRAM is present.

       -i interface
              Select the host Ethernet interface.  All requests are sent via this host  interface
              and  only  reponses  received  via this host interface are recognized.  The default
              interface is  eth1  because  most  people  use  eth0  as  their  principle  network
              connection;  however,  if  environment  string  "PLC"  is  defined  then  it  takes
              precedence over the default interface.  This  option  then  takes  precedence  over
              either default.

       -N filename
              Use  this  file  to download firmware when requested by the local device.  The file
              must exist and have a valid NVM file format or it will be rejected.  No assumptions
              are  made  based on filename and no filename conventions are enforced.  The program
              will not over-write this file.  This option and argument are required.

       -n filename
              Use this file to store firmware uploaded from the local device.  The file need  not
              exist  but  an error will occur if it cannot be created or written.  If firmware is
              uploaded to this file, it is used for  subsequent  firmware  downloads  unless  the
              device  requests a factory reset.  In that case, the file specified by option -N is
              used.  This option and argument are optional.  If omitted then the default filename
              host.pib will be used.

       -P filename
              Use  this file to download parameters when requested by the local device.  The file
              must exist and have a valid PIB file format or it will be rejected.  No assumptions
              are  made  based on filename and no filename conventions are enforced.  The program
              will not over-write this file.  This option and argument are required.

       -p filename
              Use this file to store parameters uploaded from the local device.   The  file  need
              not  exist  but  an  error  will  occur  if  it cannot be created or written.  Once
              parameters are uploaded to this file, it is used for subsequent parameter downloads
              unless  the  device  requests a factory reset.  In that case, the file specified by
              option -P is used.  This option and argument are optional.   If  omitted  then  the
              default filename host.nvm will be used.

       -q     Suppress status messages on stderr.

       -t milliseconds
              Read  timeout  in milliseconds.  Values range from 0 through UINT_MAX.  This is the
              maximum time allowed for a response.  The default  is  shown  in  brackets  on  the
              program menu.

       -v     Print  additional  information  on  stdout.   In particular, this option will print
              incoming and outgoing Ethernet frames on stdout.

       -?, --help
              Print program help summary on stdout.  This  option  takes  precedence  over  other
              options on the command line.

       -!, --version
              Print  program  version  information  on stdout.  This option takes precedence over
              other options on the command line.  Use this option when sending  screen  dumps  to
              Atheros  Technical  Support  so  that  they know exactly which version of the Linux
              Toolkit you are using.

ARGUMENTS

       None.

REFERENCES

       See the Qualcomm  Atheros  HomePlug  AV  Firmware  Technical  Reference  Manual  for  more
       information.

EXAMPLES

       The  following  command  starts  the  host  emulator.   The  -N  and -P options are always
       required.  Their order is not important.

          # int64host -N test.nvm -P test.pib -n temp.nvm -p temp.pib
          eth1 00:B0:52:00:00:01 Waiting for Host Action Requests

          eth1 00:B0:52:00:00:01 Waiting for Host Action
          eth1 00:B0:52:00:00:01 Host Action Request is (4) configure memory.
          eth1 00:B0:52:00:00:01 Write Memory (00000040:15752)
          eth1 00:B0:52:00:00:01 Wrote mac-release-X.nvm
          eth1 00:B0:52:00:00:01 Started BootLoader

          eth1 00:B0:52:00:00:01 Host Action Request is (0) initialize device.
          eth1 00:B0:52:00:00:01 Write Memory (00000040:15752)
          eth1 00:B0:52:00:00:01 Wrote mac-release-X.nvm
          eth1 00:B0:52:00:00:01 Started BootLoader
          eth1 00:B0:52:00:00:01 Write Memory (00204000:1013952)
          eth1 00:B0:52:00:00:01 Wrote mac-release-X.nvm
          eth1 00:B0:52:00:00:01 Write Memory (01F00000:11400)
          eth1 00:B0:52:00:00:01 Wrote AR7400-WallAdapter-HomePlugAV_NorthAmerica.pib
          eth1 00:B0:52:00:00:03 Started INT7400-MAC-0-0-1008-00-63-20100227-AUTO-D

DISCLAIMER

       Atheros HomePlug AV Vendor Specific Management Message  Entry  structure  and  content  is
       proprietary  to  Qualcomm Atheros, Ocala FL USA.  Consequently, public information may not
       be available.  Qualcomm Atheros reserves the right to modify message structure and content
       in  future  firmware releases without any obligation to notify or compensate users of this
       program.

SEE ALSO

       plc(1), int64host(1), int6k(1), int6kboot(1) plchost(1)

CREDITS

        Charles Maier