Documentation

• How Teeken works
• Installation and basic setup
• How-To...
• The Ini-File Reference
• Things to come
• Appendix: Comma Separated Value (CSV) files

Installation and Basic Setup

1. Download one of the Teeken zip packages
2. Unpack the zip file into an empty directory
3. Adjust the teeken.ini according to your situation (see below)
4. Open a console window (cmd.exe) and cd to your Teeken directory
5. Start teeken.exe and look what happens :)

Some minimal settings

Siemens S7, TCP, send e-mail on input change

uplink;smtp;"smtps://smtp.gmail.com";"john.doe";"mymailpassword";"john.doe@gmail.com"
source;"theMachine"
adr;simatic;tcp:192.168.0.1
node;a;"e0.1";"Fuse Fail";"/machine";Z
receiver;"someHuman"
adr;mail;"the.man@example.com"
dir;"/machine"

This configuration defines

• the connection to the mail server to send e-mails
• a source named theMachine
• the connection to the PLC, in this case a Siemens via TCP/IP at 192.168.0.1
• a node at input e0.1 with
  • message text "Fuse Fail"
  • associated with the directory machine
  • triggered, when it becomes Zero
• a receiver named someHuman
• the address to send the e-mail notifications
• the same dir as the node

Siemens S7, USB-MPI, record counter changes

source;"theMachine"
adr;simatic;usb
set;readinterval;2
node;a;"db10.dbw30";"Pieces made {{*}}";"/machine";D:0
receiver;"logfile"
adr;file;"c:/data/data_%Y%m%d.log"

This configuration defines

• a source (see above)
• the connection to the PLC, in this case a Siemens via USB / MPI
• a node at data block db10, data word 30 with
  • message text "Pieces made" and the current value of the node
  • associated with the directory machine
  • triggered every time the value changes
• a receiver named logfile
• the file name specification, i.e. daily log files

Modbus, TCP, notify different receivers

uplink;smtp;"smtps://smtp.gmail.com";"john.doe";"mymailpassword";"john.doe@gmail.com"
source;"theMachine"
adr;modbus;tcp:192.168.0.1
node;a;"0:1";"Fuse Fail";"/machine1";Z
node;a;"0:101";"Manual Mode";"/machine2";N
node;a;"4:17";"Pieces made";"/logger";D:0
receiver;"Person 1"
adr;mail;"the.person@example.com"
dir;"/machine1"
receiver;"Person 2"
dir;"/machine2"
adr;mail;"another.person@example.com"
receiver;"Logfile"
adr;file;"c:/data/data_%Y%m%d.log"
dir;"/logger"

This configuration defines

• the connection to the mail server to send e-mails
• a source (see above)
• the connection to the PLC, in this case a ModbusTCP capable device, probably a Schneider-Electric at 192.168.0.1
• a node at input 0:1 and directory /machine1
• a node at input 0:101 and directory /machine2
• a node at register 4:17 and directory /logger
• receiver 1 with
  • an e-mail address
  • the directory of node 1
• receiver 2 with
  • an e-mail address
  • the directory of node 2
• receiver 3 with
  • a file name specification
  • the directory of node 3

The different directory names connect the nodes with the desired receivers.