Intel PRO/Wireless 2100 Driver

IPW2100 문서 정보와 목차

이 문서는 `GPL-2.0` 라이선스를 따릅니다.

Linux용 Intel(R) PRO/Wireless 2100 드라이버

지원 장치: Intel(R) PRO/Wireless 2100 Network Connection.

Copyright 2003-2006 Intel Corporation.

`README.ipw2100`, 버전 `git-1.1.5`, 2006년 1월 25일.

목차는 사용 전 중요 정보, 소개, 현재 지원 기능, 명령줄 parameter, sysfs helper file, radio kill switch, dynamic firmware, power management, 지원, 라이선스를 다룹니다.

.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>

===========================================
Intel(R) PRO/Wireless 2100 Driver for Linux
===========================================

Support for:

- Intel(R) PRO/Wireless 2100 Network Connection

Copyright |copy| 2003-2006, Intel Corporation

README.ipw2100

:Version: git-1.1.5
:Date:    January 25, 2006

.. Index

    0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER
    1. Introduction
    2. Release git-1.1.5 Current Features
    3. Command Line Parameters
    4. Sysfs Helper Files
    5. Radio Kill Switch
    6. Dynamic Firmware
    7. Power Management
    8. Support
    9. License

규제 준수에 관한 중요 고지

0. 이 드라이버 사용 전 중요 정보

모든 사용자와 배포자를 위한 중요 고지입니다.

Intel wireless LAN adapter는 출하 대상 지역의 지방 및 정부 규제 기관 요구 사항을 충족하도록 설계, 제조, 시험, 품질 검사됩니다.

wireless LAN은 radar, satellite, 기타 허가·비허가 장치와 spectrum을 공유하는 비허가 장치인 경우가 많습니다. 따라서 간섭을 피하려면 사용 환경을 동적으로 감지하고, 회피하고, 사용을 제한해야 할 수 있습니다.

제품 사용 인증이나 승인을 받기 전에 Intel이 지역·지방 규제 준수를 입증하는 시험 데이터를 제공해야 하는 경우가 많습니다.

Intel wireless LAN의 EEPROM, firmware, software driver는 radio 동작에 영향을 주는 parameter를 세밀하게 제어하고 EMC를 보장하도록 설계되었습니다. 대상에는 RF power, spectrum 사용, channel scanning, 인체 노출 등이 포함됩니다.

이런 이유로 Intel은 wireless LAN adapter와 함께 binary 형식으로 제공하는 software, 예를 들어 EEPROM과 firmware를 제3자가 조작하는 것을 허용할 수 없다고 설명합니다.

Intel이 검증하지 않은 patch, utility, code 또는 open source code 수정본을 사용하면 제품의 규제 준수를 보장할 책임은 사용자에게 있습니다.

Intel은 보증 청구와 규제 미준수 문제를 포함해 수정된 제품과 관련된 문제에 책임을 지지 않으며, 해당 제품에 대해 제3자 지원을 제공하거나 지원 제공을 도울 의무도 없다고 고지합니다.

많은 규제 기관은 wireless LAN adapter를 module로 간주합니다. 따라서 antenna와 system 구성이 EMC 및 radio 동작 규정을 위반하지 않는다는 시험 자료를 검토한 뒤 system-level 승인을 내릴 수 있습니다.

SourceForge에서 내려받는 드라이버는 개발 프로젝트의 일부입니다. 지방 규제 요구 사항 준수는 개별 개발자의 책임입니다.

개발 이외의 목적으로 배포하거나 제품에 포함하려면 원문은 Intel Customer Support의 시험된 드라이버를 사용하라고 안내합니다. 기록된 주소는 `https://www.intel.com/support/wireless/sb/CS-006408.htm`이며 현재 유효성은 별도로 확인해야 합니다.

0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER
=================================================

Important Notice FOR ALL USERS OR DISTRIBUTORS!!!!

Intel wireless LAN adapters are engineered, manufactured, tested, and
quality checked to ensure that they meet all necessary local and
governmental regulatory agency requirements for the regions that they
are designated and/or marked to ship into. Since wireless LANs are
generally unlicensed devices that share spectrum with radars,
satellites, and other licensed and unlicensed devices, it is sometimes
necessary to dynamically detect, avoid, and limit usage to avoid
interference with these devices. In many instances Intel is required to
provide test data to prove regional and local compliance to regional and
governmental regulations before certification or approval to use the
product is granted. Intel's wireless LAN's EEPROM, firmware, and
software driver are designed to carefully control parameters that affect
radio operation and to ensure electromagnetic compliance (EMC). These
parameters include, without limitation, RF power, spectrum usage,
channel scanning, and human exposure.

For these reasons Intel cannot permit any manipulation by third parties
of the software provided in binary format with the wireless WLAN
adapters (e.g., the EEPROM and firmware). Furthermore, if you use any
patches, utilities, or code with the Intel wireless LAN adapters that
have been manipulated by an unauthorized party (i.e., patches,
utilities, or code (including open source code modifications) which have
not been validated by Intel), (i) you will be solely responsible for
ensuring the regulatory compliance of the products, (ii) Intel will bear
no liability, under any theory of liability for any issues associated
with the modified products, including without limitation, claims under
the warranty and/or issues arising from regulatory non-compliance, and
(iii) Intel will not provide or be required to assist in providing
support to any third parties for such modified products.

Note: Many regulatory agencies consider Wireless LAN adapters to be
modules, and accordingly, condition system-level regulatory approval
upon receipt and review of test data documenting that the antennas and
system configuration do not cause the EMC and radio operation to be
non-compliant.

The drivers available for download from SourceForge are provided as a
part of a development project.  Conformance to local regulatory
requirements is the responsibility of the individual developer.  As
such, if you are interested in deploying or shipping a driver as part of
solution intended to be used for purposes other than development, please
obtain a tested driver from Intel Customer Support at:

https://www.intel.com/support/wireless/sb/CS-006408.htm

소개와 지원 기능

1. 소개

이 문서는 IPW2100 드라이버 프로젝트가 지원하는 기능을 간략히 설명합니다. 최신 개발 버전, 잠재적 수정과 patch, 개발 mailing list 링크는 당시 프로젝트 사이트 `http://ipw2100.sourceforge.net`에서 제공되었습니다.

2. `git-1.1.5` release의 현재 지원 기능

802.1x는 XSupplicant 1.0.1로 시험되었습니다. 공식 지원과 활성화 기능의 차이는 해당 기능에 수행한 validation과 interoperability 시험의 양을 반영합니다.

1. Introduction
===============

This document provides a brief overview of the features supported by the
IPW2100 driver project.  The main project website, where the latest
development version of the driver can be found, is:

        http://ipw2100.sourceforge.net

There you can find the not only the latest releases, but also information about
potential fixes and patches, as well as links to the development mailing list
for the driver project.


2. Release git-1.1.5 Current Supported Features
===============================================

- Managed (BSS) and Ad-Hoc (IBSS)
- WEP (shared key and open)
- Wireless Tools support
- 802.1x (tested with XSupplicant 1.0.1)

Enabled (but not supported) features:
- Monitor/RFMon mode
- WPA/WPA2

The distinction between officially supported and enabled is a reflection
on the amount of validation and interoperability testing that has been
performed on a given feature.

명령줄 module parameter

3. 명령줄 parameter

드라이버를 module로 빌드했다면 다음 형식으로 선택 parameter를 `modprobe` 명령줄에 넣습니다.

modprobe ipw2100 [<option>=<VAL1><,VAL2>...]

드라이버 적재 시 radio를 끄는 예는 다음과 같습니다.

modprobe ipw2100 disable=1

3. Command Line Parameters
==========================

If the driver is built as a module, the following optional parameters are used
by entering them on the command line with the modprobe command using this
syntax::

        modprobe ipw2100 [<option>=<VAL1><,VAL2>...]

For example, to disable the radio on driver loading, enter:

        modprobe ipw2100 disable=1

The ipw2100 driver supports the following module parameters:

=========        ==============        ============  ==============================
Name                Value                Example       Meaning
=========        ==============        ============  ==============================
debug                0x0-0xffffffff        debug=1024    Debug level set to 1024
mode                0,1,2                mode=1        AdHoc
channel                int                channel=3     Only valid in AdHoc or Monitor
associate        boolean                associate=0   Do NOT auto associate
disable                boolean                disable=1     Do not power the HW
=========        ==============        ============  ==============================

Sysfs helper와 RF kill switch

4. Sysfs helper file

드라이버 동작은 여러 방식으로 제어합니다. 일반 기능 대부분은 Wireless Tools의 `iwconfig`로 노출되고, 일부 기능은 Linux sysfs entry로 제공합니다.

driver-level file은 `/sys/bus/pci/drivers/ipw2100/`에 있습니다. `debug_level`은 `debug` module parameter와 같은 global 값을 제어합니다.

사용 가능한 debug level은 드라이버 소스 directory의 `dvals` script로 확인합니다. `debug_level`은 `CONFIG_IPW2100_DEBUG`를 켠 빌드에서만 활성화됩니다.

device-level file은 `/sys/bus/pci/drivers/ipw2100/{PCI-ID}/`에 있습니다. 예: `/sys/bus/pci/drivers/ipw2100/0000:02:01.0`.

software RF kill을 활성화한 뒤 hardware RF kill을 ON → OFF → ON으로 전환해도 radio는 다시 켜지지 않습니다.

5. Radio kill switch

대부분의 laptop은 사용자가 radio를 물리적으로 끌 수 있습니다. 일부 제품은 software 없이 동작하는 물리 switch를 사용합니다.

다른 laptop에서는 button을 누르면 software driver가 radio를 켜거나 끕니다. 이를 software 기반 RF kill switch라고 합니다.

시스템 RF switch 상태는 sysfs helper file `rf_kill`에서 확인하십시오.

4. Sysfs Helper Files
=====================

There are several ways to control the behavior of the driver.  Many of the
general capabilities are exposed through the Wireless Tools (iwconfig).  There
are a few capabilities that are exposed through entries in the Linux Sysfs.


**Driver Level**

For the driver level files, look in /sys/bus/pci/drivers/ipw2100/

  debug_level
        This controls the same global as the 'debug' module parameter.  For
        information on the various debugging levels available, run the 'dvals'
        script found in the driver source directory.

        .. note::

              'debug_level' is only enabled if CONFIG_IPW2100_DEBUG is turn on.

**Device Level**

For the device level files look in::

        /sys/bus/pci/drivers/ipw2100/{PCI-ID}/

For example::

        /sys/bus/pci/drivers/ipw2100/0000:02:01.0

For the device level files, see /sys/bus/pci/drivers/ipw2100:

  rf_kill
        read

        ==  =========================================
        0   RF kill not enabled (radio on)
        1   SW based RF kill active (radio off)
        2   HW based RF kill active (radio off)
        3   Both HW and SW RF kill active (radio off)
        ==  =========================================

        write

        ==  ==================================================
        0   If SW based RF kill active, turn the radio back on
        1   If radio is on, activate SW based RF kill
        ==  ==================================================

        .. note::

           If you enable the SW based RF kill and then toggle the HW
           based RF kill from ON -> OFF -> ON, the radio will NOT come back on


5. Radio Kill Switch
====================

Most laptops provide the ability for the user to physically disable the radio.
Some vendors have implemented this as a physical switch that requires no
software to turn the radio off and on.  On other laptops, however, the switch
is controlled through a button being pressed and a software driver then making
calls to turn the radio off and on.  This is referred to as a "software based
RF kill switch"

See the Sysfs helper file 'rf_kill' for determining the state of the RF switch
on your system.

Dynamic firmware와 power management

6. Dynamic firmware

firmware는 제한적 사용 라이선스를 따르므로 커널 소스에 포함할 수 없습니다. IPW2100을 활성화하려면 wireless NIC processor에 적재할 firmware image가 필요합니다.

원문은 image를 `http://ipw2100.sf.net/firmware.php`에서 받으라고 안내하며, 설치 방법은 `INSTALL`을 참조하라고 합니다.

7. Power management

IPW2100은 private wireless extension interface를 통해 Power Save Protocol을 설정할 수 있습니다.

power management는 일정 시간 radio를 통과한 packet이 없으면 radio 전원을 내립니다. 전원이 내려간 radio는 정해진 기간 그 상태를 유지합니다.

절전 수준이 높을수록 마지막 packet 처리 후 sleep까지의 interval은 짧아지고 sleep period는 길어집니다.

radio가 sleep 상태일 때 AP는 station이 깨어나 buffered packet을 요청할 때까지 station용 packet을 buffer해야 합니다.

AP가 PSP protocol을 올바르게 지원하지 않으면 power management 사용 중 packet loss 또는 매우 낮은 성능이 나타날 수 있습니다. 이때 AP firmware를 갱신하거나 `iwconfig eth1 power off`로 power management를 끄십시오.

현재 power level은 `iwpriv eth1 get_power`로 확인합니다. 결과는 `xxxx/yyyy (z)` 형식입니다.

`xxxx`는 packet 처리 뒤 sleep까지의 timeout, `yyyy`는 radio를 다시 켜 AP에 buffered packet을 질의하기 전 sleep period, `z`는 power level입니다.

power management가 꺼져 있으면 `xxxx/yyyy` 대신 `off`가 표시됩니다. 함께 보고되는 level은 나중에 `iwconfig eth1 power on`을 실행할 때 사용할 활성 level입니다.

6. Dynamic Firmware
===================

As the firmware is licensed under a restricted use license, it can not be
included within the kernel sources.  To enable the IPW2100 you will need a
firmware image to load into the wireless NIC's processors.

You can obtain these images from <http://ipw2100.sf.net/firmware.php>.

See INSTALL for instructions on installing the firmware.


7. Power Management
===================

The IPW2100 supports the configuration of the Power Save Protocol
through a private wireless extension interface.  The IPW2100 supports
the following different modes:

        ===        ===========================================================
        off        No power management.  Radio is always on.
        on        Automatic power management
        1-5        Different levels of power management.  The higher the
                number the greater the power savings, but with an impact to
                packet latencies.
        ===        ===========================================================

Power management works by powering down the radio after a certain
interval of time has passed where no packets are passed through the
radio.  Once powered down, the radio remains in that state for a given
period of time.  For higher power savings, the interval between last
packet processed to sleep is shorter and the sleep period is longer.

When the radio is asleep, the access point sending data to the station
must buffer packets at the AP until the station wakes up and requests
any buffered packets.  If you have an AP that does not correctly support
the PSP protocol you may experience packet loss or very poor performance
while power management is enabled.  If this is the case, you will need
to try and find a firmware update for your AP, or disable power
management (via ``iwconfig eth1 power off``)

To configure the power level on the IPW2100 you use a combination of
iwconfig and iwpriv.  iwconfig is used to turn power management on, off,
and set it to auto.

        =========================  ====================================
        iwconfig eth1 power off    Disables radio power down
        iwconfig eth1 power on     Enables radio power management to
                                   last set level (defaults to AUTO)
        iwpriv eth1 set_power 0    Sets power level to AUTO and enables
                                   power management if not previously
                                   enabled.
        iwpriv eth1 set_power 1-5  Set the power level as specified,
                                   enabling power management if not
                                   previously enabled.
        =========================  ====================================

You can view the current power level setting via::

        iwpriv eth1 get_power

It will return the current period or timeout that is configured as a string
in the form of xxxx/yyyy (z) where xxxx is the timeout interval (amount of
time after packet processing), yyyy is the period to sleep (amount of time to
wait before powering the radio and querying the access point for buffered
packets), and z is the 'power level'.  If power management is turned off the
xxxx/yyyy will be replaced with 'off' -- the level reported will be the active
level if `iwconfig eth1 power on` is invoked.

지원과 라이선스

8. 지원

일반 개발 정보와 지원은 당시 `http://ipw2100.sf.net/`에서 제공되었습니다.

ipw2100 1.1.0 드라이버와 firmware는 `http://support.intel.com`에서 받을 수 있다고 원문은 안내합니다.

Linux 커널 2.6.8 이상에서 ipw2100 1.1.0 설치 지원은 `http://supportmail.intel.com`을 통해 제공되었습니다. 이 주소들은 역사적 기록이므로 현재 유효성은 별도로 확인해야 합니다.

9. 라이선스

Copyright 2003-2006 Intel Corporation. All rights reserved.

이 프로그램은 Free Software Foundation이 공개한 GNU General Public License version 2의 조건에 따라 재배포하거나 수정할 수 있는 free software입니다.

이 프로그램은 유용하기를 바라며 배포하지만 어떠한 보증도 제공하지 않습니다. 상품성 또는 특정 목적 적합성에 대한 묵시적 보증도 없습니다. 자세한 내용은 GNU GPL을 참조하십시오.

GNU GPL 사본을 프로그램과 함께 받았어야 합니다. 받지 못했다면 원문에 기재된 Free Software Foundation 주소로 문의하십시오. 전체 라이선스는 배포판의 `LICENSE` 파일에 포함됩니다.

라이선스 연락처: James P. Ketrenos `<[email protected]>`, Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497.

8. Support
==========

For general development information and support,
go to:

    http://ipw2100.sf.net/

The ipw2100 1.1.0 driver and firmware can be downloaded from:

    http://support.intel.com

For installation support on the ipw2100 1.1.0 driver on Linux kernels
2.6.8 or greater, email support is available from:

    http://supportmail.intel.com

9. License
==========

  Copyright |copy| 2003 - 2006 Intel Corporation. All rights reserved.

  This program is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License (version 2) as
  published by the Free Software Foundation.

  This program is distributed in the hope that it will be useful, but WITHOUT
  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  more details.

  You should have received a copy of the GNU General Public License along with
  this program; if not, write to the Free Software Foundation, Inc., 59
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.

  The full GNU General Public License is included in this distribution in the
  file called LICENSE.

  License Contact Information:

  James P. Ketrenos <[email protected]>

  Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497