File: INSTALL

package info (click to toggle)
libusbtc08 1.7.2-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 2,288 kB
  • sloc: cpp: 10,962; sh: 9,130; ansic: 98; makefile: 70
file content (71 lines) | stat: -rw-r--r-- 3,435 bytes parent folder | download | duplicates (2)
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.