Join us today!

Read Write MS SQL D...
 
Notifications
Clear all

Read Write MS SQL Database in TwinCAT 3

2 Posts
2 Users
3 Reactions
2,534 Views
twinControls
Posts: 114
Admin
Topic starter
(@twincontrols)
Member
Joined: 2 years ago

Storing data from a plc program is very crucial for almost every system. You may want to store some sensor readings, events, part data etc... In this tutorial, I will explain how to setup MS SQL Express Database Server and connect to it in TwinCAT 3. 

You can download the MS SQL Express from here. We will also use the SQL Server Management Studio (SSMS) to configure a table and create a user for the database. 

serverandssms

 

After installing these, start the SQL Server Management Studio program. If you can't see the program icon on your desktop, you can create a shortcut from this file path. "C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE\Ssms.exe"

Connect to the server. 

connect

 

Right click on the Database folder and select 'New Database'. 

database

 

We will be logging events from TwinCAT 3 in this tutorial. Name the database as 'DB_Events' and click OK. 

DB Events

 

Expand the DB_Events and right click on the Table folder and select New, then 'Table'. 

createtable

 

Add two columns as EventName (nvarchar(Max)) and EventID (int). 

addcolumns

 

Click Save (CTRL+S) on Server Management Studio and name the table as plc_events_table, then click OK. 

nametable

 

If you don't see the newly created table, right click on the Tables folder and select 'Refresh'. 

refreshtable

 

Right click on the dbo.plc_evetns_table and select 'Edit Top 200 Rows'. We will add some events in the table and read those events later in TwinCAT 3. 

edittable

Add the example events below and click Save. 

additemstotable

 

Now we will configure the login information. Expand 'Security' and right click 'Logins' folder and choose 'New Login'. 

addlogin

 

On the general section, set the login name and password as 'user'. 

setusernamepw

 

Go to Server Roles tab, check the roles below. 

roles

 

On the User Mapping section, click on the ... and browse. Select the db_accessadmin object and click OK. Then click OK on the login properties window as well. 

dbaccessadmin

 

Now we will add a user for the database, which will use the login information we just created. Under DB_Events, expand the Security folder and right click on the Users window and select New User. 

users

On the General section, select 'SQL user with login' option and set the user name as user and select the login name and default schema from the options, then click OK. 

setusernameloginschema

 

Now we will change the server authentication mode. Right click on the server and select properties. 

serverproperties

 

Go to Security tab, and select the 'SQL Server and Windows Authentication mode' then click OK. 

serverauth

 

We would need to restart the SQL Server for this change to take effect. Close the server management program and open Services in Windows. Find the SQL Server and right click, select Restart. 

restartserver

 

Install the TF6420 TwinCAT 3 Database Server. Then go to this path C:\TwinCAT\Functions\TF6420-Database-Server\Win32\Configurator and run the TF6420 Configurator. 

configurator

 

Activate the trial TF6420 License in TwinCAT 3 before using the TF6420 Configurator.

activatelicense

 

Start the TF6420 Configurator. Select the target IPC. Right click on the TwinCAT Database Server Project and select New DB Connection. 

addnewdatabase

 

Now open the server management studio program again to look up the information we need for the database connection. Right click on the server and go to properties and select the general tab. Copy the server name. Database name is DB_events and user login information is user,user for username and password. 

credentials

 

Select the MS SQL Server from the Database Type dropdown menu and enter the information we just acquired below. Activate the configuration (number 3) , then press CHECK (number 4) to check the database connection. 

dbsettings

 

You should receive the connection successful message. 

configsuccess

 

Click on the SQL Query Editor button. 

sqlqueryeditor

 

Refresh the databases. 

refresh

 

Right click on the 'plc_events_table' and click 'Select' . 

select

 

Press the 'Create Query' button (number 1), then press FB_SQLCommand button, you will see the data in the plc_events_table on the result window. As we can see, there are currently 6 events in the table. 

selectandrun

 

Now we will add one more event to the table. Right click on the plc_events_table and select 'Insert'. 

selectinsert

 

Press the 'Create Query' button (number 1), type the new event information (number 2), then press FB_SQLCommand button (number 3). You will see the execute succeeded message in the messages (number 4). 

insercommand

 

Now we will export the plc_events_table as struct and import it in TwinCAT 3. Press the export tablestruct button. 

exportstruct

 

Name the structure as ST_EventStruct and click OK.

renamestruct

 

Save the file. 

savestruct

 

Create a TwinCAT 3 project and right click on the DUTs folder and select Import PLCopenXML. 

importdut

 

Confirm the import DUT. 

confirmimport

 

On the database configurator window, right click on the plc_events window and select 'Insert'. Press the 'Copy query PLC in syntax'. 

insertcommand
'INSERT INTO [dbo].[plc_events_table] ([EventName], [EventID]) VALUES ($'$', 0) '

 

Do the same thing for the SELECT query command. 

selectcommand
'SELECT [EventName], [EventID] FROM [dbo].[plc_events_table] '

These are the commands we will use in TwinCAT 3 to run the insert and select queries.

 

Add the code below in your MAIN program. 

PROGRAM MAIN
VAR	
	sEventName : T_MAXSTRING;
	nEventID   : DINT;

	fbDBRecordArraySelect  : FB_DBRecordArraySelect;
	fbDBRecordInset	        : FB_DBRecordInsert_EX;
	sCmdSelect 		        : T_MaxString;
	sCmdInsert		        : T_MaxString;
	arrEventData		  : ARRAY[1..10] OF ST_EventStruct;
	bExecuteSelect          : BOOL;
	bExecuteInsert		  : BOOL;
	bInsertBusy		  : BOOL;
	bInsertError		  : BOOL;
	bInsertErrID		  : UDINT;
	bSelectBusy	          : BOOL;
	bSelectError		  : BOOL;
	bSelectErrID		  : UDINT;
	nRecords			  : UDINT;	
END_VAR

 

sEventName := 'High Pressure Detected';
nEventID   := 8;

sCmdInsert := CONCAT('INSERT INTO [dbo].[plc_events_table] ([EventName], [EventID]) VALUES ($'',sEventName);
sCmdInsert := CONCAT(sCmdInsert,'$', ');
sCmdInsert := CONCAT(sCmdInsert,DINT_TO_STRING(nEventID));
sCmdInsert := CONCAT(sCmdInsert,')');

//sCmdInsert := 'INSERT INTO [dbo].[plc_events_table] ([EventName], [EventID]) VALUES ($'', )';
sCmdSelect := 'SELECT [EventName], [EventID] FROM [dbo].[plc_events_table] ';

fbDBRecordInset(
	sNetID:= '', //String containing the AMS network ID of the target device, at which the ADS command is directed.
	hDBID:= 1, // Indicates the ID of the database to be used.
	pCmdAddr:= ADR(sCmdInsert), //Pointer to the executing INSERT command
	cbCmdSize:= SIZEOF(sCmdInsert), //Indicates the length of the INSERT command.
	bExecute:= bExecuteInsert, 
	tTimeout:= T#5S, 
	bBusy=> bInsertBusy, 
	bError=> bInsertError, 
	nErrID=> bInsertErrID);
	
	
fbDBRecordArraySelect(
	sNetID:= '', 
	hDBID:= 1, // Indicates the ID of the database to be used.
	pCmdAddr:= ADR(sCmdSelect) , //Indicates the pointer address of a string variable with the SQL command to be executed.
	cbCmdSize:= SIZEOF(sCmdSelect), //Indicates the length of a SELECT command to be executed.
	nStartIndex:= 0, //Indicates the index of the first record to be read.
	nRecordCount:= 10, //Indicates the number of records to be read.
	pDestAddr:= ADR(arrEventData), //Indicates the address of the structure array into which the records are to be written.
	cbRecordArraySize:= SIZEOF(arrEventData), // Indicates the size of the structure array in bytes.
	bExecute:= bExecuteSelect, 
	tTimeout:= T#5S, 
	bBusy=> bSelectBusy, 
	bError=> bSelectError, 
	nErrID=> bSelectErrID, 
	nRecords=> nRecords);
	

 

Rebuild your solution and activate the configuration and log in the plc. Set 'bExecuteInsert' TRUE to insert a new event into the database. You can use the sEventName and nEventID variables to set your event information. 

Set 'bExecuteSelect' TRUE to run the select query. Check the arrEventData array to see the events in the database. We can see that the new event (High Pressure Detected) also logged in the database. 

eventarray

 You can create different tables in the database and add more columns to your new table and import your new tablestruct in TwinCAT 3 to practice and have a better understanding. Also don't forget to copy your new insert/select query commands for your new table. 

 

 

Reply
1 Reply
raoliveira
Posts: 27
(@raoliveira)
Eminent Member
Joined: 2 years ago

Awsome topic, thank you. Will try this later 😀 

Reply
Share: