wago / pfc-howtos

Here you will find all the example code for extensions and tools for the pfc family

This repo includes all the HowTos available for PFC

Overview of existing HowTos

Name	for Version	Description
AccessRetainVariables	FW17	Accessing retain variables using C or C++
AddPerfTool	FW12	Adding perf tool
AddTRDP	FW12	Adding TRDP/TCNopen
AddSQLiteCommandLineTool	FW12	Install the command-Line-Tool "sqlite3"
ADI-MyKBusApplikation	FW12	Demo C Application for KBUS
ADI-DALwithSerialTerminal750-652	FW20.1	Utilize serial terminal 750-652 via DAL/ADI
AutoCopySD-CardImage2InternalFlash	FW12	Automaticaly copies SD card image to internal flash
BuildRustExecutables	FW17	Cross-compile RUST executables
Certmonger	FW20.1	Daemon monitors certificates for impending expiration
HowTo_GenerateWUPFile	FW12	Generate WAGO-Upload-File
KbusModbusSlave	FW14	Adding KbusModbusSlave
Mono	FW14	Mono is a runtime implementation
mosquittoBroker	FW12.1	Adding a Mosquitto Broker
OpenDDS	FW18	Open source C++ implementation of DDS
ReadOperatingModeSwitches	FW12	Reads out the switch position
Ser2Net	FW13	Serial to Network Proxy
ZeroMQ	FW18	High-performance asynchronous messaging library
Libkbus-register-settings	FW20.1	Precompiled version of kbus-register-settings
Register-access-65x-demo	FW20.1	Demo usage of the libkbus-register-settings library
AddUserOrGroup	FW20	Add a user or a group in different FW-versions
SplitAdminUser	FW20	Seperate admin user for codesys3 and wbm

---

You will find in any specific HowTo a dedicaded README.md which included a table that shows you the compatibiliy of this how to.

For example:

PFC	Compatible
PFC 100
750-8100	Y
750-8101	Y
750-8102	Y
PFC 200
750-8202	Y
750-8203	Y
750-8204	Y
750-8206	Y
750-8207	Y
750-8208	Y
PFC 200 G2
750-8212	Y
750-8213	Y
750-8214	Y
750-8216	Y

Also you will find a version information that show exactly the firmware version on which this Howto was created. This means if you will find an older HowTo for a newer firmware it might require a little extra effort to transfer it to the actual firmware version. Pleasw keep in mind that some HowTos includes a precompiled package. Those could work on older versions but we recommend to recompile them within the actual firmware.

A version Information looks like this:

---

HowTo XY - For Version BSP2017.17.1

---

Inside the HowTo directory you will find for older HowTos a HowTo_XY.txt file. This file contains a setup guide and provides some extra informations.

pfc-howtos's Issues

Add a how to for installing docker-compose

With the possibility of installing docker from here it would be nice to be able to use docker-compose.

I am not sure of the tooling available in the default firmware if docker-compose would be supported.

Wago 750-658 CANBUS

Request help to interface Wago 750-658 in Linux over Kbus. Thank you.

Wago-750-8212 Kbus Cycle time

Heys,
according to the documentation kbus-cycle is 50ms

https://github.com/WAGO/pfc-howtos/tree/master/HowTo_ADI-MyKBusApplikation
Kbus-TimeOut of Output-IO-Terminals
Every WAGO Output-IO-Terminals monitors elapsed time since last Kbus-cycle. If elapsed time exceed 50ms, IO-Terminal shut down the outputs.

Is there a workaround to increase this timeout?
I've seen a setting in codesys like below. but is it possible to change the update mode to "synchronous" through the code with adi interface?

Request for example to read and update status of the leds

In addition to the example to read the state of the switch it would be useful to have an example how you can read/set the status of the internal status leds of the PLC and print the status to the terminal.

Support for NET5 on Wago PLC

Dear,
I have noticed a 2-year-old howto on mono and the Wago Linux PLC platform. Is there a possibility to install and run the now available NET5 runtime on the PLC? Was this scenario tested or on the other hand there is some objective that makes it impossible?
Best regards, Jan

addint a postinst file

Hello
I would like to add a postinst file inside an ipk in order to have some automatism when installing an ipk.
for example in order to run a command should I use:
/path/script.sh
or
$DESTDIR/path/script.sh
The first one make the compilation failed (since ptxdist can't find the file)
The second one work with ptxdist but the $DESTDIR is still inside the ipk.
Is this a problem ?
Thanks.

Adressing behavior in bit access FC

It looks the adressing doesn't exactly match a standard coupler (750-3x2) when using write coil function code.

First example, a configuration with

• 1 x 750-530 (8DO)
• 1 x 750-504 (4DO)
• 1 x 750-1504 (16DO)
  The registers are 512->519 => 750-530
  520->527 => blank
  528->531 => 750-504
  532->536 => First 4 channel of 750-1504
  537->543 => blank
  544->551 =>750-1504 5th to 12th channel
  552->559 => blank
  560->563 => 750-1504 13th to 16th channel
  In bit access, digital outputs should be next to each other.
  There is a blank byte between each byte.

Second example with 3 x 750-515
512->515 => first 750-515
516->519 => second 750-515
520->527 => blank
528->531 => 3rd 750-515

Could you correct it to make it match the behavior of a standard modbus coupler ? Thanks.
I guess digital inputs are also affected.

wago 750-8212 image build

Hello community,
I followed pfc-sdk readme, and managed to build .c files through the ptxdist and the toolchain.
however
when I add code pieces that contains external libraries such as

#include <sqlite3.h>
#include <wago/retain.h>
#include <memory.h>
#include <dal/adi_application_interface.h>
#include <ldkc_kbus_information.h>
#include <ldkc_kbus_register_communication.h>

I got errors like for example for retain (even I put binaries and headers and link them in the makefile)

** undefined_reference wrv_close etc (and more of these errors for other methods that been used in the source code)

The documentation is not really clear to me. Should I be fluent in ptxdist? to compile c files that will run in wago embedded linux environment?
Not sure where to start?
I can share more info if needed but I dont know where to start. thanks.

Compile error with kbusmodbusslave

Hello got some trouble while compiling the kbusmodbusslave found here.
I have followed the how to line by line but I have some trouble:

First the command:

user@ubuntu:~/wago/ptxproj$ ptxdist clean kbusmodbusslave
Give me this:

'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '
'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '
'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '
'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '

-----------------------------
target: kbusmodbusslave.clean
-----------------------------

rm -rf /home/user/wago/ptxproj/platform-wago-pfcXXX/state/kbusmodbusslave.*
rm -rf /home/user/wago/ptxproj/platform-wago-pfcXXX/packages/kbusmodbusslave_*
rm -rf /home/user/wago/ptxproj/platform-wago-pfcXXX/build-target/kbusmodbusslave

Then the command:

user@ubuntu:~/wago/ptxproj$ ptxdist targetinstall kbusmodbusslave
Give me:

'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '
'enerated/wago_specific_dal.in:1:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:3:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:4:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:5:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:6:warning: ignoring unsupported character '
'home/user/wago/ptxproj/rules/kbusmodbusslave.in:7:warning: ignoring unsupported character '
Package wago_diagnostic was not found in the pkg-config search path.
Perhaps you should add the directory containing `wago_diagnostic.pc'
to the PKG_CONFIG_PATH environment variable
No package 'wago_diagnostic' found
In file included from main.c:27:0:
modbus.h:5:27: fatal error: modbus/modbus.h: No such file or directory
compilation terminated.
make[1]: *** [main.o] Error 1
make: *** [/home/user/wago/ptxproj/platform-wago-pfcXXX/state/kbusmodbusslave.compile] Error 2

In the file ptxproj/rules/kbusmodbusslave.in the CRLF must be replaced by only LF to remove the warning of characters.

If anyone have some idea ...

libkbus_register_settings

Hi,
As I understand, libkbus_register_settings is used for configuring 750-652 terminals. Is it possible to use the library for configuring other types of terminals. For example, I want to configure an analog input voltage range as -10 to +10V. Or change the analog input module mode from voltage to current measurement. If it is possible to use the library for other modules, how can I find the register sets of other specific modules?