beremiz

README.md edited online with Bitbucket

2017-04-12, Andrey Skvortsov
2fcea15858a5
Parents 55b6db51eb63
Children 6db967480b7d
README.md edited online with Bitbucket
  • +113 -0
    README.md
  • --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/README.md Wed Apr 12 10:20:01 2017 +0000
    @@ -0,0 +1,113 @@
    +# Beremiz #
    +
    +Beremiz is an integrated development environment for machine automation. It is Free Software, conforming to IEC-61131 among other standards.
    +
    +It relies on open standards to be independent of the targeted device, and let you turn any processor into a PLC. Beremiz includes tools to create HMI, and to connect your PLC programs to existing supervisions, databases, or fieldbuses.
    +
    +With Beremiz, you conform to standards, avoid vendor lock, and contribute to the better future of Automation.
    +
    +See official [Beremiz website](http://www.beremiz.org/) for more information.
    +
    +### Build on Linux ###
    +
    +* Prerequisites
    +```
    +#!sh
    +
    +* # Ubuntu/Debian :
    +sudo apt-get install build-essential bison flex autoconf
    +sudo apt-get install python-wxgtk3.0 pyro mercurial
    +sudo apt-get install python-numpy python-nevow python-matplotlib python-lxml
    +```
    +* Prepare
    +```
    +#!sh
    +mkdir ~/Beremiz
    +cd ~/Beremiz
    +```
    +
    +* Get Source Code
    +```
    +#!sh
    +cd ~/Beremiz
    +
    +hg clone https://bitbucket.org/skvorl/beremiz
    +hg clone https://bitbucket.org/mjsousa/matiec
    +```
    +
    +* Build MatIEC compiler
    +```
    +#!sh
    +cd ~/Beremiz/matiec
    +autoreconf -i
    +./configure
    +make
    +```
    +
    +* Build CanFestival (optional)
    +Only needed for CANopen support. Please read CanFestival manual to choose CAN interface other than 'virtual'.
    +
    +```
    +#!sh
    +cd ~/Beremiz
    +hg clone http://dev.automforge.net/CanFestival-3
    +
    +cd ~/Beremiz/CanFestival-3
    +./configure --can=virtual
    +make
    +```
    +
    +* Launch Beremiz IDE
    +
    +```
    +#!sh
    +cd ~/Beremiz/beremiz
    +python Beremiz.py
    +```
    +
    +### Run standalone Beremiz service ###
    +
    +* Start standalone Beremiz service
    +```
    +#!sh
    +cd ~/Beremiz
    +mkdir beremiz_workdir
    +
    +cd ~/beremiz
    +python Beremiz_service.py -p 61194 -i localhost -x 0 -a 1 ~/Beremiz/beremiz_workdir
    +```
    +
    +* Launch Beremiz IDE
    +```
    +#!sh
    +cd ~/Beremiz/beremiz
    +python Beremiz.py
    +```
    +* Open/Create PLC project in Beremiz IDE.
    +*
    +Enter target location URI in project's settings (project->Config->BeremizRoot/URI_location) pointed to your running Beremiz service (For example, PYRO://127.0.0.1:61194).
    +Save project and connect to running Beremiz service.
    +
    +### Documentation ###
    +
    + * See [Beremiz youtube channel](https://www.youtube.com/channel/UCcE4KYI0p1f6CmSwtzyg-ZA) to get quick information how to use Beremiz IDE.
    +
    + * [User manual](http://www.sm1820.ru/files/beremiz/beremiz_manual.pdf) from INEUM (Russian).
    + Be aware that it contains some information about functions available only in INEUM's fork of Beremiz.
    +
    + * [User manual](http://www.beremiz.org/LpcManager_UserManual.pdf) from Smarteh (English).
    + Be aware that it contains some information about functions available only in Smarteh's fork of Beremiz.
    +
    + * Outdated short [user manual](https://www.scribd.com/document/76101511/Manual-Beremiz#scribd) from LOLI Tech (English).
    +
    + * See official [Beremiz website](http://www.beremiz.org/) for more information.
    +
    +### Support and development ###
    +
    +Main community support channel is [mailing list](https://sourceforge.net/p/beremiz/mailman/beremiz-devel/) (beremiz-devel@lists.sourceforge.net).
    +
    +The list is moderated and requires subscription for posting to it.
    +
    +To subscribe to the mailing list go [here](https://sourceforge.net/p/beremiz/mailman/beremiz-devel/).
    +
    +Searchable archive using search engine of your choice is available [here](http://beremiz-devel.2374573.n4.nabble.com/).
    \ No newline at end of file