config2cfg.1
Author: cmaier@cmassoc.net

    config2cfg(1)                                Qualcomm Atheros Open Powerline Toolkit                               config2cfg(1)

    NAME
           config2cfg - Atheros Configuration File Converter

    SYNOPSIS
           config2cfg [options] file [file] [...]

    DESCRIPTION
           The  config2cfg program converts an SDRAM configuration file used by the Windows Device Manager to the configuration file
           format used by the Qualcomm Atheros Powerline Toolkit.

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

    OPTIONS
           There are no options.

    EXPLANATION
           The  Windows  Device Manager format consists of 64 ASCII hexadecomal characters.  Files usually have a .config extension.
           File size is at least 64 characters.  Excess characters are ignored in input.  This means  that  files  can  be  modified
           using  any text editor and there is no way to detect modification.  From a programmin standpoint, ASCII-to-binary conver‐
           tion and checksum computation is required on input and binary-to-ASCII conversion iw required on output.

           The Atheros Powerline Toolkit format consists of 32 binary bytes plus a 4 byte (32 bit) checksum.  Files usually  have  a
           .cfg extension.  File size is always 36 characters.  The files can be edited using any hex editor but a new checksum must
           be computed and inserted after any change.  No conversion or computation is required on input or output.  Input is  ready
           for direct insertion into a VS_SET_SDRAM message.

           Programs  int6k  and  int6kf  expect this latter format and so you can use this program determine if a given file has the
           proper format.

    OPTIONS
           file   The filename of a Windows Device Manager SDRAM configuration file.  The file is re-written such that the  filename
                  is  preserved  but  the contents are not.  Windows Device Manager SDRAM configuration files usually have a .config
                  extension but the program makes no assumption based on filename and does not enforce any filename conventions.

           -q     Suppresses printing of progress messages.  There are no progress messages in this version.

           -v     Print additional information.  There is no additional information printed in this version.

           -?, --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.

    EXAMPLES
           The following example reads file abc.cfg and validates it.  The message shown indicates that the  configuration  file  is
           the correct size and has a checksums and there are no read errors.

               > chkcfg abc.cfg
               chkcfg: abc.cfg looks good

           The  following  example  reads three files in succession and reports on each one.  You can suppress good news with the -q
           option.

               # chkcfg abc.cfg def.cfg ghi.cfg
               chkcfg: abc.cfg looks good
               chkcfg: def.cfg is corrupt
               chkcfg: ghi.cfg looks good

           The following example displays the SDRAM configuration values in all files having names that match the  wildcard  pattern
           sdram*.cfg.   We can confirm that the values inside are correct for their filenames.  Program output could have been sent
           to a file and saved for later reference.

               # chknvm -qv sdram*.cfg
               ------- sdram32.cfg -------
                       SIZE=0x02000000 (32mb)
                       CONF=0x00143188
                       TIM0=0x01E1D491
                       TIM1=0x000883D6
                       CNTRL=0x00003089
                       REF=0x00000366
                       CLOCK=0x00000001
               ------- sdram16.cfg -------
                       SIZE=0x01000000 (16mb)
                       CONF=0x00142F68
                       TIM0=0x0115124E
                       TIM1=0x000883D6
                       CNTRL=0x00003089
                       REF=0x00000493
                       CLOCK=0x00000001

    DISCLAIMER
           The SDRAM file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA.  Consequently, public  information
           is  not  available.   Qualcomm  Atheros  reserves  the  right  to change the file structure or content in future firmware
           releases without any obligation to notify or compensate users of this program.

    SEE ALSO
           int6k(1), int6kf(1), modpib(1), chknvm(1), chkpib(1)

    CREDITS
            Charles Maier <cmaier@qca.qualcomm.com>

    open-plc-utils-0.0.3                                        Mar 2014                                               config2cfg(1)

[PREV] [HOME] [NEXT]