File	Date	Author	Commit
etc	2017-10-17	Jussi Eloranta	[33c055] rc.local scripts + README
examples	2017-10-20	Jussi Eloranta	[3c024f] Add comment to video-3diode about potential tim...
pi-max	2017-01-04	Jussi Eloranta	[a74a87] move sample rc.local to etc
rpi3-gpib	2017-10-25	Jussi Eloranta	[5f3000] Left a note in gpib_bitbang.c
src	2017-04-10	Jussi Eloranta	[a543d0] video4(video-3diode) replace hacks with flush.
uvc-imagingsource	2015-03-02	Jussi Eloranta	[14cc21] Some info for ImagingSource cameras.
COPYING	2011-09-30	Jussi Eloranta	[23e1fb] Initial commit.
README	2017-10-17	Jussi Eloranta	[348c8b] GPIB support for Raspberry Pi 3
TODO	2015-04-11	Jussi Eloranta	[0d367f] Added application note for src/graphics.c we ...
make.conf	2016-02-26	Jussi Eloranta	[c6006b] DG535 set function now allows for voltage offse...

Read Me

libmeas - a simplified C programming interface for research instruments (Linux).

Note: Everything here works well on Raspberry Pi 3 (with the exception of
the PVCAM camera interface, which is a proprietary PC only interface). PVCAM
is only needed for the pi-max CCD camera. Skip the pi-max related steps below
if this camera is not used.

1. Supported devices:
---------------------

See src/ directory for supported devices.

2. Compling libmeas
-------------------

2.1 Install the required external libraries (Fedora naming convention): 
   xforms-devel, libusb-devel and linux-gpib from sourceforge
   (http://linux-gpib.sourceforge.net/). There is a sample gpib config
   file in src/gpib-sample.conf, which could be placed as /etc/gpib.conf.
   Most notably the first interface is named gpib0 rather than the default
   "violet". For pi-max, you will need the freely available pvcam library
   installed in /usr/lib and /usr/include (see pi-max/). For firewire, you will
   also need to install the libraw1394-devel package. Don't forget to install the
   necessary kernel level driver for the camera. See pi-max/rc.local.

2.2 Take a look at make.conf to see if you need to change anything there.

2.3 Compile with: make

2.4 Install (as root) with: make install

2.5 For documentation look at the source files under src and examples.

2.6 To link program agaist this library use the cflags provided in
    $(ROOT)/include/meas/make.config  (i.e., use the include statement
    in your Makefile). This will define CFLAGS and LDFLAGS.

Note that many functions require root access. While I have tried to pay some
attention to security issues, this has not been my top priority. So remember
this when you make programs linked against this library and setuid root (i.e.,
chmod u+s). There are functions in misc.c to switch between normal user
and root (given the setuid permissions).

3. Documentation
----------------

Read the source ;-) This is the easiest approach as I have included 
comments there. Look also at the example applications under examples directory.

4. Copying
----------

The code is licensed according to ./COPYING with the exception of the
files under pi-max, uvc-imagingsource, and rpi3-gpib, which were written by 
others.

jmeloranta@gmail.com

5. Problems
-----------

On XFCE with Window Compositor enabled, some windows appear as transparent.
No idea yet why, disable Window Compositor (on Fedora: Settings->Window Manager
Tweaks and Compositor Tab).