1 # Beremiz #

     2 

     3 Beremiz is an integrated development environment for machine automation. It is Free Software, conforming to IEC-61131 among other standards.

     4 

     5 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.

     6 

     7 With Beremiz, you conform to standards, avoid vendor lock, and contribute to the better future of Automation. 

     8 

     9 See official [Beremiz website](http://www.beremiz.org/) for more information.

    10 

    11 ### Build on Linux ###

    12 

    13 * Prerequisites

    14 ```

    15 #!sh

    16 

    17 * # Ubuntu/Debian :

    18 sudo apt-get install build-essential bison flex autoconf

    19 sudo apt-get install python-wxgtk3.0 pyro mercurial

    20 sudo apt-get install python-numpy python-nevow python-matplotlib python-lxml

    21 ```

    22 * Prepare

    23 ```

    24 #!sh

    25 mkdir ~/Beremiz

    26 cd ~/Beremiz

    27 ```

    28 

    29 * Get Source Code

    30 ```

    31 #!sh

    32 cd ~/Beremiz

    33 

    34 hg clone https://bitbucket.org/skvorl/beremiz

    35 hg clone https://bitbucket.org/mjsousa/matiec

    36 ```

    37 

    38 * Build MatIEC compiler

    39 ```

    40 #!sh

    41 cd ~/Beremiz/matiec

    42 autoreconf -i

    43 ./configure

    44 make

    45 ```

    46 

    47 * Build CanFestival (optional)

    48 Only needed for CANopen support. Please read CanFestival manual to choose CAN interface other than 'virtual'.

    49 

    50 ```

    51 #!sh

    52 cd ~/Beremiz

    53 hg clone http://dev.automforge.net/CanFestival-3

    54 

    55 cd ~/Beremiz/CanFestival-3

    56 ./configure --can=virtual

    57 make

    58 ```

    59 

    60 * Launch Beremiz IDE

    61 

    62 ```

    63 #!sh

    64 cd ~/Beremiz/beremiz

    65 python Beremiz.py

    66 ```

    67 

    68 ### Run standalone Beremiz service ###

    69 

    70 * Start standalone Beremiz service

    71 ```

    72 #!sh

    73 cd ~/Beremiz

    74 mkdir beremiz_workdir

    75 

    76 cd ~/beremiz

    77 python Beremiz_service.py -p 61194 -i localhost -x 0 -a 1 ~/Beremiz/beremiz_workdir

    78 ```

    79 

    80 * Launch Beremiz IDE

    81 ```

    82 #!sh

    83 cd ~/Beremiz/beremiz

    84 python Beremiz.py

    85 ```

    86 * Open/Create PLC project in Beremiz IDE.

    87 * 

    88 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).

    89 Save project and connect to running Beremiz service.

    90 

    91 ### Documentation ###

    92 

    93  * See [Beremiz youtube channel](https://www.youtube.com/channel/UCcE4KYI0p1f6CmSwtzyg-ZA) to get quick information how to use Beremiz IDE.

    94  

    95  * [User manual](http://www.sm1820.ru/files/beremiz/beremiz_manual.pdf) from INEUM (Russian).

    96    Be aware that it contains some information about functions available only in INEUM's fork of Beremiz.

    97 

    98  * [User manual](http://www.beremiz.org/LpcManager_UserManual.pdf) from Smarteh (English).

    99    Be aware that it contains some information about functions available only in Smarteh's fork of Beremiz.

   100 

   101  * Outdated short [user manual](https://www.scribd.com/document/76101511/Manual-Beremiz#scribd) from LOLI Tech (English).

   102 

   103  * See official [Beremiz website](http://www.beremiz.org/) for more information.

   104 

   105 ### Support and development ###

   106 

   107 Main community support channel is [mailing list](https://sourceforge.net/p/beremiz/mailman/beremiz-devel/) (beremiz-devel@lists.sourceforge.net).

   108 

   109 The list is moderated and requires subscription for posting to it.

   110 

   111 To subscribe to the mailing list go [here](https://sourceforge.net/p/beremiz/mailman/beremiz-devel/).

   112 

   113 Searchable archive using search engine of your choice is available [here](http://beremiz-devel.2374573.n4.nabble.com/).