home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / doc / discover1 / ISA-Structure < prev    next >
Encoding:
Text File  |  2005-03-28  |  3.9 KB  |  124 lines
  1. Since detect 0.9.31 a new format is being used in the isa.lst file.
  2. The following is a procedure to add entries or update this file.
  3.  
  4.  
  5. a) Preliminary:
  6. ===============
  7.  
  8.   Download the detect package and install it 
  9.   (http://www.linux-mandrake.com/harddrake/download.html)
  10.   After the installation procedure is completed, copy the file
  11.   /usr/share/detect/isa.lst to your home directory. 
  12.   Now use your favorite editor to edit the copy.
  13.  
  14.  
  15. b) Structure of isa.lst:
  16. ========================
  17.  
  18. - The following is an example of an entry in the isa.lst file: ( '\t'
  19.   expands to a tabulation )
  20.   
  21.   +----8<---------------------------------------------------------------
  22.   |YMH0021\tsound\topl3sa\tYamaha\tOPL3-SAx Sound System\tHAS_OPL3
  23.   +----8<---------------------------------------------------------------
  24.   
  25. - Description of the fields
  26.  
  27.   * First field: [Logical device ID]
  28.     --------------------------------
  29.   
  30.     How to get it: Use the 'pnpdump' program. Usually installed in /sbin
  31.   
  32.     Example:
  33.   
  34.   +----8<---------------------------------------------------------------
  35.   | [root@luke alex]#pnpdump | grep "Logical device id"
  36.   |
  37.   | # Logical device id YMH0021
  38.   | # Logical device id YMH0022
  39.   | # Logical device id ESS0000
  40.   | # Logical device id ESS1868
  41.   | # Logical device id ESS0001
  42.   | # Logical device id ESS0002
  43.   +----8<---------------------------------------------------------------
  44.   
  45.     Each 'Logical device id' maps a device present in your computer to a
  46.     unique combination of letters and numbers, either mapping a unique
  47.     device present in a board or a set of devices.
  48.     For example, a single sound board usually reports several logical
  49.     devices, like the joystick port, the mpu401 port, etc.
  50.     Look for 'this logical device id' in the isa.lst file. If you find 
  51.     an entry and some of their fields are set to 'unknown', please 
  52.     udpate it.
  53.     Else add a new entry following the format being explained in this 
  54.     document.
  55.     
  56.   * Second field: [type of logical device]
  57.     --------------------------------------
  58.     How to get it:
  59.     
  60.     Detect has the following keywords based on the board type
  61.     
  62.     ethernet: For ethernet device network.
  63.     ide:      For ide interface.
  64.     joystick: For gameport and joystick.
  65.     modem:    For modem card.
  66.     sound:    For soundcard.
  67.     scsi:     For scsi interface.
  68.     
  69.     In case you don't know or you're not sure where your board fits, use
  70.     'unknown', or send an e-mail to adussart@mandrake.com if you think 
  71.     a new type is needed.
  72.     
  73.   * Third field: [kernel module name used to drive the device]
  74.     ----------------------------------------------------------
  75.     If there is no module for this device, just use "ignore" as dummy
  76.     module name
  77.     
  78.   * Fourth field: [vendor name]
  79.     ---------------------------
  80.     
  81.   * Fifth field:  [model name of the logical device]
  82.     ------------------------------------------------
  83.     
  84.   * Sixth field: [special field]
  85.     ----------------------------
  86.     This is a special field currently being used only by the logical
  87.     devices belonging to sound boards to tell detect which kernel modules
  88.     should be loaded for the particular logical device in order to make 
  89.     it work.
  90.  
  91.     Example:
  92.   
  93.   +----8<---------------------------------------------------------------
  94.   | HAS_OPL3
  95.   | HAS_MPU401
  96.   | HAS_DMA16
  97.   | HAS_AWE
  98.   | HAS_DREAM
  99.   | HAS_MAD16
  100.   | HAS_TRIX
  101.   | HAS_PAS2
  102.   | HAS_SMGAMES
  103.   | HAS_JOYSTICK
  104.   +----8<---------------------------------------------------------------
  105.   
  106.   
  107. c) Adding a new line:
  108. =====================
  109.   
  110.   Use the format described above to create a line for each logical 
  111.   device and put them in the isa.lst file, in ascending alphabetical 
  112.   order.
  113.  
  114.  
  115. d) Updating a line:
  116. ===================
  117.  
  118.   You'll notice that the current isa.lst file has many entries with one 
  119.   or more fields set to 'unknown'. 
  120.  
  121.   I hope this situation will be solved as soon as possible with the help
  122.   of the community.
  123.  
  124.