File: readme

package info (click to toggle)
adv-17v35x 5.0.3.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 224 kB
  • sloc: ansic: 3,845; makefile: 44
file content (159 lines) | stat: -rw-r--r-- 6,905 bytes parent folder | download
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
=============================================================================

        Advantech PCIe Multiport Device Driver Ver 5.0.3.0 Installation Guide
         for Linux Kernel 2.6.9 and newer (Tested on various kernels from 
         2.6.9 to 4.2.x)
			Copyright (C) 2017, Advantech.
=============================================================================

Changes log:
Version 5.0.3.0 <2017-03-06>
    - Add fixed number;
    - Add a parameter to enable/disable internal loopback;
    - Add non-standard baud rates support;
    - Improve Software flow control and Hardware flow control behavior;
    - Support kernel 2.6.9;

Version 5.0.2.0 <2016-08-29>
    - Support kernel up to 4.2.x;
    - Fix data error issue on Fedora 21/23;

Version 5.0.1.0 <2015-08-28>
    - Original version


-----------------------------------------------------------------------------
1. Introduction

    The PCI/PCIe Multiport serial driver Ver 5.0.3.0, supports the following 
    multiport boards.

        - PCIE-1602 PCIe Multiport (2 Channels) Boards
        - PCIE-1604 PCIe Multiport (2 Channels) Boards
        - PCIE-1610 PCIe Multiport (4 Channels) Boards
        - PCIE-1612 PCIe Multiport (4 Channels) Boards
        - PCIE-1620 PCIe Multiport (8 Channels) Boards
        - PCIE-1622 PCIe Multiport (8 Channels) Boards
        - PCM-3612I PCM  Multiport (4 Channels) Boards
        - PCI-1602  PCI  Multiport (2 Channels) Boards
        - PCI-1604  PCI  Multiport (2 Channels) Boards
        - PCI-1610  PCI  Multiport (4 Channels) Boards
        - PCI-1612  PCI  Multiport (4 Channels) Boards
        - PCI-1620  PCI  Multiport (8 Channels) Boards
        - PCI-1622  PCI  Multiport (8 Channels) Boards

    This driver and installation procedure have been tested on various
    kernel versions from 2.6.9 to 4.2.x.
    
    All the drivers and utilities are published in form of source code under
    GNU General Public License in this version. Please refer to GNU General
    Public License announcement in each source code file for more detail.
    
    This version of driver can be installed as Loadable Module (Module driver)
    or built-in into kernel (Static driver). You may refer to following
    installation procedure for suitable one. Before you install the driver,
    please refer to hardware installation procedure in the User's Manual.
    
    We assume the user should be familiar with following documents.
    - Serial-HOWTO
    - Kernel-HOWTO
   
-----------------------------------------------------------------------------
2. System Requirement

    - Hardware platform: Intel x86
    - Kernel version: 2.6.9 or newer
    - Maximum of 256 ports can be installed in any PCI/PCIe board combination
    - This driver has been tested on various kernel versions from 2.6.9 to 
      4.2.x.  
   
      It is tested in follow systems:
        +--------------------------------+--------------------------------+
        |    Distribution                |  kernel version                |
        +--------------------------------+--------------------------------+
        |	Red Hat Enterprise 4.3 32    |  2.6.9-34                      |
        |	Red Hat Enterprise 5.5 32    |  2.6.18-194.el5PAE             |
        |	Red Hat Enterprise 6.1 64    |  2.6.32-131.0.15.el6.x86_64    |
        |	Red Hat Enterprise 7.0 64    |  3.10.0-123.el7.x86_64         |
        |	Red Hat Enterprise 7.2 64    |  3.10.0                        |
        |	Ubuntu 10.04 32              |  2.6.32-21-generic             |
        |	Ubuntu 12.04 64              |  3.2.0-23-generic              |
        |	Ubuntu 14.04 64              |  3.13.0-24-generic             |
        |	Ubuntu 15.10 32              |  4.2                           |
        |	Fedora 20    64              |  3.11.10-301.fc20.x86_64       |
        |	Fedora 23    32              |  4.2.3                         |
        |	Debian 8.4   32              |  3.16.0                        |
        +--------------------------------+--------------------------------+

    It is strongly recommended that the user do a complete install of all 
    components to ensure that this driver works correctly.

-----------------------------------------------------------------------------
3. Installation
   
    3.1. Login as 'root' before executing the following instructions.
    
    3.2. Uncompress the driver
    # tar zxvf adv_17V35X-VerX.tar.gz
    
    3.3. Build the driver
      # cd adv_17V35X-VerX
      # make
    Note: 
      To compile the source code, you must install kernel development header 
      file package,"gcc" and "make" command.
    
    3.4. Install the driver module
    # make install
    to see whether ttyAPn ( n = 1,2,3...) exist in /dev/ folder,      
    or      
    #insmod ./adv17v35x.ko
    
    3.5. Uninstall the driver module and clean
    # make uninstall
    # make clean
    or 
    #rmmod adv17v35x
    
    3.6 Verify driver installation
    You may run command "dmesg" to check the latest status
    log reported by this driver whenever it's activated.
    
    This module registers Advantech ports as "/dev/ttyAP0", "/dev/ttyAP1", etc. 
    Use "minicom" or your custom serial application to test the ports       
    
    Attention! The name of PCIE-16XX ports are the same as Old cards which use 
    Oxford chip, so don't use them at the same time.  
-----------------------------------------------------------------------------
4. Driver files and device naming convention
   
    The driver file may be obtained via email. The first step, anyway, is to
    copy driver file "adv_17V35X-VerX" into specified
    directory. e.g. /advantech. The execute commands as below.
    
    # cd /advantech/adv_17V35X-VerX
     
    You may find the driver source code in /advantech/adv_17V35X-VerX.
    
    Driver creates traditional serial device names, "/dev/ttyAP0" onwards.
    
    Device naming when multiple boards are installed
    -----------------------------------------------
    assuming 2 PCIE-1602 boards, 1 PCIE-1610 board and
    1 PCIE-1622 board.
    
    Board Num.	            Port Name
    1st board (1602)	    ttyAP0  - ttyAP1
    2nd board (1602)	    ttyAP2  - ttyAP3
    3rd board (1610)	    ttyAP4  - ttyAP7
    4th board (1622)	    ttyAP8  - ttyAP15
    
    Note. We don't know which card be found first, maybe 1602, or 1610, or 
    1622. This depends on the sequence that operating system scanning. 
 
----------------------------------------------------------------------------- 
5. Troubleshooting
   
    The boot time error messages and solutions are stated as clearly as
    possible. If all the possible solutions fail, please contact our technical
    support team to get more help.