update readme

Author: raacampbell

README.md

@@ -1,16 +1,15 @@
 # DAQmx Examples
 <img src="https://github.com/tenss/MatlabDAQmx/blob/master/code/%2Bvidrio/%2Bsync/phase_example.jpg" />
 
-These examples show you how to interact with National Instruments devices using MATLAB.
+These examples show you how to interact with [National Instruments](http://www.ni.com) devices using [MATLAB](http://www.mathworks.com/).
 The focus is  [Vidrio's](http://scanimage.vidriotechnologies.com/display/SIH/ScanImage+Home) free [DAQmx](https://www.ni.com/dataacquisition/nidaqmx.htm) wrapper, `dabs.ni.daqmx`.
 Also supplied are some contrasting examples using The Mathworks [Data Acquisition Toolbox](https://www.mathworks.com/help/daq/). 
-Since this is already well described, there are fewer of these examples. 
 All examples require a Windows machine. 
 
 
 ### The `dabs.ni.daqmx` wrapper
-The MATLAB Data Acquisition Toolbox is the most common way of handling data acquisition in MATLAB. 
-However, with NI hardware you can also use the free `dabs.ni.daqmx` wrapper that is part of [ScanImage](http://scanimage.vidriotechnologies.com/).
+The MATLAB [Data Acquisition Toolbox](https://www.mathworks.com/products/daq.html) is the most common way of handling data acquisition in MATLAB. 
+However, with NI hardware you can also use the free `dabs.ni.daqmx` wrapper that is part of [ScanImage](http://www.vidriotechnologies.com/).
 This is a thin, object-oriented wrapper that provides access to almost the full DAQmx API.
 
 In addition to `dabs.ni.daqmx`, ScanImage also supplies an [FPGA](http://www.ni.com/fpga/) interface wrapper (`dabs.ni.rio`) which can be used to run a [bitfile](http://www.ni.com/white-paper/9640/en/) compiled using LabVIEW FPGA on any [NI RIO](http://www.ni.com/academic/students/learn-rio/what-is/) FPGA target. 
@@ -22,15 +21,15 @@ This currently supports only a small subset of the NI VISA API.
 This repository contains a bunch of NI DAQmx examples using both the MATLAB DAQ toolbox and the `dabs.ni.daqmx` wrapper. 
 The examples provided here overlap with those provided by Vidrio in `dabs.ni.daqmx.demos`, but are more up to date and more extensively commented. 
 The `DAQmx_ANSI_C_examples` directory is for convenience and contains copies of some of the examples installed along with DAQmx.
-Some examples use more advanced MATLAB features, these are covered by example code in the `basicConcepts` directory. 
+The `basicConcepts` directory illustrates some of the more advanced programming concepts which crop up. 
 
 
 ## Installation
 
 * Download [ScanImage](http://scanimage.vidriotechnologies.com/display/SIH/ScanImage+Home) and add its root directory to your MATLAB path.
-* Install the supported version of DAQmx. For example, ScanImage 5.2 [requires v15.5](http://scanimage.vidriotechnologies.com/display/SI2016/Software+Version+Compatibility)
+* Install the supported version of DAQmx. For example, ScanImage 5.2 [requires v15.5](http://scanimage.vidriotechnologies.com/display/SI2016/Software+Version+Compatibility).
 * Add the examples in this repository to your path or `cd` to the `code` directory to run the examples.
-* You may [create simulated devices](http://www.ni.com/tutorial/3698/en/) in [NI MAX](http://digital.ni.com/public.nsf/allkb/71544521BDE34FFB86256FCF005F4FB6) to run with the examples on a machine with no NI hardware connected. 
+* You may [create simulated devices](http://www.ni.com/tutorial/3698/en/) in [NI MAX](http://digital.ni.com/public.nsf/allkb/71544521BDE34FFB86256FCF005F4FB6) to run the examples on a machine with no NI hardware connected. 
 Triggers do not work in simulated mode: they fire immediately.
 Simulated mode also works in a virtual machine. 
 
@@ -47,10 +46,11 @@ For each example, first look at the help text (e.g. `help vidrio.AO.softwareTime
 ```
 
 There are further comments in-line so open the example in an editor to learn more.
-Example have been tested with an NI PCI-6229. 
-Many have also been verified to work with a simulated NI PCIe-6341. 
-You may get errors with certain combinations of cards and examples. 
-e.g. With a PCI-6115 certain buffered examples will complain that the sample rate is too low. 
+Examples have been tested with an NI [PCI-6229](http://www.ni.com/en-us/support/model.pci-6229.html) and [PXIe-6341](http://www.ni.com/documentation/en/pxi-multifunction-io-module/latest/pxie-6341/overview/). 
+Many examples have also been verified to work with a simulated NI PCIe-6341. 
+Not all examples work on all boards (e.g. the [re-triggerable example](https://github.com/tenss/MatlabDAQmx/blob/master/code/%2Bvidrio/%2Bmixed/DO_retriggerable.m) requires an [X-Series board](http://www.ni.com/xseries/)). 
+You may simply get errors with certain combinations of cards and examples. 
+e.g. With a PCI-6115, certain buffered examples will complain that the sample rate is too low so you will need to modify this. 
 
 
 ## Key Contents
@@ -78,7 +78,7 @@ e.g. With a PCI-6115 certain buffered examples will complain that the sample rat
 * `vidrio.mixed.AOandAI_OO` - Interactive continuous AI and AO using object-oriented programming.
 * `vidrio.mixed.AOandAI_OO_sharedClock` - Interactive continuous AI and AO with shared clock between AO and AI.
 * For retriggerable tasks see `vidrio.mixed.DO_retriggerable` and `vidrio.mixed.AO_retriggerable`
-
+* `vidrio.sync` is a demo package showing how to synchronise two DAQ devices and why you need to do so. 
 
 ### Hints
 The use of `try`/`catch` blocks should ensure the DAQmx tasks always shut down cleanly. 
@@ -90,7 +90,7 @@ If they do not:
 * [Using NI-DAQmx in Text Based Programming Environments](http://www.ni.com/tutorial/5409/en/)
 * [DAQmx C Reference help](http://zone.ni.com/reference/en-XX/help/370471AE-01/) and [C functions listing](http://zone.ni.com/reference/en-XX/help/370471AE-01/TOC3.htm)
 * Vidrio DAQmx [docs](http://scanimage.vidriotechnologies.com/display/API/Hardware+Support+Package+%28dabs%29+-+ni+-+daqmx) and [demos](http://scanimage.vidriotechnologies.com/display/API/Hardware+Support+Package+%28dabs%29+-+ni+-+daqmx+-+demos)
-
+* See [SimpleMScanner](https://github.com/tenss/SimpleMScanner) for basic 2-photon scanning software written using the techniques shown here. 
 
 ### DAQmx in other languages
 * [PyDAQmx](https://pythonhosted.org/PyDAQmx/index.html)