Status Register Wizard

17 min

A Status Register allows you to define a register for keeping track of the device status (either connected or disconnected).

If for a Device the user has selected for the Column Enable Status Register to be TRUE, the tool will automatically add a default Status Register JSON Object.

To assist with the definition of the Status Register and ensure that the JSON Object is correctly formatted and includes all required entries, the Device Management Tool provides a Status Register Wizard.

Access the Status Register Wizard

Notes:

To access the Status Regsiter Wizard it is required that:

The Column Status Register is not grayed out -> Column Enable Status Register is set to TRUE
The entry in Column Status Register is not empty. -> The tool should automatically set the default Status Register JSON Object in this case.
A Device Name is defined
A Driver Name is selected
A Driver Group Name is selected

Select the respective cell in Column Status Register for the Device you want to define Status Register.

If all conditions are met, the Status Register Wizard button is shown in the Help section of the LitmusConfiguration ribbon.

Open the Status Register Wizard by pressing the Status Register Wizard button.

The Status Register wizard will show.

Edit a Status Register Property

Select the Status Register Property you want to edit to open its Edit screen.

Edit the Value and press the Modify button.

Notes:

If not both Name and Value are provided, the Modify button will remain grayed out and the property can not be saved.

The wizard also performs a verification for each entry and will show any violation in red. In this case the Modify button will also be grayed out to prevent the saving of any invalid Status Register Property.

Notes:

Some Drivers can reqire additional Status Register Properties based on what is select.

Example: The users changes the opcode properties to 180.

Which adds additional Properties which the user can set.

Status Register Properties with a list of Parameters as value

Some properties require a list of Paramter Sets which are shown as an array of JSON Objects of Parameter Key-Value Pairs. To assist with the correct formatting of this Array a Parameter Sets Wizard is available. To open the Parameter Sets Wizard press the Wizard button.

Notes:

If the the Status Register Property has already Parameter Sets defined, they will be shown in the List.

Add a set of Parameter Key-Value Pair(s)

To add a new Parameter Key-Value pair, press the Add option from the left panel.

This will add a Set of Parameter Key-Value pairs with an empty value, based on the drivers definition. It also shows an Index which is added to help keep track of each sets definition.

Notes:

You can add as many sets of Parameter Key-Value Pairs as you need.

Simply press the Add Option again.

Edit a Parameter Key-Value Pair

Select the Parameter Key-Value pair you want to edit to open its Edit screen.

Edit the Value and press the Modify button.

Notes:

If not both Name and Value are provided, the Modify button will remain grayed out and the Key-Value pair can not be saved.

Delete a set of Parameter Key-Value Pair(s)

Select any Parameter Key-Value pair of a specific Parameter Set you want to delete, to open its Edit screen.

To delete the entire set of Parameter Key-Value Pair(s) press the Delete button.

Notes:

It is not possible to delete individual Parameter Key-Value pairs from a Set. As the entire Set is required by the driver to funtion.

Save all Parameter Sets

To save the array of Sets of Paramater Key-Value pairs, press the Save button.

This will add the correcly formatted Array of JSON Objects as value to the Status Register Property.

Important:

This will overwrite the current value of the Status Register property in the value field.

But it does not save the change.

Cancel the Parameter Sets Wizard

If a user decides to not save the current Sets of Parameter Key-Value Pairs, they can press the Cancel button.

Notes:

This will not overwrite the value in the Value field for the Status Register Property.

Accept the Array of JSON Objects as value

To fully save the array as actual value for the Status Register Property, press the Modify button.

Save the Status Register Properties

To save all the Status Register Properties as a new Status Register JSON Object, press the Save button.

This will create the correctly formatted Status Register JSON Object and store it in column Status Register for the device.

Important: This will overwrite the current value in column Status Register.

Cancel the Status Register Wizard

If a user decides to not save the current Status Register Wizard configuration, they can press the Cancel button.

Notes:

This will not overwrite the current value in column Status Register.