judsonupchurch/nanoMODBUS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated README.md

Browse Source
This commit is contained in:
Valerio De Benedetto 2022-06-04 14:16:56 +02:00
parent 7045813f8b
commit 6e7fa6fdcc
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@ -95,8 +95,8 @@ API reference is available in the repository's [GitHub Pages](https://debevv.git
## Platform functions ## Platform functions
nanoMODBUS requires the implementation of 2 platform-specific functions, which are passed as function pointers when nanoMODBUS requires the implementation of 2 platform-specific functions, defined as function pointers when creating a
creating a client/server instance. client/server instance.
### Transport read/write ### Transport read/write
@ -105,8 +105,8 @@ int32_t read(uint8_t* buf, uint16_t count, int32_t byte_timeout_ms, void* arg);
int32_t write(const uint8_t* buf, uint16_t count, int32_t byte_timeout_ms, void* arg); int32_t write(const uint8_t* buf, uint16_t count, int32_t byte_timeout_ms, void* arg);
``` ```
These are your platform-specific functions that read/write data to/from a serial port or a TCP connection. Both methods These are your platform-specific functions that read/write data to/from a serial port or a TCP connection.
should block until either: Both methods should block until either:
- `count` bytes of data are read/written - `count` bytes of data are read/written
- the byte timeout, with `byte_timeout_ms >= 0`, expires - the byte timeout, with `byte_timeout_ms >= 0`, expires
@ -120,9 +120,9 @@ values will be treated as transport errors.
### Platform functions argument ### Platform functions argument
Platform functions can access arbitrary user data through their `void* arg` argument. The argument is useful, for Platform functions can access arbitrary user data through their `void* arg` argument. The argument is useful, for
example, to pass to read/write function the connection they should operate on. example, to pass the connection a function should operate on.
Its initial value can be set inside the `nmbs_platform_conf` struct when creating the client/server instance, and Its initial value can be set inside the `nmbs_platform_conf` struct when creating the `nmbs_t` instance, and changed at
changed at any time via the `nmbs_set_platform_arg` API method. any time via the `nmbs_set_platform_arg` API method.
## Platform endianness ## Platform endianness
@ -140,6 +140,8 @@ cmake ..
make make
``` ```
Please refer to `examples/arduino/README.md` for more info about building and running Arduino examples.
## Misc ## Misc
- To reduce code size, you can define the following `#define`s: - To reduce code size, you can define the following `#define`s: