|
|
ReadMe file for the
Intel?MD563X-HaM V.92 chipset Linux driver
contents:
1. License
2. Release Notes
3. Installation
4. File Descriptions
5. International Users
6. Beta Tester appreciation
7. Security issues
8. Compilation issues
a. Instructions for Debian Users
b. Kernel Source
9. Comments, ideas, problems, fixes
内容:
1. 许可证
2. 发行注释
3. 安装
4. 文件说明
5. 国际用户
6. 对测试用户的感谢
7. 安全手册
8. 编辑手册
a. Debian用户的安装帮助
b. 内核源代码
9. 评论,想法,问题,修正
---------------------------------------------------------------------------------
1. LICENSE
IMPORTANT - read the file "LICENSE.txt" for the INTEL SOFTWARE LICENSE AGREEMENT
BEFORE COPYING, INSTALLING OR USING.
also note:
The serial driver open source code located in the directory "serialdrv"
is work covered under the GNU GENERAL PUBLIC LICENSE (GPL).
The "serialdrv" directory has the GPL in the file "GPL.txt".
1. 许可证
注意(重要的)-在复制,安装或者使用(本软件)之前阅读"LICENSE.txt"文档,以便于接受INTEL的软件许可证.
另外注意:
位于目录"/serialdrv"下的串行设备的开源代码遵守GPL(软件许可协议).
GPL(的详细内容)位于"serialdrv"目录下的"GPL.txt"文件内.
---------------------------------------------------------------------------------
2. Release Notes
17 August 2001:
2. 发行注释
2001年8月17日
!!!!!!!!!!! you must completely uninstall previous linux HaM driver files.
!!!!!!!!!!! especially /etc/hamregistry.bin and /etc/linhamreg.bin
!!!!!!!!!!! 你必须彻底卸载以前的linux HaM驱动文件.
!!!!!!!!!!! 特别是 /etc/hamregistry.bin和/etc/linhamreg.bin
This PRE release supports 2.4.x kernels.
这个预览发行版支持2.4.x版内核.
THIS IS A PRE RELEASE WITH SUPPORT FOR 2.4.X KERNELS!
THERE ARE NO GUARANTEES THAT THIS
DRIVER WILL WORK WITH YOUR LINUX DISTRIBUTION
OR KERNEL VERSION AT THIS TIME.
这是一个支持2.4.x版内核的预览发行版!
对于这个驱动能在你的linux发行套件或者内核版本上正常工作不提供担保.
THE 412-2 CORECODE BINARY WAS COMPILED IN MANDRAKE 8.0.
412-2核心代码二进制包是在MANDRAKE 8.0上编译的.
THE CURRENT LIST OF DISTRIBUTIONS THAT I HAVE
TESTED AND SEEN TO WORK WITH THIS
DRIVER ARE THE FOLLOWING:
* Mandrake 8.0 with Linux HaM version 412-2 and kernel 2.4.3-20mdk
* Redhat 7.1 with Linux HaM version 412-2 and kernel 2.4.2-2
/usr/src/linux symbolic link to kernel source must
be created for the driver to compile
我测试过并且看到能使这个驱动工作的发行套件列表如下:
* Mandrake 8.0 带有 412-2版的Linux HaM以及2.4.3-20mdk版的内核
* Redhat 7.1 带有 412-2版的Linux HaM以及2.4.3-2版的内核
为了编译驱动必须在/usr/src/linux和内核源代码之间创建一个软链接.(也就是说如果使用RH8的话,必须要打上内核源代码,在第二张安装光盘上可以找到内核源代码的rpm包,把它安装上,大约250M左右,然后用命令创建一个链接 #ln -s /usr/src/linux-2.4.18-14 /usr/src/linux)
UNVERIFIED WITH 408-2 AT THIS TIME, BUT LIKELY COMPATIBLE:
* SuSE 7.1 with both 2.2 and 2.4 kernels.
* SuSE 7.0
* Redhat 7.0
* reports of 408 ham working on Debian with 2.4 kernel
带有408-2不能确定,但是很可能兼容的(发行套件):
* SuSE 7.1 使用2.2以及2.4版本内核.
* SuSE 7.0
* Redhat 7.0
* 使用2.4版内核的Debian
VERIFIED AS INCOMPATIBLE AT THIS TIME:
* Caldera eDesktop 2.4 (with kernel 2.2.14)
many compile warnings from kernel headers.
no at OK response from modem,
no "/etc/caldera-release" need for distrabution indentification
已经确定无法兼容的(发行套件):
* Caldera eDesktop 2.4(使用2.2.14版内核)
大量编译警告来自于内核头文件.
没有"/etc/caldera-release"这个文档被用来确定发行套件.(这句翻的不太对劲)
YOU MAY STILL FIND PROBLEMS ON THESE TESTED VERSIONS.
IF YOU DO, EMAIL ME (see end of this readme, section 9),
SO THAT I MAY FIX IT.
在这些已经测试过的版本上,你可能仍旧会发现一些问题.
如果你发现问题了,发email给我(看reame的结尾处,第九部分)以便于我可以修正它.
THIS LIST WILL GROW AS MY TESTING CONTINUES AND WITH
FEEDBACK FROM LINMODEM USERS, TESTERS, AND VENDORS.
这个清单将随着测试的继续以及来自于linux Modem的使用者,测试者和出售者的反馈(信息)而增长.
---------------------------------------------------------------------------------
3. INSTALLATION
3. 安装
Prerequisites:
1. root access
2. bash shell to run install scripts
3. a HaM modem
4. kernel source for the kernel you are running
/usr/src/linux must symbolically point to this source
for the makefiles to work.
必要准备:
1. root 权限
2. 用来运行安张脚本的shell--bash
3. 一个HaM 猫
4. 你正在使用的内核的源代码
为了使makefiles工作,必须把/usr/src/linux链接到内核源代码.(这个问题很重要,我已经在前面的部分仔细说明了,如果缺少这步,就不能正常make,那么驱动程序也将无法安装.)
6 steps to install
1. login as ROOT
2. extract the archive into a directory with "tar -xvf <archivename>.tgz"
3. cd into the the directory it created.
4. Type: make clean
5. Type: make all
6. Type: make install
6步安装
1. 作为root登陆
2. 使用(命令)"tar -xvf <archivename>.tgz"把压缩文档解压到一个目录.
3. 用cd命令进入这个文档(解压后)生成的目录.
4. 键入(命令):make clean
5. 键入(命令):make all
6. 键入(命令):make install
The installation script has been designed for the following distributions release versions
mandrake-release
SuSE-release
redhat-release
debian_version (including Corel)
slackware-version
conectiva-version
bluepoint-release
Unknown distributions install modules and utilities but
will not install boot scripts!.
这个安装脚本是为以下发行套件设计的:
mandrake-release
SuSE-release
redhat-release
debian_version (including Corel)
slackware-version
conectiva-version
bluepoint-release
安装了模块和工具但是没有安装引导脚本的未知发行套件!
Please examine the haminst script if you have a different distribution.
如果你有一个不同的发行套件,请检查这个haminst(不知道何意)脚本.
The driver is split in two. A ham serial driver and core driver.
The core driver must be loaded first since the serial driver depends on it.
The serial driver registers itself as character device major number 240, minor number 1.
The serial driver takes one argument right now, which is a number to override the default major number if you need to.
驱动分为两部分.ham串行驱动和核心驱动.
核心驱动必须被首先加载,因为串行驱动依赖它.
串行驱动将把自己作为一个主要（较大的）数字为240，次要（较小的）数字为1的设备注册。
ATTENTION: if the driver compiles but the script just wont work for you.
Here are the bare minimum steps to get your modem to work.
0. log in as root.
1. insmod -f hamcore.o
2. insmod -f ham.o
2a. you can start "hamregistry" at this point if you wish.
3. rm /dev/ham
4. mknod /dev/ham c 240 1 (note "240" is the default, if it does not work see what /proc/devices says ham's major number is)
5. ln -s /dev/ham /dev/modem
6. start a comm application like minicom and use the modem.
7. see section 3 (International Users) for info on setting the correct country settings.
注意:如果这个驱动被编译了但是这个脚本仍然不能工作,这是少见的最少步骤为了让你的猫工作.
0. 用root身份登陆.
1. (使用命令)insmod -f hamcore.o (强行把hamcore.o移入内核)
2. (使用命令)insmod -f ham.o
2a. 这时如果你愿意的话你可以开始"hamregistry".
3. (使用命令)rm /dev/ham
4. (使用命令)mknod /dev/ham c 240 1 (注意"240"是默认的,如果这个数值不工作,看看/proc/devices说ham的主要数值是多少)
5. (使用命令)ln -s /dev/ham /dev/modem
6. 运行一个比如minicom(这是一个工作在shell下的拨号软件,不过我个人更喜欢使用wvdial,因为后者能自动处理整个拨号过程)之类的一般应用(程序),开始使用你的猫.
7. 参看第三部分(国际使用者)为了设置正确的国家.
---------------------------------------------------------------------------------
4. FILE DESCRIPTIONS
4. 文件说明
haminst installation script to install HaM modules and supporting files
haminst 安装脚本是为了安装HaM模块以及支持文件.
files copied to /lib/modules/(kernel-version)/misc
hamcore.o driver core code module
ham.o pseudo serial driver for HaM, depends on hamcore.o
几个文件被复制到/lib/modules/(kernel-version)/misc下,
hamcore.o是驱动核心代码模块,
ham.o是HaM的无效串行驱动,要依赖hamcore.o
files copied to /etc/rc.d/... (path differes per distribution)
hamboot boot scrip to start and stop HaM modules
复制到/etc/rc.d/...（目录下）的文件中（这个路径根据发行套件的不同而有所不同）
hamboot(这个)引导脚本将会启动和停止HaM模块。
files copied to /usr/sbin
hamregistry hamregistry is the "registry" like tool that the modem uses to get and store persistant data
such as county info and profile strings.
复制到/usr/sbin/(目录下)的文件中,
hamregistry是一个"注册表",它就像一个工具,猫用它来获取和保存固定（不经常改变的）数据，比如国家信息和简单描述。
files copied to /etc
linhamreg.bin file that stores the initial persistant data for modem.
复制到/etc(目录下)的文件中
linhamreg.bin文件保存着猫初始化时的永久数据.
---------------------------------------------------------------------------------
5. INTERNATIONAL USERS
5. 国际使用者
hamregistry will store the last country setting you
set in the modem.
hamregistry文件将保存你在猫中设置的最后一次国家设定.
in minicom (or equivalent comm application)
the commmand to change country setting is "AT+GCI="
the command takes a t.35 country code in hexadecimal.
below is a list of currently supported t.35 country codes.
you can also put this "AT" command in the init string of
the comm application you are using.
在minicom(或者是诸如此类的普通应用)中,用来改变国家设定的命令是"AT+GCI=" ,这个命令把一个t.35国家码放在了hexadecimal中.
下面是一个现在的支持t.35国家码的清单,你也可以把这个"AT"命令(即AT+GCI=)放入你正在使用的普通应用的初始串中.
if you are a CTR-21 country I think you should be able to
choose a CTR-21 country on the list and be ok. but
that's no guarantee.
The same goes for countries that are "USA" compatable.
如果你在一个CTR-21国家，我想你应该能够在列表中选择一个CTR-21国家并且没问题。但是那也不是百分之百的。
同样的目标为了那些与美国兼容的国家.(不知道什么意思)
country code , t.35 code
---------------------------
USA 1 B5
ARG 54 07
AUS 61 09
AUT 43 0A
BEL 32 0F
BOL 591 14
BRA 55 16
CHE 41 A6
CHL 56 25
CHN 86 26
COL 57 27
CYP 357 2D
DEU 49 42
DNK 45 31
DOR 47 82
ECU 593 35
ESP 34 A0
FIN 358 3C
FRA 33 3D
GBR 44 B4
GRC 30 46
HKG 852 50
IDN 62 54
IND 91 53
IRL 753 57
ISL 354 52
ISR 972 58
ITA 39 59
JPN 81 00
KOR 82 61
LIE 423 68
LUX 352 69
MEX 52 73
MYS 60 C3
NLD 31 7B
NOR 47 82
NZL 64 7E
PAK 92 84
PAN 507 85
PER 51 88
PHL 63 89
PRT 351 8B
RUS 7 B8
SAU 966 98
SGP 65 9C
SWE 46 A5
THA 66 A9
TUR 90 AE
TWN 886 26
VNM 84 BC
注:以下内容对安装帮助不大顾省略,如有特殊需要再联系我.
---------------------------------------------------------------------------------
6. Thanks to the following beta testers for their valuable input and suggestions
during the HaM 333 beta test between January 2 - 26, 2001
Sean Walbran
Rob Clark
Marvin Stodolsky
Dominique Duval
Roman Krais
Ulrich Guenther
Marcelino Viana Pinheiro
Thomas S. Iversen
Jospeh Teichman
Michel Bartolone (MED)
Ramon Gonzalez Montoiro
Ryoji Kawagishi
Torsten Vogel
"jandro"
Ian Carr-de Avelon
Helga Weindl
Ed Casas
Bernhard Hoelcker
Alexander "Sasha" Voytov
Albert Woo
Peter Hirschmann
and all of the helpful Linux HaM users
around the world and at www.linmodems.org
---------------------------------------------------------------------------------
7. Security issues
the haminst and hamboot file install the files and device nodes as
root for the owner and group.
this will cause problems for those who want to user the modem to dialout
using an account other than root.
In SuSE, "dialout" is the group used to install the files and device node.
This way, anyone belonging to the "dialout" group can use the modem to dialout.
(take a look at /etc/group)
I did not want the script to allow full access of the modem to everyone without
"root" knowing.
Edit the hamboot and haminst scripts to fit your needs.
---------------------------------------------------------------------------------
8. Compile issues
a. DEBIAN USERS!
the file /usr/include/linux/modversions.h does not exist in debian 2.2
you must comment out the #include<linux/modversion.h> line from both
hamdefs.h files in the HaM source code for it to compile.
b. You will need the kernel source that you are compiling the module for.
some distributions do not automatically install all the neccisary
kernel headers in a default installation. The makefiles look for
the directory "/usr/src/linux/include/linux". "/usr/src/linux" is
a symoblic link to the kernel source you wish to use. Most distributions
should have an available archived kernel source for the kernel version
they are using. Please read the documentation provided with the kernel
source as it is a very importaint part of what "linux" is all about.
If you feel comfortable with compiling the driver with the system header
files in "/usr/include", modifiy the makefile's include paths to point
to "/usr/include" instead of "/usr/src/linux/include"
please refer to article:
http://linmodems.org/cgi-bin/ezmlm-cgi?1:mss:3785:200105:pdfckkcmemhofipa
for more information concering the "kernel source" issue.
---------------------------------------------------------------------------------
9. Comments, ideas, problems, fixes:
please contact
Dorian S. Araneda
Product Engineer,
Intel Residential Access Division (RAD)
http://developer.intel.com/design/modems/
www.intel.com www.intc.com (ticker: INTC)
110 Horizon Dr., Suite 300, Raleigh, NC 27615
other resources and information on linux controllerless modems can be found on
www.linmodems.org |
|
IP卡
狗仔卡
发表于 2003-1-11 00:57:43
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
显身卡