Simple instructions for Communication with AMiT PLCs via AtouchX (Czechia)

The PROMOTIC system accesses the AtouchX driver by the PmaActiveX object. This object accesses calling the AtouchX methods and captures its events.
The AtouchX is available on the, where free download is possible.
The following text describes the setup and basic steps for successfull communication by means of the AtouchX object in the PROMOTIC system. (Czechia,

Installation and setup of the AtouchX object

The complex information to the AtouchX driver is provided by the AMiT company.
In order to communicate it is necessary to have the AtouchX installed in your computer. It is available for free download on the web of the device manufacturer. Follow the instructions of the installation program.
For those PLCs that will be communicated with by the PROMOTIC application, the programmer of the AMiT devices must create configuration files. The default names of such configuration files are sDBfile.ini, sHWfile.iniand for archives sArchFile.ini. These contain:
sDBfile.ini: a list of devices together with connection parameters
sHWfile.ini: list of variables, the WID numbers, typs, corresponding station numbers and variable descriptions
sArchFile.ini: archive data reading parameters (only if archive data reading is required.)

Configuration of in the PROMOTIC system communication

The AtouchX configuration files must be in the Cfg folder of the PROMOTIC application
In the PROMOTIC application object tree create:
The preconfiguration contains only some of the most commonly used AtouchX methods for read and write the variables in PLCs and two methods providing information regarding the setup and configuration. The communication iterface consists of designer's methods of the PmaFolder object. There are both initialization and communication methods. Their names and parameters correspond with the methods and parameters in the AtouchX.
On the "ActiveX events" tab of the PmaActiveX object there are events (paired with called method names), that can be used for processing the received data from the communication.
Examples of method calling and processing
Example NetDetData, NetDetDataMtx:
Calling the "NetDetData" method for reading value of a single variable or the "NetDetDataMtx" method for reading data matrix
JavaScriptVBScriptSelect and copy to clipboard

var nErr = pMe.Pm("/AmitAtouchX").NetGetData(2314, 100);  //WID, params
var nErr = pMe.Pm("/AmitAtouchX").NetGetDataMtx(1810, 2, 3, 6, 12, 100);  //WID, Row, Col, Rows, Cols, params
Example of data processing in the EndNetDetDataMtx event of the PmaActiveX object
JavaScriptVBScriptSelect and copy to clipboard

var val0, val1;
if (Result >= 1024)
switch (WID)
case 2314:
pMe.Pm("/Data/#vars/d2314") = DATA;
case 1810:
val0 = DATA.GetItem(0, 0);
val1 = DATA.GetItem(0, 1);
Example DBGetInfo:
Calling the "DBGetInfo" method for reading information regarding the variable
JavaScriptVBScriptSelect and copy to clipboard

var nErr = pMe.Pm("/AmitAtouchX").DBGetInfo(2314);  //WID
Example of calling the "DBGetInfo" method and processing of input/output value of the Array type of the PmaActiveX object
JavaScriptVBScriptSelect and copy to clipboard

var oApp = pMe.Pm("../AtouchApp").Acx;
var mInfo = Pm.CreatePmMap();
mInfo.ParValue = Pm.CreatePmArray().Create(5);
var nState = Pm.CallAxMethod("", oApp, "DBGetInfo", nWID, mInfo);
Pm.Debug("return INFO: " + mInfo.ParValue);
Trade terms:

The usage of the PmaActiveX object requires purchase of the "PmActiveX" licence. With the freeware version PmFree, or when developing the application (with development environment for tersting purposes), this component is always functional.

PROMOTIC 9.0.14 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice