redonkable
/
alistair23-linux
1
0
Fork 0
Code Releases Activity

gigaset: documentation update 

Update, correct and clarify instructions for loading the driver
and for setting the UNDOCREQ kernel configuration option.

Impact: documentation

Signed-off-by: Tilman Schmidt <tilman@imap.cc>
Signed-off-by: David S. Miller <davem@davemloft.net>
hifive-unleashed-5.1
Tilman Schmidt 2009-04-05 06:39:33 +00:00 committed by David S. Miller
parent 51370e5b21
commit c69c6d107a
1 changed files with 32 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
Documentation/isdn/README.gigaset
View File

@ -61,24 +61,28 @@ GigaSet 307x Device Driver
--------------------- ---------------------
2.1. Modules 2.1. Modules
------- -------
To get the device working, you have to load the proper kernel module. You For the devices to work, the proper kernel modules have to be loaded.
can do this using This normally happens automatically when the system detects the USB
modprobe modulename device (base, M105) or when the line discipline is attached (M101). It
where modulename is ser_gigaset (M101), usb_gigaset (M105), or can also be triggered manually using the modprobe(8) command, for example
bas_gigaset (direct USB connection to the base). for troubleshooting or to pass module parameters.
The module ser_gigaset provides a serial line discipline N_GIGASET_M101 The module ser_gigaset provides a serial line discipline N_GIGASET_M101
which drives the device through the regular serial line driver. To use it, which drives the device through the regular serial line driver. It must
run the Gigaset M101 daemon "gigasetm101d" (also available from be attached to the serial line to which the M101 is connected with the
http://sourceforge.net/projects/gigaset307x/) with the device file of the ldattach(8) command (requires util-linux-ng release 2.14 or later), for
RS232 port to the M101 as an argument, for example: example:
gigasetm101d /dev/ttyS1 ldattach GIGASET_M101 /dev/ttyS1
This will open the device file, set its line discipline to N_GIGASET_M101, This will open the device file, attach the line discipline to it, and
and then sleep in the background, keeping the device open so that the then sleep in the background, keeping the device open so that the line
line discipline remains active. To deactivate it, kill the daemon, for discipline remains active. To deactivate it, kill the daemon, for example
example with with
killall gigasetm101d killall ldattach
before disconnecting the device. before disconnecting the device. To have this happen automatically at
system startup/shutdown on an LSB compatible system, create and activate
an appropriate LSB startup script /etc/init.d/gigaset. (The init name
'gigaset' is officially assigned to this project by LANANA.)
Alternatively, just add the 'ldattach' command line to /etc/rc.local.
2.2. Device nodes for user space programs 2.2. Device nodes for user space programs
------------------------------------ ------------------------------------
@ -194,10 +198,11 @@ GigaSet 307x Device Driver
operation (for wireless access to the base), but are needed for access operation (for wireless access to the base), but are needed for access
to the M105's own configuration mode (registration to the base, baudrate to the M105's own configuration mode (registration to the base, baudrate
and line format settings, device status queries) via the gigacontr and line format settings, device status queries) via the gigacontr
utility. Their use is disabled in the driver by default for safety utility. Their use is controlled by the kernel configuration option
reasons but can be enabled by setting the kernel configuration option "Support for undocumented USB requests" (CONFIG_GIGASET_UNDOCREQ). If you
"Support for undocumented USB requests" (GIGASET_UNDOCREQ) to "Y" and encounter error code -ENOTTY when trying to use some features of the
recompiling. M105, try setting that option to "y" via 'make {x,menu}config' and
recompiling the driver.
3. Troubleshooting 3. Troubleshooting
@ -228,6 +233,13 @@ GigaSet 307x Device Driver
Solution: Solution:
Select Unimodem mode for all DECT data adapters. (see section 2.4.) Select Unimodem mode for all DECT data adapters. (see section 2.4.)
Problem:
You want to configure your USB DECT data adapter (M105) but gigacontr
reports an error: "/dev/ttyGU0: Inappropriate ioctl for device".
Solution:
Recompile the usb_gigaset driver with the kernel configuration option
CONFIG_GIGASET_UNDOCREQ set to 'y'. (see section 2.6.)
3.2. Telling the driver to provide more information 3.2. Telling the driver to provide more information
---------------------------------------------- ----------------------------------------------
Building the driver with the "Gigaset debugging" kernel configuration Building the driver with the "Gigaset debugging" kernel configuration