21.12.7 set_device_name

Description

This Tcl command changes the user name of a device in the chain. Chain programming mode must be set.

set_device_name -name {name} -new_name {new_name}

Arguments

ParameterTypeDescription
namestringIdentifies the old device name. This parameter is mandatory.
new_namestringSpecifies the new device name. This parameter is mandatory.
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription
NoneRequired parameter 'name' is missing.
NoneRequired parameter 'new_name' is missing.
NoneThe device with name 'device_name' doesn't exist.
NoneParameter 'name' has illegal value.
NoneParameter 'new_name' has illegal value.
NoneParameter 'param_name' is not defined. Valid command formatting is 'set_device_name -name "name" -new_name "new_name"'.

Supported Families

Supported Families
PolarFire®
PolarFire SoC
RTG4
SmartFusion® 2
IGLOO® 2

Example

The following example changes the user name of the device from 'MyDevice1' to 'MyDevice2':

set_device_name -name {MyDevice1} -new_name {MyDevice2}