README.md
changeset 3835 5b65b8f6d523
parent 3638 606c984a58c2
child 3836 9b4e94608036
equal deleted inserted replaced
3834:0010719d0dea 3835:5b65b8f6d523
    39 
    39 
    40 Searchable archive using search engine of your choice is available [here](http://beremiz-devel.2374573.n4.nabble.com/).
    40 Searchable archive using search engine of your choice is available [here](http://beremiz-devel.2374573.n4.nabble.com/).
    41 
    41 
    42 ## Build on Linux (developer setup) ##
    42 ## Build on Linux (developer setup) ##
    43 
    43 
    44 ### Prerequisites (Ubuntu/Debian) :
    44 ### System prerequisites (Ubuntu 22.04) :
    45 ```
    45 ```
    46 sudo apt-get install build-essential bison flex autoconf
    46 # install required system packages as root
    47 sudo apt-get install python2-dev libpython2.7-dev libgtk-3-dev libssl-dev libgl1-mesa-dev libglu1-mesa-dev python-setuptools
    47 sudo apt-get install \
    48 
    48   build-essential automake flex bison mercurial \
    49 python2 -m pip install  \
    49   libgtk-3-dev libgl1-mesa-dev libglu1-mesa-dev \
    50     future              \
    50   libpython3.10-dev libssl-dev \
    51     matplotlib          \
    51   python3.10 virtualenv cmake git mercurial
    52     msgpack_python      \
    52 ```
    53     u-msgpack-python    \
    53 
    54     zeroconf2           \
       
    55     enum34              \
       
    56     pyro                \
       
    57     sslpsk              \
       
    58     posix_spawn         \
       
    59     twisted             \
       
    60     nevow               \
       
    61     autobahn            \
       
    62     click               \
       
    63     opcua               \
       
    64     pycountry           \
       
    65     fonttools           \
       
    66     Brotli              \
       
    67     lxml==4.5.0         \
       
    68     wxPython==4.1.1
       
    69 
       
    70 ```
       
    71 
    54 
    72 ### Prepare build directory
    55 ### Prepare build directory
    73 
    56 
    74 All commands hereafter assume that selected directory to contain all downloaded source code and build results is `~/Beremiz`
    57 All commands hereafter assume that selected directory to contain all downloaded source code and build results is `~/Beremiz`
    75 
    58 
    90 
    73 
    91 ```
    74 ```
    92 cd ~/Beremiz
    75 cd ~/Beremiz
    93 git clone https://github.com/beremiz/beremiz
    76 git clone https://github.com/beremiz/beremiz
    94 git clone https://github.com/beremiz/matiec
    77 git clone https://github.com/beremiz/matiec
       
    78 ```
       
    79 
       
    80 ### Python prerequisites (virtualenv) :
       
    81 ```
       
    82 # setup isolated python environment
       
    83 virtualenv ~/Beremiz/venv
       
    84 
       
    85 # install required python packages
       
    86 ~/Beremiz/venv/bin/pip install -r ~/Beremiz/beremiz/requirements.txt
       
    87 
    95 ```
    88 ```
    96 
    89 
    97 ### Build MatIEC compiler
    90 ### Build MatIEC compiler
    98 
    91 
    99 ```
    92 ```
   107 
   100 
   108 Only needed for CANopen support. Please read CanFestival manual to choose CAN interface other than `virtual`.
   101 Only needed for CANopen support. Please read CanFestival manual to choose CAN interface other than `virtual`.
   109 
   102 
   110 ```
   103 ```
   111 cd ~/Beremiz
   104 cd ~/Beremiz
   112 hg clone http://hg.beremiz.org/CanFestival-3
   105 
   113 cd ~/Beremiz/CanFestival-3
   106 hg clone http://hg.beremiz.org/canfestival
       
   107 #  -- or --
       
   108 git clone https://github.com/beremiz/beremiz
       
   109 
       
   110 cd ~/Beremiz/canfestival
   114 ./configure --can=virtual
   111 ./configure --can=virtual
   115 make
   112 make
   116 ```
   113 ```
   117 
   114 
   118 ### Build Modbus library (optional)
   115 ### Build Modbus library (optional)
   119 
   116 
   120 Only needed for Modbus support.
   117 Only needed for Modbus support.
   121 
   118 
   122 ```
   119 ```
   123 cd ~/Beremiz
   120 cd ~/Beremiz
   124 hg clone https://hg.beremiz.org/Modbus
   121 
       
   122 hg clone http://hg.beremiz.org/Modbus
       
   123 #  -- or --
       
   124 git clone https://github.com/beremiz/Modbus
       
   125 
   125 cd ~/Beremiz/Modbus
   126 cd ~/Beremiz/Modbus
   126 make
   127 make
   127 ```
   128 ```
   128 
   129 
   129 ### Build BACnet (optional)
   130 ### Build BACnet (optional)
   138 ```
   139 ```
   139 
   140 
   140 ### Launch Beremiz IDE
   141 ### Launch Beremiz IDE
   141 
   142 
   142 ```
   143 ```
   143 cd ~/Beremiz/beremiz
   144 ~/Beremiz/venv/python ~/Beremiz/beremiz/Beremiz.py
   144 python Beremiz.py
       
   145 ```
   145 ```
   146 
   146 
   147 ## Run standalone Beremiz runtime ##
   147 ## Run standalone Beremiz runtime ##
   148 
   148 
   149 * Start standalone Beremiz service
   149 * Start standalone Beremiz service
   150 
   150 
   151 ```
   151 ```
   152 mkdir ~/beremiz_runtime_workdir
   152 mkdir ~/beremiz_runtime_workdir
   153 python Beremiz_service.py -p 61194 -i localhost -x 0 -a 1 ~/beremiz_runtime_workdir
   153 ~/Beremiz/venv/python ~/Beremiz/beremiz/Beremiz_service.py -p 61194 -i localhost -x 0 -a 1 ~/beremiz_runtime_workdir
   154 ```
   154 ```
   155 
   155 
   156 To connect IDE with runtime, enter target location URI in project's settings (project->Config->BeremizRoot/URI_location) pointed to your running Beremiz service in this case :
   156 To connect IDE with runtime, enter target location URI in project's settings (project->Config->BeremizRoot/URI_location) pointed to your running Beremiz service in this case :
   157 
   157 
   158 ```
   158 ```