Navigation:  Unidrive M600-M702 Onboard Programming Reference > Parameter Access

There are three methods of reading and writing drive parameters from within a user program:

 

 

Access Formats

 

The following formats are supported by Machine Control Studio for accessing parameters and menus:

 

 

 

Menu and Parameter Numbers

 

Each menu on the drive can be accessed in editors and via the input assistant by using the format Mmm.Pppp.

 

For example, to set menu 18, parameter 20 to the value 10, the following structured text could be used:

 

M18.P020 := 10;

 

Note each parameter is of a specified data type (see Parameter Data Types), to read / write a raw value with no decimal point (non floating point) the following syntax can be used:

 

M01.P021_Raw := 1001;

 

As Preset Reference 1 (#01.021) is a floating point value with 1 decimal place the value displayed on the keypad will be 100.1.

 

 

Function Calls

 

A set of functions are available in the library User Runtime Library for reading and writing device parameters:

 

Reading Parameters

 

The functions listed below are used to read the different parameter data types that the drive and modules provide.

 

 

 

If these functions are used, ensure that the correct function is used for the data type of the parameter being read.

 

Inputs:

 

Slot : UDINT; Set to the required slot number. Set to 0 to access a drive parameter or option module setup menus from the drive

 

Menu : UDINT; Set to the required menu number  (15 = Slot 1 setup, 16 = Slot 2 setup, 17 = Slot 3 setup).

 

Parameter : UDINT; Set to the required parameter number

 

Return value: The data type of the returned value depends on the function used. The last part of the function name indicates the data type returned.

 

 

Writing Parameters

 

The functions listed below are used to write values to the different parameter data types that the drive and modules provide.

 

 

 

Inputs:

 

Slot : UDINT; Set to the required slot number. Set to 0 to access a drive parameter or option module setup menus from the drive

 

Menu : UDINT; Set to the required menu number (15 = Slot 1 setup, 16 = Slot 2 setup, 17 = Slot 3 setup).

 

Parameter : UDINT; Set to the required parameter number

 

Value : <Indicated in function name>; Set to the required value to write to the parameter

 

 

 

MyVar1 := ReadUserParameterBOOL(0, 15, 05)    // This is valid to read a option setup menu in slot 1

 

MyVar1 := ReadUserParameterBOOL(1, 15, 05)    // This is NOT valid to read a option setup menu in slot 1

 

 

Note: Unidrive M Onboard User Programs can only reference slot setup menus (i.e. 15, 16, 17) and NOT internal module menus (i.e. menu 90)

 

 

 

Menus and Parameter Names

 

Menus and parameters can be referenced by name from within editors and the input assistant. The chart below lists menus by name.

 

For example, to set menu 18, parameter 20 to the value 10, the following structured text could be used:

 

ApplicationMenu1.AppsMenu1ReadWriteInt20 := 10;

 

The table below has a list of available menu names, once used in editors the application intellisense or Input Assistant will offer a list of parameters available in the menu:

 

 

 

 

See Also