Select Language US Language
German Language
breadcrumb.home / Documentation / Command Line Tools

Command Line Tools

SmrxProg - Command Line based CRYPTO-BOX® Formatting

SmrxProg is a command line utility for CRYPTO-BOX formatting (programming) through command line switches. Duplicating CB Format functionality (GUI-based component of CRYPTO-BOX formatting in Smarx Application Framework, see chapter 3.4), SmrxProg can be efficiently used for customer specific scenarios of CRYPTO‑BOX programming.
SmrxProg supports AutoCrypt project files (.xml files) generated either with AutoCrypt Wizard or AutoCrypt SxAF.
 

SmrxProg supports

  1. (Re)programming CRYPTO-BOX® Label.
  2. Creating partitions in CRYPTO-BOX memory (supports partition numbers from 101 to 65535, maximum number of partitions per CRYPTO-BOX is 32).
  3. Programming Data Objects and network licenses to particular partitions.
  4. Executing extended partitions operations, like update, delete etc. (see "Extended script format" section in the SmrxProg readme.txt for details).
  5. (Re)programming of CRYPTO-BOX encryption keys (Private/Session AES Key/IV).
  6. (Re)programming User Password (UPW) (see "Extended script format" section in the readme.txt for details).
     

SmrxProg.exe can be found here:

  • If you use the PPK, open the Control Center and go to the menu point “Drivers & Tools” → “Command Line Tools”, or open the folder [SmarxOS PPK root]\Tools\ SmrxProg;
     
  • If you use the AutoCrypt Wizard Package, see [AutoCrypt Package root folder]\Tools\ SmrxProg.


Parameter description:
AC_Tool.exe <TRX-Datei> <XML-Datei> 

<TRX-Datei> TRX file that you receive with your customer specific CRYPTO-BOX hardware (cbu_demo.trx for demo CRYPTO-BOX shipped with the Evaluation Kit).
<XML-Datei> XML file with application protection settings and CRYPTO-BOX configuration also used by SmrxProg for further CRYPTO-BOX programming (see AC_Test.xml as example).
Also a prototype XML file can created with SxAF for the active project  (menu “Project” → ”Generate Script for SmrxTools”). Even if not using SxAF for protection and license management this option can still be useful for automatic creation of the prototype XML script.
Another option is to use Partition Editor (PE) utility for extended XML (script) file generation.

 

 

 

 

 

 

 

 


Short explanation on how to use SmrxProg:

  • Take an XML file that was exported from AutoCrypt Wizard or from SxAF. You can also use a text editor to customize the XML file (AC_Test.xml may be used as prototypes).
     
  • Place the TRX file distributed by MARX, the XML file obtained on the previous step, and SmrxProg.exe into the same directory.
     
  • Run the following command from the console:
    SmrxProg.exe <TRX file> <XML file>
     
  • Results will be displayed on the console, and directed to the SMRXPROG.LOG file.
     

INFO

If you receive an error message, you will find a list of the error codes and their meaning in the attached readme file. The Readme file also contains further information on the structure of the XML file.