Linux Simple I/O Library

../
`CHANGELOG.txt`	`1335319`	`Jan 16 09:46:16 2021`
`COPYING`	`1259`	`Feb 23 21:19:13 2020`
`Makefile`	`5594`	`Jan 16 09:46:13 2021`
`README.html`	`9923`	`Dec 22 07:58:05 2020`
`README.md`	`9115`	`Dec 22 07:58:05 2020`
`README.txt`	`9379`	`Dec 22 07:58:05 2020`
`ada/`	`512`	`Nov 28 19:30:36 2020`
`basic/`	`512`	`Dec 14 01:40:41 2018`
`c++/`	`512`	`Nov 19 11:47:28 2020`
`c/`	`1024`	`Dec 5 10:57:36 2020`
`control`	`197`	`Jul 24 00:51:02 2017`
`csharp/`	`512`	`Dec 10 15:29:35 2020`
`doc/`	`1024`	`Dec 10 15:29:35 2020`
`dotnet/`	`512`	`Mar 3 11:24:27 2020`
`elements/`	`512`	`Jan 12 09:46:30 2021`
`go/`	`512`	`Nov 19 11:47:28 2020`
`hotplug/`	`512`	`Dec 17 22:00:48 2020`
`include/`	`512`	`Sep 26 11:01:14 2020`
`java/`	`512`	`Jan 14 11:25:41 2019`
`modula2/`	`512`	`Nov 28 19:30:36 2020`
`nuget/`	`512`	`Jan 16 09:46:13 2021`
`pascal/`	`512`	`Nov 19 11:47:28 2020`
`postinst.muntsos`	`88`	`Dec 22 08:49:32 2020`
`postinst.native`	`408`	`Dec 22 08:49:32 2020`
`postrm.muntsos`	`56`	`Dec 22 08:49:32 2020`
`postrm.native`	`403`	`Dec 22 08:49:32 2020`
`tests/`	`512`	`Dec 5 10:57:36 2020`
`win/`	`512`	`Feb 2 23:46:07 2020`

libsimpleio is an attempt to encapsulate (as much as possible) the ugliness of Linux I/O device access. It provides services for the following types of I/O devices:

Industrial I/O Subsystem A/D (Analog to Digital) Converter Devices
Industrial I/O Subsystem D/A (Digital to Analog) Converter Devices
GPIO (General Purpose Input/Output) Pins
Raw HID (Human Interface Device) Devices
I²C (Inter-Integrated Circuit) Bus Devices
Labview LINX Remote I/O Devices
PWM (Pulse Width Modulated) Output Devices
Remote I/O Protocol Devices
Serial Ports
SPI (Serial Peripheral Interface) Bus Devices
Stream Framing Protocol Devices
TCP and UDP over IPv4 Network Devices
Watchdog Timer Devices

Although libsimpleio was originally intended for Linux microcomputers such as the Raspberry Pi, it can also be useful on larger desktop Linux systems.

The C wrapper functions exported by libsimpleio all follow the same uniform pattern:

All C wrapper functions are proper procedures (void f() in C).
All input arguments of primitive types (int, float, etc.) are passed by value.
All output arguments of primitive types are passed by reference (int *, float *, etc.).
All composite types are passed by reference.
int32_t is used wherever possible for int and bool arguments.

All of the C wrapper functions are declared between _BEGIN_STD_C and _END_STD_C for C++. Binding modules are provided for Ada, C#, Java, and Free Pascal. Additional source code libraries are provided for Ada, C++, C#, Java, and Free Pascal that define OOP (Object Oriented Programming) classes for libsimpleio.

News

8 January 2020 -- Added LINUX_errno(). Added libmodbus bindings and objects for Ada.
31 January 2020 -- Added .gpr project files to ada/programs/libsimpleio/, ada/programs/libsimpleio/mcp2221/, and ada/programs/libsimpleio/remoteio to allow building native programs with just gprbuild, using a command like:
```
gprbuild libsimpleio.gpr -p test_userled
```
Reworked Ada make files to allow building Windows applications in Windows Subsystem for Linux. Until now, using the make files on Windows required using Cygwin.
1 February 2020 -- Added links to Make With Ada projects.
2 February 2020 -- Flattened the csharp/ directory tree.
7 February 2020 -- Added .Net Core 3.1 project templates for both libsimpleio and libremoteio. Install these from NuGet with the following commands:
```
dotnet new -i libsimpleio-templates
dotnet new -i libremoteio-templates
```
10 February 2020 -- Renamed NuGet package libsimpleio-standard to libsimpleio. Renamed NuGet package libremoteio-standard to libremoteio. Dropped support for building .Net Framework applications with csc.exe.
12 February 2020 -- Added Visual Studio project templates for libsimpleio and libremoteio for C# console applications for .Net Core and .Net Framework.
25 February 2020 -- Added support for building NuGet C# .Net Core application packages.
3 March 2020 -- Modified libsimpleio.dll to use IO.Objects.libsimpleio.Device.Designator instead of chip and channel to select ADC inputs, DAC outputs, GPIO pins, I²C buses, PWM outputs, and SPI slave selects.
30 April 2020 -- Added popen() wrappers LINUX_popen_read(), LINUX_popen_write() and LINUX_pclose(). Added Ada packages Email_Sendmail and Email_Mail, for sending email messages via /usr/sbin/sendmail and /usr/bin/mail respectively.
15 May 2020 -- Autogenerate API documentation .pdf files from libremoteio.dll.chm and libsimpleio.dll.chm. Include API documentation files (both .chm and .pdf) in the NuGet packages.
12 September 2020 -- Added or refined email services for Ada, C#, and Free Pascal. This work resulted from a lengthy period of experimentation with sending email from a Linux embedded system.
18 September 2020 -- Modified udev rule handling for native Linux systems. The rules and their helper scripts are now installed to /usr/local/share/libsimpleio/udev/. If you install from a source checkout, you now need to do make install_udev_rules after make install in order to install some symbolic links in /etc/udev/rules.d.
Added a NuGet local package feed to libsimpleio. You need to manually add an entry to the packageSources block in NuGet.Config (found at .config/NuGet/NuGet.Config on Linux or %HOMEDRIVE%%HOMEPATH%\AppData\Roaming\NuGet\NuGet.Config on Windows) in order to use the local package feed. You should also comment out the entry for nuget.org, especially if you need to build .Net applications offline from the Internet.
30 October 2020 -- Added initial support for the Go programming language, including a build framework using gccgo and enough packages to support GPIO pins.
13 November 2020 -- Overhauled the C++ code base. Started implementing C++ Remote I/O support. Upgraded from .Net Core 3.1 to .Net 5.0.
24 November 2020 -- Made many improvements, cleanups, and reorganizations of the Remote I/O Protocol client implementations for Ada, C++, and Free Pascal.
5 December 2020 -- More improvements to the Remote I/O Protocol client implementations. Modified libhdraw to rename HIDRAW_open() to HIDRAW_open1(), HIDRAW_open_id() to HIDRAW_open()2, and add HIDRAW_open3(), which accepts as USB device serial number string in addition to the vendor and product ID's.
18 December 2020 -- Added Ada packages Posix and HID.Posix. These make it possible to build Ada Remote I/O Protocol client programs on FreeBSD and OpenBSD. The HID.Posix package very nearly works on Linux as well, except that the utterly braindead GNU implementation of strerror_r() doesn't work properly: The buf and buflen arguments are usually (but not always!) ignored. This is indefensible, but the glibc maintainers don't seem inclined to fix it. Seamless use of HID.Posix requires some operating system hotplug magic. Some implementations of same are now in hotplug/. Accordingly, udev/ has been moved to hotplug/linux/.
22 December 2020 -- Reworked the Linux hotplug scheme for raw HID devices again. Now it reuses code from the OpenBSD hotplug scheme. This allows selecting devices you want to create symbolic links for in /etc/hidraw.conf, just like MuntsOS, FreeBSD, and OpenBSD. udev rules are now installed directly to /etc/udev/rules.d/ and helper programs and scripts are installed directly to /usr/local/libexec/.

Documentation

The user manual for libsimpleio is available at UserManual.pdf.

The man pages specifying the libsimpleio API are available at libsimpleio.html.

Git Repository

The source code is available at:

https://github.com/pmunts/libsimpleio

Use the following command to clone it:


git clone https://github.com/pmunts/libsimpleio.git

Package Repository

Prebuilt packages for Debian Linux are available at:

http://repo.munts.com/debian10

Make With Ada Projects

2017 Ada Embedded Linux Framework
2019 Modbus RTU Framework for Ada (Prize Winner!)

Questions or comments to Philip Munts phil@munts.net

I am available for custom system development (hardware and software) of products using ARM Linux or other microcomputers.