Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mz-automation/lib60870
Official repository for lib60870 an implementation of the IEC 60870-5-101/104 protocol
https://github.com/mz-automation/lib60870
Last synced: about 1 month ago
JSON representation
Official repository for lib60870 an implementation of the IEC 60870-5-101/104 protocol
- Host: GitHub
- URL: https://github.com/mz-automation/lib60870
- Owner: mz-automation
- License: gpl-3.0
- Created: 2017-03-16T22:13:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-03T14:34:50.000Z (6 months ago)
- Last Synced: 2024-08-02T15:03:30.619Z (4 months ago)
- Language: C
- Homepage: https://www.mz-automation.de/communication-protocols/iec-60870-5-101-104-c-source-code-library/
- Size: 1.31 MB
- Stars: 409
- Watchers: 48
- Forks: 212
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: COPYING
Awesome Lists containing this project
- awesome-smartgrid - IEC 60870 - 5-101/104 protocol (Industrial protocols / IEC 60870)
- awesome-industrial-protocols - lib60870 - Implementation of the IEC 60870-5-101/104 protocol (IEC-60870-5-104 / Tools)
README
# README lib60870-C {#mainpage}
lib60870 library for IEC 60870-5 based protocols in C
The current implementation contains code for the IEC 60870-5-101 (application layer and serial link layer) and IEC 60870-5-104 (protocool over TCP/IP) specifications.
Features:
- support for all application layer message types
- master and slave
- balanced and unbalanced link layers (for CS 101 serial communication)
- client/server for CS 104 TCP/IP communication
- CS 104 redundancy group support
- CS101 slave/CS104 server: file service support
- Supports most TLS features required by IEC 62351-3 (third party code mbedtls required)
- portable C99 code
Please also consider the User Guide and the API reference documentation (https://support.mz-automation.de/doc/lib60870/latest/)
## Compiling and running the examples:
In the lib60870-C folder build the library with
`make`
Go to the examples folder and build the examples with
`make`
in each examples' directory.
The library and examples can also be build with _CMake_.
To build the library in a separate folder create a new folder as subdirectory of
the project folder and run cmake to create the build files:
`mkdir build`
`cd build`
`cmake ..`
## Building without common code and HAL
The library contains some common code and a platform abstraction layer (HAL) that is shared with
other protocol libraries of MZ Automation (e.g. libiec61850). In order to simplify using these
protocol libraries together it is possible to compile the library without the common parts.
This can be done by using the *WITHOUT_HAL* and *WITHOUT_COMMON* defines when calling make:
`make WITHOUT_HAL=1 WITHOUT_COMMON=1`
## Building with TLS support
The library can be build with support for TLS. In order to do so you have to download mbedtls version 2.28.x.
Unpack the mbedtls tarball in the dependencies folder so that a folder
dependencies/mbedtls-2.28
exists.
The cmake build system will automatically detect the mbedtls source and build the library with TLS support and mbedtls included
When using make you have to call make with WITH_MBEDTLS=1
`make WITH_MBEDTLS=1`
## Library configuration
There are different runtime and compile-time configuration options.
Compile time configuration options can be used to shrink down the library for small embedded systems. Compile time configuration can be changed by modifying the file _config/lib60870_config.h_.
## Memory allocation
The library uses dynamic memory allocation (malloc/calloc wrapped by own functions that can be replaced when required).
The CS104 slave uses dynamic memory allocation only at setup time (when calling the function _CS104_Slave_create_ and
_CS104_Slave_start_/_CS104_Slave_startThreadless_.
For details please have a look at the _User Guide_.
## Contact:
The library is developed by Michael Zillgith and supported by MZ Automation GmbH.
For bug reports, hints or support please contact [email protected]
## Licensing
This software can be dual licensed under the GPLv3 (https://www.gnu.org/licenses/gpl-3.0.en.html) and a commercial license agreement.
When using the library in commercial and non-GPL applications you should buy a commercial license.
## Commercial licenses and support
Support and commercial license options are provided by MZ Automation GmbH. Please contact [email protected] for more details.
## Contributing
If you want to contribute to the improvement and development of the library please send me comments, feature requests, bug reports, or patches.
For more than trivial contributions I require you to sign a Contributor License Agreement. Please contact [email protected]