kepconfig 1.2.2

Description:

kepconfig 1.2.2

Kepware Configuration API SDK for Python

This is a package to help create Python applications to conduct operations with the Kepware Configuration API. This package is designed to work with all versions of Kepware that support the Configuration API including Thingworx Kepware Server (TKS), Thingworx Kepware Edge (TKE) and KEPServerEX (KEP).
API reference documentation is available on Github Pages
Prerequisites
Package supported and tested on Python 3.9 or later. Older versions support earlier Python 3 environments but have less functionality. All HTTP communication is handled by the urllib Python standard library.
Features

Supports both HTTP and HTTPS connections with certificate validation options

SDK allows for GET, ADD, DELETE, and MODIFY functions for the following Kepware configuration objects:



Features
TKS/KEP
TKE




Project Properties (Get and Modify Only)
Y
Y


Connectivity (Channel, Devices, Tags, Tag Groups)
Y
Y


IoT Gateway (Agents, IoT Items)
Y
Y


Datalogger (Log Groups, Items, Mapping, Triggers, Reset Mapping Service)
Y
Y


Administration (User Groups, Users, UA Endpoints, Local License Server)
Y*
Y


Product Info and Health Status**
Y
Y




Note (*) - UA Endpoints and Local License Server supported for Kepware Edge only
Note (**) - Added to Kepware Server v6.13 / Kepware Edge v1.5 and later builds

Driver specific features:



Driver
Features




GE Ethernet Global Data
Exchanges, Ranges and Name Resolutions


Universal Device Driver
Profile Library



Methods to read the following logs:



Logs
TKS/KEP
TKE




Event Log
Y
Y


API Transaction Log
Y
Y



Configuration API Services implemented:



Services
TKS/KEP
TKE




TagGeneration(for supported drivers)
Y
Y


ReinitializeRuntime
Y*
Y


ProjectLoad and ProjectSave
Y
Y



Note (*) - Reinitialize service was implemented for Kepware Server v6.8+
Filtering, sorting and pagination query options are added for any collections methods (ex: get_all_devices() or get_all_channel()).
Generic REST methods are provided to use for functions not developed in SDK package. These are found in the Server Class in connection.py
Known Limitations

Other property configuration for more complex drivers with objects besides channels, devices, tags and tag groups are not always explicitly defined
Other supported plug-ins (EFM Exporter, Scheduler, etc) are not defined
When using hostnames (not IP addresses) for connections, delays may occur under certain network configurations as the connection may attempt IPv6 connections first. IPv6 is not supported by Kepware servers at this time.

Installation
Package can be installed with pip using the following:
pip install kepconfig

Key Concepts
NOTE: Detailed examples can also be found in the examples folder.
Create server connection
from kepconfig import connection

server = connection.server(host = '127.0.0.1', port = 57412, user = 'Administrator', pw = '')

# For HTTPS connections:
server = connection.server(host = '127.0.0.1', port = 57512, user = 'Administrator', pw = '', https=True)

For certificate validation, the SDK uses the OS/systems trusted CA certificate store. The connection uses the "create_default_context()" function as part of urllib as described at the following links:

ssl.create_default_context
ssl.SSLContext.load_default_certs
set_default_verify_paths

For Windows OSes, the Kepware server's instance certificate can be loaded into the hosts "Trusted Root Certificate Authorities" store.
Create an object
Objects such as channels or devices can be created either singularly or with children included.
Ex: Add Single channel
from kepconfig.connectivity import channel

channel_data = {"common.ALLTYPES_NAME": "Channel1","servermain.MULTIPLE_TYPES_DEVICE_DRIVER": "Simulator"}
result = channel.add_channel(server,channel_data)

Ex: Add Multiple tags
from kepconfig.connectivity import tag

tag_info = [
{
"common.ALLTYPES_NAME": "Temp",
"servermain.TAG_ADDRESS": "R0"
},
{
"common.ALLTYPES_NAME": "Temp2",
"servermain.TAG_ADDRESS": "R1"
}
]
tag_path = '{}.{}.{}'.format(ch_name, dev_name, tag_group_path)
result = tag.add_tag(server, tag_path, tag_info)

Need More Information
Visit:

Kepware.com
PTC.com