Swegon TACTouch TAC6 User manual

TAC6 + MODBUS TCP/IP

TAC6 + MODBUS TCP/IP
User’s manual

TABLE OF CONTENTS
1Overview................................................................................................................................................................5
1.1 Scope............................................................................................................................................................5
1.2 Plugging the satellite module.........................................................................................................................6
1.3 Connections of the SATELLITE MODULES..................................................................................................7
1.3.1 SAT ETHERNET connection....................................................................................................................7
1.3.2 SAT WIFI connection ...............................................................................................................................8
2Definition of the MODBUS TCP/IP communication............................................................................................9
2.1 MODBUS TCP/IP Protocol............................................................................................................................9
2.2 MODBUS TCP/IP frame................................................................................................................................9
2.3 MODBUS exception......................................................................................................................................9
2.4 MODBUS values.........................................................................................................................................10
2.5 Write cycles limitation..................................................................................................................................10
3Setup....................................................................................................................................................................10
3.1 SAT ETHERNET SETUP............................................................................................................................10
3.1.1 Configuration for LAN.............................................................................................................................10
3.1.2 Configuration for point-to-point connection with a PC ............................................................................10
3.2 SAT WIFI SETUP........................................................................................................................................12
3.2.1 Access Point Configuration ....................................................................................................................13
3.2.2 Station Configuration..............................................................................................................................14
3.2.3 TCP/IP Parameters Configuration..........................................................................................................15
3.2.4 Connecting a client application to Access Point SAT WIFI.....................................................................15
3.2.5 Connecting a client application to station SAT WIFI...............................................................................15
4“Discovery” Feature ...........................................................................................................................................16
5Remote Access ...................................................................................................................................................16
6Topologies...........................................................................................................................................................16
7Modbus Registers...............................................................................................................................................17
Appendix 1: examples of networking.......................................................................................................................18

5
1 Overview
1.1 Scope
TAC6 regulations for GLOBAL units.
The MODBUS TCP/IP communication with the TAC6 regulation boards requires an additional satellite circuit being used
as interface of communication:
- SAT WIFI option:
•Remote control with specific Swegon App for tablet and smartphone.
•Enables MODBUS TCP/IP protocol on wireless Wi-Fi network.
- SAT ETHERNET option:
•Remote control with specific Swegon App for tablet and smartphone (with a Wi-Fi router/bridge to
Ethernet).
•Enables MODBUS TCP/IP protocol on Ethernet over twisted pair 10 BASE T/100Base-TX IEEE 802.3
network.
The features of each TAC6 regulation are plainly explained in the Operation Manual for GLOBAL.

User’s manual TAC6 + MODBUS TCP/IP
6
1.2 Plugging the satellite module
The assembly must be carried out with the power OFF. The satellite module must be plugged on the « SAT COM » plug
of the TAC6 regulation board.
Caution: A bad positioning of the satellite module on circuit TAC6 can fatally damage both circuits!
The following figure shows the installation of SAT ETHERNET and SAT WIFI on TAC6 control boards.
Figure 1 - Installation of SAT ETHERNET on TAC6 circuit
Figure 2 - Installation of SAT WIFI on TAC6 circuit
TAC6
TAC6

7
1.3 Connections of the SATELLITE MODULES
1.3.1 SAT ETHERNET connection
The SAT Ethernet can be connected either to an existing local area network (LAN, see figure 5), or directly to a PC in a
Point-to-point link (see figure 6).
Just plug the Ethernet cable into the RJ45 connector on SAT ETHERNET and, only for Point-to-point connection with a
PC, connect the other extremity of the cable to the Ethernet network adapter of the PC.
Figure 3 - SAT ETHERNET connection in a LAN Figure 4 - SAT ETHERNET Point-to-point connection with a PC
Cable Specifications:
•Ethernet cable, UTP category 5, 5e or 6 with RJ45
male connectors (figure 7).
•Maximal length = 100m.
Figure 5 - Example of UTP category 5 cable with RJ45
male connectors

User’s manual TAC6 + MODBUS TCP/IP
8
1.3.2 SAT WIFI connection
The SAT WIFI comes preassembled and no additional wiring is necessary. It includes:
- 1 SAT WIFI component with a label reporting its unique MAC address (6x2 digits) and UFL male connector
(figure 9)
- 1 metallic support for the antenna (figure 11).
- 1 antenna with SMA male connector (figure 8)
- 1 UFL female-SMA female antenna cable to connect the SAT WIFI component to the antenna (figure 10)
Figure 6 –SAT WIFI
Component
Figure 7 - Antenna
Figure 8 –Antenna
support
Figure 9 - UFL-SMA Cable

9
2 Definition of the MODBUS TCP/IP communication
2.1 MODBUS TCP/IP Protocol
The TAC6 controllers use the communication protocol MODBUS TCP/IP in one server, the satellite board, to multiple
clients (maximum 3) architecture. The server is addressed by the client thanks to its IP address and communication port
number which is 502.
Each message has the same structure: the frame is made of the transaction identifier, protocol identifier, length field, unit
identifier, the function code (writing or reading) and the data bytes.
Main specifications:
-MODBUS TCP/IP protocol
-Physical layer:
oEthernet over twisted pair 10 BASE T for SAT ETHERNET,
oCompatible Wi-Fi 802.11b/g/n for SAT WIFI.
2.2 MODBUS TCP/IP frame
The MODBUS frame is presented in the following way:
Transaction identifier
Protocol identifier
Length field
unit identifier
Function code
Data
2 bytes
2 bytes
2 bytes
1 bytes
1 byte
N bytes
Transaction identifier: Used for synchronization between messages of server and client
Protocol identifier: Always 0 for Modbus TCP/IP
Length field: Number of remaining bytes in this frame
Unit identifier: This is the Modbus address of the SAT module device. 1 must be used and only this address will be
accepted since the SAT ETHERNET and WIFI are not Modbus TCP/IP bridges to Modbus RTU.
Function code:
-Supports function code 3 (decimal) for reading multiple holding registers.
-Supports function code 6 (decimal) for writing a single holding registers.
-Supports function code 16 (decimal) for writing multiple holding registers.
Data: All TAC6 data is in 16-bit Modbus holding registers. Modbus coils, discrete inputs or input registers are not used.
The Modbus communication buffers size is sufficient for reading 125 registers at once or writing 123 registers at once.
In the Modbus.org standard documents, holding register addresses are given a prefix of "4" to distinguish them from
other register types. For example, in their documentation a holding register at address 1001 is referred to by "41001".
However, the leading "4" is not really part of the address. Also, the Modbus.org standard documents refer to register
addresses using "one-based" numbering. However, the addresses that are actually sent in a Modbus command
message are "zero-based". For example, to read register 1001, the address that is actually sent in the command
message is 1000.
2.3 MODBUS exception
The TAC6 Modbus protocol may respond with an exception code if the read or write command was invalid. Possible
exceptions are:
-01 ILLEGAL FUNCTION: The function code received in the query is not an allowable action for the slave.
-02 ILLEGAL DATA ADDRESS: The data address received in the query is not an allowable address for the
slave. Or the combination of data address and transfer length is not allowable.
-03 ILLEGAL DATA VALUE: The master attempted to write a non-allowed value into a register. Which values are
allowed may depend on configuration settings of other registers.
When a write of multiple registers is executed, the execution stops at the first invalid data address or invalid value.

User’s manual TAC6 + MODBUS TCP/IP
10
2.4 MODBUS values
All values are signed values.
As usual, all Modbus words are in big endian byte order.
Some registers act as bitmaps with 16 status bits.
Some values are 32-bit. They are transferred as two 16-bit registers, first low word, and then high word.
When reading, the client must combine two 16-bit words into one 32-bit value. With shift:
Val32=((((long)HIGH)<<16)|LOW). With math: Val32=HIGH*65536+LOW. For example: Reg1=33041, Reg2=13:
Val32=885009.
When writing a 32-bit parameter, the server first buffers the low word. Then, when the high word is written, the 32-bit
parameter is updated. This low-word buffer is shared for all 32-bit parameters.
2.5 Write cycles limitation
The controller stores all setup parameters and control parameters in non-volatile EEPROM memory to protect against
power failure. This EEPROM memory has an endurance of 1 000 000 write cycles. Therefore, these parameters should
not be changed too often! Writing a parameter with the same value is not a change. Changing a parameter once per hour
would result in 8760 writes per year, or 1 000 000 writes in 110 years. Changing a setup parameter once per minute
would result in 1 000 000 writes in only 690 days!
3 Setup
3.1 SAT ETHERNET SETUP
3.1.1 Configuration for LAN
By default, the IP address of SAT ETHERNET is 192.168.1.1 with netmask 255.255.255.0 and gateway 0.0.0.0.
It may be configured and can be either a static IP address or a dynamic address assigned by the DHCP server of the
LAN to which the SAT is connected to. The netmask and gateway of the Ethernet network have also to be setup.
The setup is done through a point-to-point connection with a PC (see point 3.1.2) or the advanced setup with the
TACtouch:
Menu
Value
IP CNFG?
Select DHCP if the IP address of the unit is assigned dynamically, select MANUAL to enter a static IP
address. Default is DHCP.
IP
address?
1/4 xxx
If IP CNFG= MANUAL, enter the static IP address in 4 steps (1/4, 2/4, 3/4, 4/4). Example: if IP address
is 193.100.0.23, enter at step 1:193, step 2:100, step 3:000 and step 4:023.
netmask?
1/4 xxx
If IP CNFG= MANUAL, enter the netmask (same principle as for ip address).
gateway?
1/4 xxx
If IP CNFG= MANUAL, enter the gateway (same principle as for ip address).
3.1.2 Configuration for point-to-point connection with a PC
Configure the address 192.168.1.2 and the subnet mask 255.255.255.0 as in the example of figure 12 with Windows 10
operating system.