- Created by Timofey Matrenitskiy, last modified on Jun 12, 2014
The following update options become available upon the programming during remote or local dump-based dongle memory update:
| Update type | Description |
|---|---|
| Entire dongle memory update | Rewrite the contents of dongle memory with the current mask data |
| Partial dongle memory update | Rewrite the contents of dongle memory fields not write-protected with a hardware lock. Only one field can be updated during a session |
| Activation /deactivation operations | Activation, deactivation or rewrite of selected area of a protected item, algorithm or license table |
| Changing the 'date of death' of a hardware algorithm (for RTC dongles only) | Prolong application's operating time operating (for RTC dongles only) |
During the entire update the whole dongle memory gets rewritten with the data of the selected mask.
The entire update is done when no saving of any work-in-progress is required as well as when this method of update is the only possible – during updates based on a file or mask template.
Execute Dongle | Update Dongle command to completely update the dongle memory. The Update Wizard window will appear on the screen.
The list of Update Wizard pages during the entire update of dongle memory:
| No. | Page | Developer’s actions |
|---|---|---|
| 1 | Memory update | Select remote or local update. For remote update enter the end-user update query into the respective field |
| 2 | Update type | Select item Entire dongle memory update |
| 3 | Result | Monitor the results of the Update Wizard performance |
The Partial dongle memory update option serves for updating the memory areas not write-protected by hardware locks. Whereas you will be able to update only one memory area of modern Guardant dongles using the remote update. In all other cases this restriction is not applicable.
The partial dongle memory update is useful in situations when you need to store the work-in-progress in the dongle (counter fields, algorithm counters) and when the entire memory update option is unacceptable.
The partial memory update can only be possible while updating based on the dump stored in the database.
Execute Dongle | Dongle Update command in order to update the dongle memory area not write-protected with a hardware lock. The Update Wizard dialog will appear on the screen.
The list of Update Wizard pages during the partial update of dongle memory:
| No. | Page | Developer’s actions |
|---|---|---|
| 1 | Memory update | Select remote or local update. For remote update enter the end-user update query into the respective field |
| 2 | Update type | Select Partial dongle memory update item |
| 3 | Partial dongle memory update | Specify the data type, address and size of memory area the contents of which is to be updated (see the screenshot and description below the table) |
| 4 | Partial dongle memory update | Enter the update data. The screenshot and interface description of the page match the dialog of editing the properties of respective fields (see Dumps, Integers, Strings and Counters section) |
| 5 | Result | Check the results of the Update Wizard |
Partial dongle memory update page
Specify a data type, address and size of memory area the contents of which is to be updated on the Partial dongle memory update page:
PICTURE
Important information
The memory fields to be updated need to be previously created in the Mask Editor.
Partial dongle memory update page control elements:
| Interface element | Description |
|---|---|
| Memory dump / Number switch | Select the type of update data: dump or number |
| Address field | Specify the address starting from which the update data will be written. This address should not be write-protected with a hardware lock |
| Size field/list | Specify the size of update data in bytes. Possible values: random – for the dump; 1, 2, 4 – for the field |
There is a special mode for protected item status control and contents update of modern Guardant dongles.
It benefits from the ability for controlling the status of a protected item (activate/deactivate) and changing its contents (read/update) without affecting the rest of the dongle memory.
The protected item contents and status change mode is available only while updating based on the dongle dump stored in the database.
Important information
- You can update only those protected items for which at least one of the services (activation, deactivation or data updating) was enabled before writing the dump into the dongle.
- Only previously enabled item services will be available for update.
- Just one operation (activation, deactivation or data recording) can be performed in one remote update session.
Execute Dongle | Dongle Update command to update a dongle memory area not write-protected with a hardware lock. The Update Wizard will appear on the screen.
The list of Update Wizard’s pages in Activation/Deactivation Operations mode:
| No. | Page | Developer’s actions |
|---|---|---|
| 1 | Memory update | Select remote or local update. For remote update enter the end-user update query into the respective field |
| 2 | Update type | Select Activation/Deactivation Operations item |
| 3 | Activation and data update | Select the protected item, hardware algorithm or license table and assign necessary operations for it (see screenshot and description after the table) |
| 4 | Result | Monitor the results of the Update Wizard performance |
Activation and Data Update page
Select a protected item, hardware algorithm or license table and set necessary operations for it on Activation and Data Update page:
| Possible operations | Description |
|---|---|
| Activation | Operation is performed with an item in an inactive status. For successful execution, the item must have Activation service previously enabled |
| Deactivation | Operation is performed with an item in an active status. For successful execution, the item must have Deactivation service previously enabled |
| Protected item data update | Operation is performed with an item in an active status. For successful execution, the item must have Data Update service previously enabled. During the execution of the operation the selected memory area gets rewritten by means of:
|
Activation and Data Update page:
PICTURE
Activation and Data Update dialog control elements:
| Interface element | Description of purpose | |
|---|---|---|
| Available Fields window | List of protected items available for update operations. To set operations for a field, select it from the list | |
| List of Field Operations | None | Don’t use activation/deactivation operations |
| Activation | Activate a protected item | |
| Deactivation | Deactivate a protected item | |
| Update checkbox | Mark the checkbox to enable the item update operation | |
| Start Address, bytes field | Set the offset from the beginning of the item being up-dated | |
| Dump Size, bytes field | Set the size of the item’s area being updated | |
| Update Method list | MOV | Rewrite an item contents completely |
| XOR | Use exclusive OR method for an item contents update | |
| [Set Update Parameters] button | Enter update data in hexadecimal format | |
This option is designed for situations when it is necessary to extend period of use of an application protected by Guardant RTC dongle in the Deactivate algorithm at a certain date licensing mode (aka ‘death time’).
Its advantage lies in the ability to extend the protected application time frame without changing the rest of the dongle memory.
In order to change the time of the hardware algorithm deactivation in an RTC dongle, execute the Dongle | Update dongle command. An update wizard dialog will appear on the screen.
List of pages of the update wizard in Change the algorithm’s deactivation time mode:
| No. | Page | Developer’s actions |
|---|---|---|
| 1 | Memory update | Select remote or local update. For remote update enter the end-user update query into the respective field |
| 2 | Update type | Select Change the algorithm’s deactivation time item |
| 3 | Changing the Deactivation Time | Choose the hardware algorithm and set the new date of deactivation (see screenshot and description below) |
| 4 | Answer is generated | Choose the variant of saving answer |
| 5 | Result | Check the results of the Update Wizard |
“Changing the Deactivation Time” Page
On the Changing deactivation time page, select a hardware algorithm, deactivation date of which needs to be changed, and specify new date or operating time frame.
Changing deactivation time dialog box:
PICTURE
Changing deactivation time dialog box control elements:
| Interface element | Description of purpose |
|---|---|
| Algorithm number and the current operating time limit dropdown list | Select a hardware algorithm from the list for which the deactivation period needs to be changed |
| Extend the operating time frame switch box | Select an option for the deactivation to be postponed by the set interval |
| New interval entry field | Set the operation interval |
| Set a new deactivation date switch box | Select an option for setting the new deactivation calendar date |
| Combined entry field/calendar | Set the new deactivation date |
- No labels