{"id":18445632,"url":"https://github.com/fbarresi/softplc","last_synced_at":"2025-04-11T15:20:30.937Z","repository":{"id":45039905,"uuid":"138028536","full_name":"fbarresi/SoftPlc","owner":"fbarresi","description":"Software plc with docker support","archived":false,"fork":false,"pushed_at":"2024-06-25T07:50:15.000Z","size":630,"stargazers_count":131,"open_issues_count":2,"forks_count":33,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-25T11:21:58.583Z","etag":null,"topics":["docker","dotnetcore","plc","s7","sharp7","snap7"],"latest_commit_sha":null,"homepage":"","language":"C#","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/fbarresi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"fbarresi"}},"created_at":"2018-06-20T12:15:09.000Z","updated_at":"2025-03-13T14:02:42.000Z","dependencies_parsed_at":"2024-02-19T08:30:08.769Z","dependency_job_id":null,"html_url":"https://github.com/fbarresi/SoftPlc","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbarresi%2FSoftPlc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbarresi%2FSoftPlc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbarresi%2FSoftPlc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbarresi%2FSoftPlc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fbarresi","download_url":"https://codeload.github.com/fbarresi/SoftPlc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248429129,"owners_count":21101786,"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":["docker","dotnetcore","plc","s7","sharp7","snap7"],"created_at":"2024-11-06T07:06:38.166Z","updated_at":"2025-04-11T15:20:30.897Z","avatar_url":"https://github.com/fbarresi.png","language":"C#","funding_links":["https://github.com/sponsors/fbarresi"],"categories":[],"sub_categories":[],"readme":"# SoftPlc [![Docker Image CI](https://github.com/fbarresi/SoftPlc/actions/workflows/docker-images.yml/badge.svg)](https://github.com/fbarresi/SoftPlc/actions/workflows/docker-images.yml) [![Docker Pulls](https://img.shields.io/docker/pulls/fbarresi/softplc.svg)](https://hub.docker.com/r/fbarresi/softplc/)\nSoftware PLC controlled over Web API\n\n**How often did you need a PLC for testing, but you had none?**\n\nThis project aim to **end you pain** with test against PLC!\n\n## How does it works\n\n### Use it from source code \nBuild and Start the software (don't forget to copy the native library you need)\n\n```shell\ncd SoftPlc\ndotnet restore\ndotnet build\ncp native\\win\\snap7.dll bin\\x64\\Debug\\net6.0\\snap7.dll\ndotnet bin\\Debug\\netcoreapp2.0\\SoftPlc.dll --plcPort=102 --urls=\"http://localhost:8080/\"\n```\n\n### Use it with docker\nPull the actual docker image for your platform [see available tags](https://hub.docker.com/r/fbarresi/softplc/tags/) and run it with the correct port binding. (Brand new MOBY support is included! Just select latest-win1809 tag.)\n\n```docker\ndocker run -p 8080:8080 -p 8443:443 -p 102:102 --name softplc fbarresi/softplc:latest-linux\n```\n\nNow you have:\n\n- a Simulated PLC listening at port 102 ([see ISO-over-TCP protocol](https://tools.ietf.org/html/rfc1006))\n  - by default, it starts without any data. If you need some preset data you can add `-e DATA_PATH=/demodata` to start with a single 2048 byte DataBlock. The data content is described [here](SoftPlc/demodata/README.md).\n\n- an API listening at http://localhost:8080/  (with Swagger included under http://localhost:8080/ ) in which you can __add__, __read__, __modify__ and __delete__ as many datablocks as you want\n\n\n![SoftPlc API](https://github.com/fbarresi/SoftPlc/raw/master/img/SoftPlc_API.png \"Api\")\n\n\n### Do you also need a PLC Client in your application?\n\nCheck my other repository [Sharp7](https://github.com/fbarresi/Sharp7) or [Sharp7Reactive](https://github.com/evopro-ag/Sharp7Reactive)\n\n\n## Contribute\n\nWhould you like to contribute? YES, Please! Just fork/star/watch this repo and submit a pull request!\n\n## Credits\n\nThis software uses Snap7 as PLC server implementation.\nFor info please visit the official page: [http://snap7.sourceforge.net](http://snap7.sourceforge.net)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffbarresi%2Fsoftplc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffbarresi%2Fsoftplc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffbarresi%2Fsoftplc/lists"}