{"id":20120725,"url":"https://github.com/industrial-edge/pingpong-python","last_synced_at":"2025-05-06T14:33:21.539Z","repository":{"id":42136891,"uuid":"327304679","full_name":"industrial-edge/pingpong-python","owner":"industrial-edge","description":"Industrial Edge application example to show how to play ping pong using MQTT and system applications","archived":false,"fork":false,"pushed_at":"2024-12-18T10:35:18.000Z","size":22215,"stargazers_count":8,"open_issues_count":1,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-09T14:08:50.043Z","etag":null,"topics":["ie-databus","ie-flow-creator","industrial-edge","python","v1-1"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/industrial-edge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-06T12:27:27.000Z","updated_at":"2024-12-18T10:35:30.000Z","dependencies_parsed_at":"2024-12-18T11:34:17.429Z","dependency_job_id":"7a578ab0-c37a-4c6e-aaa2-7c9bfe4155a5","html_url":"https://github.com/industrial-edge/pingpong-python","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/industrial-edge%2Fpingpong-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/industrial-edge%2Fpingpong-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/industrial-edge%2Fpingpong-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/industrial-edge%2Fpingpong-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/industrial-edge","download_url":"https://codeload.github.com/industrial-edge/pingpong-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252703478,"owners_count":21790891,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ie-databus","ie-flow-creator","industrial-edge","python","v1-1"],"created_at":"2024-11-13T19:22:36.801Z","updated_at":"2025-05-06T14:33:21.152Z","avatar_url":"https://github.com/industrial-edge.png","language":"HTML","readme":"# Ping Pong Edge application implemented in Python\n\nApplication example how to communicate over MQTT broker (called Databus in case of Industrial Edge) using Flow Creator and Python.\n\nThere are also implementations in other programming languages, you can find them in their own repositories:\n\nJavascript : https://github.com/industrial-edge/pingpong-nodejs\n\nC : https://github.com/industrial-edge/pingpong-c\n\n---\n\n\n- [Ping Pong Edge application implemented in Python](#ping-pong-edge-application-implemented-in-python)\n  - [QuickStart](#quickstart)\n  - [Description](#description)\n    - [Overview](#overview)\n  - [Requirements](#requirements)\n    - [Used components](#used-components)\n    - [Further requirements](#further-requirements)\n  - [Installation](#installation)\n    - [Direct Import steps](#direct-import-steps)\n    - [Complete Installation](#complete-installation)\n  - [Usage](#usage)\n    - [Dependencies](#dependencies)\n    - [Playing ping pong](#playing-ping-pong)\n  - [Documentation](#documentation)\n  - [Contribution](#contribution)\n  - [License and Legal Information](#license-and-legal-information)\n  - [Disclaimer](#disclaimer)\n\n## QuickStart\n\nIf you want to run everything locally with single command just run `docker-compose up -d` and open webpage on [localhost:1880](http://localhost:1880) and import [flows](SFC-flows/Pingpong-testing.json).\n\n## Description\n\nThis application example demonstrates how Industrial Edge application can communicate with Databus using MQTT protocol. The goal is to send a string \"Ping\" message to Databus (MQTT broker) to a topic \"topic1\" and subscribe to MQTT topic \"topic2\" which should return \"Pong python\". The return message is generated by this python application. You can play virtual ping pong using this application!\n\n![usecase](docs/graphics/Usecase.png)\n\n### Overview\n\nReady to use application example can be downloaded on [Industrial Edge GitHub repository](https://github.com/industrial-edge/ping-pong-python) in the [releases section](https://github.com/industrial-edge/ping-pong-python/releases) called PingPongApplicationExample_x.x.x.app.zip. After unzipping this file you can directly import the .app file to your Industrial Edge Management system.\n\nThe release section also includes a docker base image that was used for this application example. The base image is included here for legal reasons.\n\nA picture bellow shows the application data flow and architecture from the docker container point of view.\n\n![dataflow](docs/graphics/DataFlow.png)\n\n## Requirements\n\n### Used components\n\nThis application version 1.1.x was created and tested using these components\n\n- Industrial Edge App Publisher V1.10.5\n- Docker Engine 20.10.2\n- Docker Compose V2.4\n- Industrial Edge Device V1.10.0-9\n- Databus Configurator V2.0.0-5\n- Databus V2.0.0-4\n- Flow Creator V1.12.0-1\n- IE Management System V1.5.2-4\n\n### Further requirements\n\n- IE Device is onboarded to a IE Management\n- Databus Configurator is deployed to the IE Management\n- Databus is deployed to the IE Device\n- Flow Creator is deployed to the IE Device\n\n## Installation\n\nYou have two options how to install this app into Industrial Edge Management system. You can either use the [Direct Import section](#direct-import) to reuse .app we build for you or you can follow the [Complete Installation](#complete-installation) section to create the .app yourself.\n\n### Direct Import steps\n\n1. Import .app application available at [GitHub](https://github.com/industrial-edge/ping-pong-python/releases) to your Industrial Edge Management using one of the two options\n   1. Industrial Edge App Publisher (recommended)\n   2. Catalog import functionality\n2. Install the imported app to onboarded Industrial Edge Device\n3. Follow the configuration steps in [Installation guide](docs/Installation.md).\n\n### Complete Installation\n\nComprehensive instructions for building and installing this application is available in the [Installation guide](docs/Installation.md).\n\n## Usage\n\n### Dependencies\n\nIn order for this application to run properly on Industrial Edge Device (IED), the following two applications must be installed and configured on the IED\n\n- Databus application\n- Flow Creator application\n\nFor detailed explanation have a look in the [Installation guide](docs/Installation.md) in the Testing section.\n\n### Playing ping pong\n\nHave a look in the [Installation guide testing section](docs/Installation.md) on how to play ping pong in Industrial Edge. :D\n\n## Documentation\n \n- You can find further documentation and help in the following links\n  - [Industrial Edge Hub](https://iehub.eu1.edge.siemens.cloud/#/documentation)\n  - [Industrial Edge Forum](https://forum.mendix.com/link/space/industrial-edge)\n  - [Industrial Edge landing page](https://new.siemens.com/global/en/products/automation/topic-areas/industrial-edge/simatic-edge.html)\n  - [Industrial Edge GitHub page](https://github.com/industrial-edge)\n  - [Industrial Edge documentation page](https://docs.eu1.edge.siemens.cloud/index.html)\n  \n## Contribution\n\nThank you for your interest in contributing. Anybody is free to report bugs, unclear documentation, and other problems regarding this repository in the Issues section.\nAdditionally everybody is free to propose any changes to this repository using Pull Requests.\n\nIf you haven't previously signed the [Siemens Contributor License Agreement](https://cla-assistant.io/industrial-edge/) (CLA), the system will automatically prompt you to do so when you submit your Pull Request. This can be conveniently done through the CLA Assistant's online platform. Once the CLA is signed, your Pull Request will automatically be cleared and made ready for merging if all other test stages succeed.\n\n## License and Legal Information\n\nPlease read the [Legal information](LICENSE.txt).\n\n## Disclaimer\n\nIMPORTANT - PLEASE READ CAREFULLY:\n\nThis documentation describes how you can download and set up containers which consist of or contain third-party software. By following this documentation you agree that using such third-party software is done at your own discretion and risk. No advice or information, whether oral or written, obtained by you from us or from this documentation shall create any warranty for the third-party software. Additionally, by following these descriptions or using the contents of this documentation, you agree that you are responsible for complying with all third party licenses applicable to such third-party software. All product names, logos, and brands are property of their respective owners. All third-party company, product and service names used in this documentation are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findustrial-edge%2Fpingpong-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Findustrial-edge%2Fpingpong-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findustrial-edge%2Fpingpong-python/lists"}