dfins 0.4.1

dfins

This is an implementation of the OMRON FINS protocol using D

Usage

The examples sub directory contains examples explaining how use this library.

Import the module:

import dfins;

Create an udp channel:

enum TIMEOUT_MS = 2000;
IChannel chan = createUdpChannel("192.168.221.22", TIMEOUT_MS);

Create a FinsClient object and pass it:

• channel
• header

Header h = header(22);
FinsClient f = new FinsClient(chan, h);

Finally read and write:

/* Reads 10 registers starting from register 00000 in the DM Memory Area */
ubyte[] d0 = f.readArea(MemoryArea.DM, 0, 10);

/* Writes the values 42, 19, 64 into DM registers 0, 1, 2 */
ushort[] v = [42, 19, 64];
f.writeArea(MemoryArea.DM, 0, v.toBytes!ushort);

Documentation

dfins uses ddoc. One way of building and serving the documentation locally (you will need libevent for serving) is:

dub build -b ddox && dub run -b ddox

Or use your favorite DDOC compiler.

Omron PLC data example

| Data type | Value | FINS rep. | Std rep. | | --- | --- | --- | --- | | float | 3.14 | 0xF5C34048 | 0x4048F5C3 | | string | 'abcdefghi' | 0x4241444346454847049 | 0x4041424344454547484900 | | uint (32bit) | 0x0a0b0c0d | 0x0c0d0a0b | 0x0a0b0c0d |

| | float | string | uint | | --- | --- | --- | --- | | Value | 3.14 | 'abcdefghi' | 0x0a0b0c0d | | FINS rep. | 0xF5C34048 | 0x4241444346454847049 | 0x0c0d0a0b | | Std rep. | 0x4048F5C3 | 0x4041424344454547484900 | 0x0a0b0c0d |