Actions at the Developer’s Site

The software developer creates an Update File for his customer and optionally a Modified Context File for himself. The creation of these files is done with the command line options of the WIBU-KEY program WKCRYPT.

9.3.4.1 Remote Programming with WkList

It is possible in WkList (WkMacList) to display remote context files and create remote update files in an easy way.

To start the programming select the ‘List’ Mode (default on startup) and select a RTC file via the menu ‘Edit->Remote Context File…’. The contents of

Chapter 9 Programming WIBU-BOX Hardware

this file is displayed in a virtual port (RMT), the file name is displayed as box address above the contents.

Programming of a remote box is similar to programming a local box. All changes are done in memory until you press the ‘Write RMT’ button to save the Remote Programming Update File. All changes are marked with red color.

In the sample below, you can see the contents of the RTC file ‘TestKitBox.rtc’ with a modified Limit counter entry (entry #2) and a new entry 10:272 (entry #6). For general information about Remote Programming please refer to section 9.3.

9.3.4.2 Command Line Syntax for Remote Programming with WKCRYPT

/RC:[RemoteProgrammingContextFile [.RTC]]

/RM[A]:[RemoteProgrammingModifiedContextFile [.RTM]] /RO[P/W]:[File format of RemoteProgramming Files] /RU[A]:[RemoteProgrammingUpdateFile [.RTU]]

Command line syntax for Remote Programming with WKCRYPT:

WKCRYPT [Option ...]:[ContextFile ...] [Option ...]:[UpdateFile ...] ... 9.3.4.3 Activating Remote Programming

For each call WKCRYPT is entered first. Then it is necessary to activate the

Remote Context reading. The reading of a Remote Programming Context File by WKCRYPT replaces the reading of one or more physically connected

WIBU-BOXes. The activation is done by the /RC option with the Remote

Programming Context File as argument. The default file extension is .rtc. To activate the reading of the Remote Programming Context File, for example demo.rtc, use one of the following command lines:

3

the Update File.

3

WKCRYPT /RC:demo.rtc /L 9.3.4.4 Creating an Update File

The creation of a Remote Programming Update File by WKCRYPT is

activated with the /RU option. This option has the Remote Programming

Update File as argument. The default extend for such a file is .rtu. To cause the creation of the example Update File demo.rtu use one of the following command lines:

3

WKCRYPT /RC:demo /RU:demo /F10 /U13 /PN

WKCRYPT /RC:demo.rtc /RU:demo.rtc /F10 /U13/ PN 9.3.4.5 Creating an Modified Context File

WKCRYPT permits the creation of a Modified Context File. This file contains the new contents of the WIBU-BOX after the reprogramming with the Update File. The Modified Context File is useful for saving the new state of a WIBU-BOX at the programmer’s site. It simplifies the creation of another

Remote Programming Update File in the future. To create aModified

Context File, use the option /RM. The default file extension of such a file is

.rtm. The contents of a Modified Context File are absolutely compatible to

theRemote Programming Context File with file extension .rtc. The two

different file extension are used to avoid that an input Context File is overwritten by a created Modified Context File. For the example file demo use one of the following command lines to create a Modified Context File:

3

WKCRYPT /RC:demo /RU:demo /RM:demo /F10 /U13 /PN WKCRYPT /RC:demo.rtc /RU:demo.rtu /RM:demo.rtm /F10 /U13 /PN

Chapter 9 Programming WIBU-BOX Hardware

9.3.4.6 File format of RemoteProgrammingFiles

/RO[P/W]

WKCRYPT generates and reads RemoteProgrammingFiles (.RTC, RemoteProgrammingContextFile; .RTM,

RemotePorgrammingModifiedContextFile, .RTU,

RemoteProgrammingUpdateFile) either in the Plain format (=Default value, programs up to version 2.53) or in the WBC format (version 3.0 or higher). The advantage is that WBC files have an additional file header and they can be allocated explicitly.

9.3.4.7 Additional Options and Tips

To add information to an existing Update File the option /RUA is used

which activates the append mode. A Remote Programming Update File can contain up to 16 programming commands. Please note that replacing an

existing entry by a new entry via the /PR option internally needs two

programming commands. The option /RMA can be used to add information

to an existing Modified Context File.

Changes to the WIBU-BOX contents via Remote Programming are done by any programming or listing operation of WKCRYPT. These are options like

/PN, /PC, /PR, /PX, /PI or /PM. The /PF option cannot be used together with Remote Programming. This is not really a limitation, because the user can

modify the WIBU-BOX configuration directly via the WKU application. The

option /PQ is used to read more than one WIBU-BOX from a Context File or

to create Update Files or Modified Context Files for multiple WIBU-BOXes. Please note that within one command line any new setting of the options

/RC, /RM, /RU or /PQ terminates a started programming sequence. This

termination creates the update and modified context file or executes the programming of the local WIBU-BOXes. The reading of the Remote

Programming Context File is then started again as well as the creation of the destination files.

WKCRYPT /RC:demo /RU:demo /F10 /U13 /PMC10

creates a Remote Programming Update Filedemo.rtu which changes

the bundled Limit Counter of the entry 10:13 to 10 in the WIBU-BOX

described by the Remote Programming Context Filedemo.rtc.

WKCRYPT /PAL1 /RM:save.rtm /F10 /U13 /PN /PXD3-5 stores a new entry 10:13 with an Added Data Entry 3-5 into the WIBU- BOX at LPT1 and saves the Remote Programming Context information of this WIBU-BOX in the file save.rtm.

Chapter 9 Programming WIBU-BOX Hardware