int6khost - INT6300 Host Emulator
int6khost [options] -C file -N
file -P file -n file -p
file
The INT6300 Host Emulator waits for VS_HST_ACTION.IND messages
from a local device and services them as described in the INT6300 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 -C, -N and -P name existing files
that store factory default memory configuration, 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 still different.
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.
- -C filename
- Use this file to download memory configuration when requested by the local
device. The file must exist and have a valid configuration 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.
- -e
- Redirects stderr messages to stdout. By convention status and error
messages are printed on stderr while primary program output is printed on
stdout. This option prints all output on stdout in cases where this is
desired.
- -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.
See the Qualcomm Atheros HomePlug AV Firmware Technical Reference
Manual for more information.
The following command starts the host emulator. The -C,
-N and -P options are always required. Their order is not
important.
int6khost -C test.cfg -N test.nvm -P test.pib
> eth0 00:B0:52:00:00:01 Waiting for Host Action Requests
>
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.
plc(1), int64host(1),
int6k(1), int6kboot(1)
plchost(1)