mirror of
https://github.com/3cky/mbusd.git
synced 2024-09-27 03:53:02 +02:00
added informaiton from a ticket question and dev information
https://github.com/3cky/mbusd/issues/24#issuecomment-349256945
This commit is contained in:
parent
ba41aaee28
commit
82b286d47f
29
README.md
29
README.md
@ -3,7 +3,10 @@ About mbusd
|
|||||||
|
|
||||||
[![Build Status](https://travis-ci.org/3cky/mbusd.svg?branch=master)](https://travis-ci.org/3cky/mbusd)
|
[![Build Status](https://travis-ci.org/3cky/mbusd.svg?branch=master)](https://travis-ci.org/3cky/mbusd)
|
||||||
|
|
||||||
**mbusd** is open-source [Modbus TCP to Modbus RTU (RS-232/485)](https://en.wikipedia.org/wiki/Modbus) gateway.
|
**mbusd** is open-source [Modbus TCP to Modbus RTU (RS-232/485)](https://en.wikipedia.org/wiki/Modbus)
|
||||||
|
gateway. It presents a network of RTU slaves as single TCP slave.
|
||||||
|
|
||||||
|
That is a TCP-Slave (or server) which acts as a RTU-master to get data from Modbus RTU-slave devices.
|
||||||
|
|
||||||
Features:
|
Features:
|
||||||
---------
|
---------
|
||||||
@ -128,8 +131,10 @@ To start the **mbusd** service on system boot:
|
|||||||
|
|
||||||
Please check systemd documentation for other usefull systemd [commands](https://wiki.archlinux.org/index.php/systemd)
|
Please check systemd documentation for other usefull systemd [commands](https://wiki.archlinux.org/index.php/systemd)
|
||||||
|
|
||||||
Reporting bugs:
|
Contributing:
|
||||||
---------------
|
-------------
|
||||||
|
|
||||||
|
### Reporting bugs
|
||||||
|
|
||||||
Please file [issue](https://github.com/3cky/mbusd/issues) with attached debug log in verbose (`-v9`) mode, i.e.:
|
Please file [issue](https://github.com/3cky/mbusd/issues) with attached debug log in verbose (`-v9`) mode, i.e.:
|
||||||
|
|
||||||
@ -138,8 +143,7 @@ Please file [issue](https://github.com/3cky/mbusd/issues) with attached debug lo
|
|||||||
Unless you were prompted so or there is another pertinent reason (e.g. GitHub fails to accept the bug report),
|
Unless you were prompted so or there is another pertinent reason (e.g. GitHub fails to accept the bug report),
|
||||||
please do not send bug reports via personal email.
|
please do not send bug reports via personal email.
|
||||||
|
|
||||||
Contributing:
|
### Workflow for code contributions
|
||||||
-------------
|
|
||||||
|
|
||||||
1. Fork it and clone forked repository
|
1. Fork it and clone forked repository
|
||||||
2. Create your feature branch (`git checkout -b my-new-feature`)
|
2. Create your feature branch (`git checkout -b my-new-feature`)
|
||||||
@ -148,6 +152,21 @@ Contributing:
|
|||||||
5. Push to the branch (`git push origin my-new-feature`)
|
5. Push to the branch (`git push origin my-new-feature`)
|
||||||
6. Create new Pull Request
|
6. Create new Pull Request
|
||||||
|
|
||||||
|
### Building and Testing
|
||||||
|
|
||||||
|
Dependencies: please see the correct OS-distribution section in the
|
||||||
|
[.gitlab-ci.yml](https://github.com/3cky/mbusd/blob/master/.gitlab-ci.yml)
|
||||||
|
|
||||||
|
With all dependencies met, one is able to *build and execute tests*
|
||||||
|
issuing the following *bash* commands:
|
||||||
|
```
|
||||||
|
# build
|
||||||
|
mkdir output.dir/ && cd $_
|
||||||
|
cmake ../ && make
|
||||||
|
# execute all tests
|
||||||
|
(cd ../ && python tests/run_itests.py output.dir/mbusd)
|
||||||
|
```
|
||||||
|
|
||||||
Author:
|
Author:
|
||||||
-------
|
-------
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user