This memory area can be used for storing any data required for application protection, including: hardware algorithm descriptors, license tables, key words, data sets, constants, code blocks, etc.
You can create fields of various types, edit their contents and delete them.
Important information
All models of available modern Guardant dongles contain several default hardware algo-rithm descriptors and protected items.
From within an application data stored in the area of free purpose fields is accessed using the Guardant API functions.
Types and main properties of free purpose fields:
| Field type | Size, bytes | Contents | Hardware locks | Working with field from within the application (Guardant API) | |
|---|---|---|---|---|---|
| Algorithm | Field size is defined by the size of algorithm descriptor | Hardware algorithm descriptor | Mandatory read/write locks |
| |
| Protected item | Arbitrary size into the modern dongles; 1 – 255 + service fields into the old models | Protected item descriptor | Mandatory read/write locks | GrdPI_Activate, GrdPI_Deactivate, GrdPI_Read, GrdPI_Update | |
| License table | Guardant Sign Net/ Time Net/ Net III | 1 or 2 per ele-ment+ service fields (not more than 254 bytes) |
| Mandatory read/write locks | GrdPI_Activate, GrdPI_Deactivate, GrdPI_Read, GrdPI_Update |
| Guardant Net II / Net | 1 or 2 per element 127 modules maximum | Information on the software modules number and license limit of each module | Mandatory write locks | GrdRead | |
| Integer | 1, 2, 4, 8 | Integer or unsigned integer | Write locks (when necessary) | GrdRead, GrdWrite | |
| String | Random size | Character sequence in ANSI or Unicode encoding | Write locks (when necessary) | GrdRead, GrdWrite | |
| Counter | 1, 2, 4, 8 | Unsigned integer. Increments automatically on each operation of writing a mask into the dongle memory | Write locks (when necessary) | GrdRead, GrdWrite | |
| Dump | Random size | Binary dump | Write locks (when necessary) | GrdRead, GrdWrite | |
New field is added into mask before the field selected from the list.
To create a new field select a Free memory field from the list (or any other created field from the area of free purpose ones) and select Edit | Add new field.
Add new field dialog box will appear. Select a field type and specify its name and size.
Add new field dialog box:
Add new field dialog box control elements:
| Interface element | Description of purpose |
|---|---|
| Name | Specifies any valid name for the field being created |
| Size in bytes | Selects possible / sets arbitrary field size. Size depends on the selected field type. |
| Field type | Selects field type out of list of possible types |
The dialog box interface may slightly differ depending on the mask type and field being created.
After filling in the current dialog box you need to click [Next] to move the field properties dialog box.
More detailed information on creating and working with fields of various types is given in respective chapters.
To delete a field and its contents, select a field from the mask and execute command Edit | Delete field. A dialog box will appear to confirm the deletion:
Important information
Any changes in the mask – creation, deletion or editing of field contents – will be written to the dongle memory only after executing command Dongle | Write into the Dongle.
In order to view and edit a field’s dump and also to save it as a file, choose the required field in a mask, pull up the context menu by right-mouse clicking it and select Show full field dump item:
