.TH SMCINIT "8" "April 2004" "0.4" "Linux IrDA"
.SH NAME
smcinit \- initialize the SMSC IrDA controler on various laptops
.SH SYNOPSIS
smcinit
.B [OPTIONS]
.SH DESCRIPTION
.PP
Toshiba Satellite 1800, Satellite 5100, Tecra 9100 laptops 
and may be many other models
are provided with a SMCS LPC47N227 SuperIO chip which is IrDA SIR/FIR capable. 
The IrDA subsystem of the SuperIO chip is supported by the \fBsmc-ircc\fR Linux kernel module. 
Unfortunately the BIOS neither configurates the SuperIO chip IrDA subsystem (SIR port, FIR port, 
dma, irq, IrDA mode, power) nor sets the PCI-ISA bridge to decode any usable port.
Linux kernel is thus prevented to detect the second UART making impossible to use it 
in SIR mode. For the same reason, the FIR mode \fBsmc-ircc\fR is able to detect the SuperIO 
chip but, once found the IrDA subsystem unconfigured, fails to install.
.PP
While this problem will be fixed in Linux 2.6.x kernel series, the 2.4.x users are frustrated.
Daniele Peri, Rob Miller and Paul Hampson mananged to build little utilities
that initialize the LPC47N227 SuperIO allowing smc-ircc IrDA kernel driver 
to detect and use the SMSC chip.
.PP
My sole work was to put these utilities as one package, easy to install and use.
.SH OPTIONS
.TP 4
.B -V, --version
Show program version and exit
.TP
.B -h, --help
Show a little help on options and exit
.TP
.B -v, --verbose
Increase the details about actions performed
.TP
.B -t, --tty=device
If specified, the serial \fBdevice\fR will be unbound from the kernel stock serial driver.
It is there to replace an external call to \fBsetserial(1)\fR to unset the UART of the device.
There is no default value.
.TP
.B -s, --sirio=IO
Set the SIR (serial infrared) I/O port address to \fBIO\fR. Default
value is \fI0x3f8\fR.
.TP
.B -f, --firio=IO
Set the FIR (fast infrared) I/O port address to \fBIO\fR. Default
value is \fI0x130\fR.
.TP
.B -i, --firirq=IRQ
Set the FIR (fast infrared) IRQ line to \fBIRQ\fR. Default
value is \fI3\fR.
.TP
.B -d, --firdma=DMA
Set the FIR (fast infrared) DMA channel to \fBDMA\fR. Default
value is \fI3\fR.

.SH CONFIGURATION
.PP
When system startup a script is run from \fI/etc/init.d\fR and which run appropriate
SMC intialization utility. This is done before PCMCIA startup because on Tecra 9100
and other models the \fBorinoco_cs\fR wireless driver will block the I/O region 
used 47N227 SuperIO.
.PP
The only configuration file is \fI/etc/sysconfig/smcinit\fR and the variable SMCCONFIG
can be set to "1800" or "5100". By default "5100" value is used. 
.TP 4
.B 1800
for Toshiba Satellite 1800
.TP
.B 5100
for Toshiba Satellite 5100 and Toshiba Tecra 9100
.PP
The next step is to configure the kernel IrDA stack package to attach the smc-ircc driver.
This is Linux distribution specific. The main thing is that the device should be set to
"irda0". Run the following command:
.PP
.nf
irattach irda0 -s
.fi
.PP
Distribution specific configuration:
.TP 4
\fBSuSE\fR
Edit the \fI/etc/sysconfig/irda\fR and set IRDA_PORT=irda0 
.TP 4
\fBRedHat\fR
Edit the \fI/etc/sysconfig/irda\fR and set DEVICE=irda0 
.SH NOTES
.PP
The \fBsmc-ircc\fR driver is preloaded in kernel. I tested the package only on Tecra 9100
without any additional step, but for Toshiba Satellite 1800 Daniele Peri 
sugest to put the following line in your \fI/etc/modules.conf\fR (on one line):
.PP
.nf
options smc-ircc ircc_dma=3 ircc_irq=7 ircc_cfg=0x2e \\
        ircc_sir=0x2e8 ircc_fir=0x2f8
.fi
.PP
After that run the command:
.PP
.nf
prompt# depmod -a
.fi
.PP
If the laptop enter suspend mode, then resume operation the \fBsmc-ircc\fR driver will 
stop working. You need to stop IrDA service, then SMCINIT, start SMCINIT, and finally
start IrDA service. Simply put, the kernel driver must be unloaded, then  reloaded.
.SH FILES
.TP 4
.I /etc/sysconfig/smcinit
Configuration file for SMCINIT startup script. It's shell script. 
.SH AUTHOR
This document is made by Claudiu Costin <claudiuc@kde.org>
The utilities authors are
Daniele Peri, Rob Miller and Paul Hampson.
Thomas Pinz made improvements to \fBtosh-smcinit\fR (the former
\fBtosh5100-smcinit\fR) to expand the number of Toshiba Satellite models
supported.
.SH "SEE ALSO"
.BR smcinit (7),
.br
.BR tosh1800-smcinit (8),
.br
.BR irattach (1),
.br
.BR irdadump (1),
.br
.BR http://irda.sourceforge.net/smcinit/ " the SMCINIT package home page."