Crimson 3.x: DevCtrl and DrvCtrl Functions

Abstract

This document describes and provides examples for using the DevCtrl and DrvCtrl functions in the Crimson® 3 software.

Products

Red Lion Controls CR1000 Human Machine Interface (HMI), CR3000 HMI, DA Series Data Station, Data Station Plus (DSP), G3 HMI, G3 Kadet HMI, Graphite® Controller, Graphite HMI, Modular Controller, and ProducTVity Station™

Use Case: Modifying Device and Driver Settings using the DevCtrl and DrvCtrl functions

The DevCrtl function allows for modifying device parameters at runtime, while the DrvCtrl function allows for modifying driver settings at runtime. Both functions require active communications to the device in question in order to take effect.  The results of these functions are not retained after a power cycle, if their results are desired after a power cycle, the data value should be a retentive tag, and a program should be called at startup to make as many DevCtrl and DrvCtrl calls as needed.

DevCtrl

DevCtrl accepts three arguments:

1. device (int): the index of the device to be controlled

2. function (int): the function to execute (explained in the tables below)

3. data (cstring):  the parameter for the function

It returns an integer, for functions that return an IP address, use the IP Address format type to display the dotted decimal notation of the IP.

Allen Bradley DF1 Master (TCP)

Function	1	2	3	4
	Set IP Address	Set Target Port	-	Get IP Address

 

Allen Bradley DF1 Master via PCCC/EIP

Function	1
	Set IP Address

 

Allen Bradley L5K (V1)

Function	1	2
	Set IP Address	Get IP Address

 

Allen Bradley L5K (V2)

Function	1	2
	Set IP Address	Get IP Address

 

BACnet Master (all)

Function	1
	Set ID

 

Beta LaserMike LaserSpeed UDP Master

Function	1	2	3	4
	Set IP Address	Set Target Port	Get IP Address	Get Target Port

 

BSAP Extended Serial Master

Function	1	2	3	4
	Set Drop	-	-	Get Drop

 

BSAP Serial Master

Function	1	2	3	4
	Set Drop	-	-	Get Drop

 

BSAP UDP Master

Function	1	2	3	4
	Set IP	Set Target Port	-	Get IP

 

Cognex Data

See Driver Info Sheet

 

Dometic Airnet

Function	1
	Set ID

 

Emerson ROC Enhanced

Function	1	2	3	4
	Set Group	Set Unit	Get Group	Get Unit

Function	5*	6*	7	8*	9*	10*	11*
* C3.1 ONLY	Set Primary IP	Set Target Port	-	Get Primary IP	Set Fallback IP	Get Fallback IP	Toggle Primary / Fallback 0 - Primary 1 - Fallback

 

Galil TCP

See Yaskawa SMC Driver Info Sheet

 

GE SRTP

Function	1	2	3	4	5	6	7
	Set Primary IP	-	-	Get Primary IP	Set Fallback IP	Get Fallback IP	Fallback Status 0 - Primary 1 - Fallback

 

ICP DAS DCON

See Driver Info Sheet

 

Ifm Efector Dualis Image

See Driver Info Sheet

 

Microscan Vision Hawk

See Driver Info Sheet

 

Mitsubishi A/Q/FX TCP

Function	1	2	3	4
	Set IP	Set Target Port	Get IP	Get Target Port

Mitsubishi Q TCP

Function	1	2	3	4
	Set IP	Set Target Port	Get Target Port	Get IP

 

Modbus TCP/IP Master

Function	1	2	3	4	5	6	7
	Set Primary IP	Set Target Port	Set Drop Number	Get Primary IP	Set Fallback IP	Get Fallback IP	Fallback Status 0 - Primary 1 - Fallback

 

Modbus Universal Master

Function	1	2	3	4
	Set Drop	-	-	Get Drop

 

Omniflow Master Serial

Function	1	2	3	4
	Set Drop	-	-	Get Drop

 

Omniflow Modicon TCP/IP

Function	1	2	3	4	5	6
	Set Primary IP	Set Target Port	Set Drop Number	Get IP	Get Target Port	Get Current Drop

 

Omniflow TCP/IP

Function	1	2	3	4	5	6
	Set Primary IP	Set Target Port	Set Drop Number	Get IP	Get Target Port	Get Current Drop

 

Omron FINS UDP Master

Function	1	2	3	4	5	6
	Set Primary IP	Set Target Port	-	Get Primary IP	Set Fallback IP	Get Fallback IP

Function	7	8	9	10	11	12
	Set Primary Dest. Network	Get Primary Dest. Network	Set Primary Dest. Node	Get Primary Dest. Node	Set Primary Dest. Unit	Get Fallback IP

Function	13	14	15	16	17	18
	Set Fallback Dest. Network	Get Fallback Dest. Network	Set Fallback Dest. Node	Get Falback Dest. Node	Set Fallback Dest. Unit	Get Fallback Dest. Unit

 

Omron G9SP-Series via FINS UDP Master

Function	1	2	3	4	5	6
	Set Primary IP	Set Target Port	-	Get Primary IP	Set Fallback IP	Get Fallback IP

Function	7	8	9	10	11	12
	Set Primary Dest. Network	Get Primary Dest. Network	Set Primary Dest. Node	Get Primary Dest. Node	Set Primary Dest. Unit	Get Fallback IP

Function	13	14	15	16	17	18
	Set Fallback Dest. Network	Get Fallback Dest. Network	Set Fallback Dest. Node	Get Falback Dest. Node	Set Fallback Dest. Unit	Get Fallback Dest. Unit

 

OPC Master

Function	1	2	3
	Set IP	-	Get IP

 

Siemens S7 Tag Import

Function	1	2	3	4
	Set Primary IP	Set Target Port	-	Get Primary IP

Function	5	6	7	8
	Set Fallback IP	Get Fallback IP	Fallback Status 0 - Primary 1 - Fallback	Toggle Primary / Fallback 0 - Primary 1 - Fallback

 

Siemens S7-300/400 TCP Master

Function	1	2	3	4
	Set Primary IP	Set Target Port	-	Get Primary IP

Function	5	6	7	8
	Set Fallback IP	Get Fallback IP	Fallback Status 0 - Primary 1 - Fallback	Toggle Primary / Fallback 0 - Primary 1 - Fallback

 

DrvCtrl

DrvCtrl accepts three arguments:

1. port (int): the index of the port assigned to the driver to be controlled

2. function (int): the function to execute (explained in the tables below)

3. data (cstring):  the parameter for the function

It returns an integer.

BACnet 802.3 Slave

Function	1	2	3
	-	Set ID	Get ID

 

BACnet MSTP Slave

Function	1	2	3
	-	Set ID	Get ID

 

BACnet UDP/IP Slave

Function	1	2	3
	-	Set ID	Get ID

 

BETA LaserMike LaserSpeed UDP Final Length Mode Slave

Function	1	2	3	4
	Set IP	Set Target Port	Get IP	Get Target Port

 

Modbus Slave

Function	1	2	3
	Set Drop	Status 0 - Disabled 1 - Enabled	Control 0 - Disable 1 - Enable

 

Raw TCP/IP Active 

Function	1	2	3
	Set Target IP	Set Target Port	-

 

Disclaimer

It is the customer's responsibility to review the advice provided herein and its applicability to the system. Red Lion makes no representation about specific knowledge of the customer's system or the specific performance of the system. Red Lion is not responsible for any damage to equipment or connected systems. The use of this document is at your own risk. Red Lion standard product warranty applies.

Red Lion Technical Support

If you have any questions or trouble contact Red Lion Technical Support by clicking here or calling 1-877-432-9908.

For more information: http://www.redlion.net/support/policies-statements/warranty-statement