1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
|
********************************************************************************
* USB TC-08 Linux Driver Source *
* Pico Technology Ltd *
********************************************************************************
Installation instructions for the Pico Technology USB TC08 Linux Driver
-----------------------------------------------------------------------
Prerequisites:
1. Your system must be set up in such a way that all users who need to use
the driver have write access to the USB device. The details of this may be
system-specific - some possible scenarios are covered below.
- Many modern systems are preconfigured with a group "usb" to which
automatically-created USB device nodes belong. In this case, all
you need do is add the relevant users to the "usb" group.
- On other systems running udev, you should create a custom rules file
which sets the permissions on the relevant devices and copy it to
/etc/udev/rules.d/ . There is an example rules file which includes
detailed instructions on how to set this up in 95-pico.rules.
- It is likely to be possible to use the driver with non-udev based
systems (for example, older Linux systems) but we have not tested
this and cannot provide any support if you attempt to do so.
2. Your system will need to be set up to allow you to build C and C++ programs.
Specifically you will need relevant toolchains and standard libraries. You
will also need the tar and gzip programs to extract the source code. All
these programs form part of any Linux distribution, but they may not always
be installed by default. The configure script should detect whether you
have the necessary tools and inform you of any problems.
3. If you intend to make changes to the driver you may also need additional
software such as the GNU autotools. The driver has been developed using the
Eclipse IDE which we have found to be an excellent graphical development
environment.
Installation:
1. Extract the tar archive:
tar zxf libtc08-version.tgz
2. Change into the directory into which you extracted the archive:
cd libtc08-version
3. Run the configure script:
./configure
This will check that you have the required prerequisites and set up the
build process for your system. If you intend to use the driver for debugging,
you may want to specify CXXFLAGS like this:
./configure CXXFLAGS="-g -O0"
to enable debug symbols (-g) and turn off optimization (-O0).
4. Build the software:
make
5. Install the software. As root:
make install
The library and header files are installed by default under /usr/local. You
should ensure that /usr/local/lib appears in /etc/ld.so.conf and then run:
ldconfig
to add the new library to the system cache. You are now ready to start using
the library in your programs (or why not start by taking a look at our
example programs?).
Notes:
The driver has been tested on Gentoo Linux, Kubuntu 8.04, openSuse 10.3 and on
Fedora 8. It should however work on all systems meeting the requirements above.
Pico Technology only distributes this driver in source code form. If you
have obtained a binary version of the driver from a third party (for example, a
.deb or .rpm file) you should contact the supplier for installation support.
|