[parisc-linux] Second Draft of the help for the kernel options

[parisc-linux] Second Draft of the help for the kernel options

[Thomas Marteau]

Hi all,

	Once again, I ask you to verify what I wrote and only God knows how
important it is to re-read this file b/c it is useful and I made it so
many mistakes for sure :)

	I added the comments of the first draft (Thanks to Grant) and CPU type
help too. I do not really like the lists. If you have any better idea,
please let me know.

Thanks, Thomas.
ESIEE Team

PS: I would like to know if I can put the PA-RISC/Linux Boot HOWTO into
stable state??

Text to add in Documentation/ Configure.help
======================================================================================


Processor family
CONFIG_PA7100
  In this section, you will find enough informations to set correctly 
  your CPU type option. Nevertheless, if you need more, you can see 
  all the hardware content of your box at http://hwdb.parisc-linux.org.
  
  If you select the PA7000/PA7100 option, your box must be one of these 
  listed below: 705/35, 710/50, 715/33, 715/50, 715/75, 720/50, 725/50, 
  725/75, 730/66, 735/99, 735/125, 750/66, 755/99.

  If you select the PA7200 option, your box must be one of these listed 
  below: C100, C110, D250, D350, D260, D360, J200, J210, K100, K200, 
  K210, K220, K400, K410, K420.

  If you choose the PA7100LC/PA7300LC option then your box is 715/64, 
  715/80, 715/100, 725/100, A180, B132L(+), B160L(+), B180L(+), C160L, 
  C180L, D200, D210, D220, D230, D300, D310, D320 or D330. There are 
  also some systems from the E series but there are not yet supported.

  Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
  B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000, 
  J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000, 
  L2000, L3000, N4000, V2200, V2250, V2500.

  Now, you should be sure of which CPU type. If not, please send a mail 
  to parisc-linux@lists.parisc-linux.org.

64-bit kernel
CONFIG_PARISC64
  The 64-bit kernel support give the capability of using 64-bit CPU to 
  the kernel. This is useful for PA8X00 series minimum. Note that even
  if your kernel is 64-bit, your userspace will be in 32-bit.

GSC/Gecko bus support
CONFIG_GSC
  This option gives to the kernel the capability to manage GSC buses 
  of HP computers. More than that, if you have systems with GSC slots, 
  LASI, EISA or Dino (GSCtoPCI) bridge, this option is also compulsory 
  if you want it working.

LASI I/O support
CONFIG_GSC_LASI
  LASI is one type of controller embedded in HP workstations and 
  servers. It controls some I/O devices like PS2 keyboard and mouse, 
  audio or serial interface. The best advice is to keep it in your 
  configuration, if you are not sure about that point.

WAX support
CONFIG_GSC_WAX
  WAX is an EISA bus converter for PA-RISC systems. It can be found in
  older systems like B/C/D/R-class machines. This option enables this 
  converter. Note that it is under heavy development. Thus, it may not 
  be working.

GSCtoPCI/DINO PCI support
CONFIG_GSC_DINO
  By selecting this item, you add PCI support for Dino PCI Host Bus
bridge.
  PCI devices are sometimes embedded in GSC add-on cards (aka "card-mode 
  Dino"). Note that only recent systems need it like B132L, C200. For
more
  information, go to http://hwdb.parisc-linux.org.

Chassis LCD and LED support
CONFIG_CHASSIS_LCD_LED
  HP boxes have LED or LCD indicator on the front in order to show some 
  basic information like status for example. With this enabled, you can
  have this help also available.

Kernel support for SOM binaries
CONFIG_BINFMT_SOM
  SOM (Spectrum Object Model) is a format for libraries and executables 
  used by HP. Saying Y here will enable your kernel to run SOM binaries.
  As a result, you could run HP-UX executables. This capability is still
  in development. Then, you use this functionality with no warranty!

LASI/ASP builtin parallel-port
CONFIG_PARPORT_GSC
  If you have a LASI or ASP controller in your HP box and you want to
use 
  the parallel port, a good idea will be to keep this item in your
  configuration.

HP Lasi SCSI support
CONFIG_SCSI_LASI
  If you have an old HP system like a 712, you should keep this on.
  This will enable your SCSI controller and give you access to 
  SCSI devices. For quite recent computers, you may be able to turn 
  this off. 

Lasi ethernet
CONFIG_LASI_82596
  This option adds the driver for one of most used network chips 
  integrated in LASI chip. It is also known as Apricot driver. It is 
  based on an Intel 82596 chip. If you do not know what is your 
  hardware, it is strongly recommended to keep is on.

Support for Lasi/Dino PS2 port
CONFIG_GSC_PS2
  The PS2 connector of the HP boxes looks like a standard PC connector.
  If you want to use the PS2 keyboard and mouse, you must keep this on.
  Anyway, some HP workstations and servers have this kind of interfaces
  but not the ports you can plug in your devices. Thus, the best thing
  to do anyway is to let this choice turned on.

serial port on GSC support
CONFIG_SERIAL_GSC
  For most of the HP servers and for some workstations that do not have 
  its video card supported yet, you will need to get the console output
  via the serial port. As a result, you could interact with the box via
  a VT or a serial cable link to another computer.

STI console
CONFIG_STI_CONSOLE
  The Standard Text Interface could correspond to the VGA support for
PC.
  HP developped STI as a mechanism between CPU and graphics devices. 
  Thus, if you want your console on your screen like any other PC linux
  does, leave this option on.
  If you do not have any success with your console output, we advice you
  to check if you have checked the STI frame buffer option, aka 
  CONFIG_FB_STI, in your configuration. Some models are happy when the 
  two of them are enabled and some others prefer to have only this one 
  only.
  Anyway, if you failed to have the screen output, you can switch to the 
  serial console output.

PA Harmony audio driver
CONFIG_SOUND_HARMONY
  This option enables the audio part of the LASI controller. Since it is 
  standard to all the boxes, this option should be set for any 
  workstation except the newest ones. Servers do not really need audio. 
  Then, you can unset it.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Jurriaan Kalkman]

>Hi all,
>
>	Once again, I ask you to verify what I wrote and only God knows =
how
>important it is to re-read this file b/c it is useful and I made it so
>many mistakes for sure :)
>
>	I added the comments of the first draft (Thanks to Grant) and CPU =
type
>help too. I do not really like the lists. If you have any better idea,
>please let me know.
>
>Thanks, Thomas.
>ESIEE Team
>
>PS: I would like to know if I can put the PA-RISC/Linux Boot HOWTO into
>stable state??
>
>Text to add in Documentation/ Configure.help
>=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>
>
>Processor family
>CONFIG_PA7100
>  In this section, you will find enough informations to set correctly=20
>  your CPU type option. Nevertheless, if you need more, you can see=20
>  all the hardware content of your box at http://hwdb.parisc-linux.org.
> =20
>  If you select the PA7000/PA7100 option, your box must be one of =
these=20
>  listed below: 705/35, 710/50, 715/33, 715/50, 715/75, 720/50, 725/50,=20=

>  725/75, 730/66, 735/99, 735/125, 750/66, 755/99.
>
>  If you select the PA7200 option, your box must be one of these =
listed=20
>  below: C100, C110, D250, D350, D260, D360, J200, J210, K100, K200,=20
>  K210, K220, K400, K410, K420.
>
>  If you choose the PA7100LC/PA7300LC option then your box is 715/64,=20
>  715/80, 715/100, 725/100, A180, B132L(+), B160L(+), B180L(+), C160L,=20
>  C180L, D200, D210, D220, D230, D300, D310, D320 or D330. There are=20
>  also some systems from the E series but there are not yet supported.
>
>  Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
>  B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000,=20
>  J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000,=20
>  L2000, L3000, N4000, V2200, V2250, V2500.
>
Since at least two C200+ machines get Trace/Breakpoint trap errors when
compiling for PA8x00, I'd suggest a rephrasing or an addition like:

- for a generic kernel, select PA7x00
- if you select PA7000/PA7100, your box must be .... or newer.
- if you're not sure, select PA7x00

etc. 'Must' sounds very sure.

Good luck,
Jurriaan

Re: [parisc-linux] Second Draft of the help for the kernel options

[Jurij Smakov]

[skipped]
> Processor family
> CONFIG_PA7100
>   In this section, you will find enough informations to set correctly 
>   your CPU type option. Nevertheless, if you need more, you can see 
>   all the hardware content of your box at http://hwdb.parisc-linux.org.
>   
>   If you select the PA7000/PA7100 option, your box must be one of these 
>   listed below: 705/35, 710/50, 715/33, 715/50, 715/75, 720/50, 725/50, 
>   725/75, 730/66, 735/99, 735/125, 750/66, 755/99.
> 
>   If you select the PA7200 option, your box must be one of these listed 
>   below: C100, C110, D250, D350, D260, D360, J200, J210, K100, K200, 
>   K210, K220, K400, K410, K420.
> 
>   If you choose the PA7100LC/PA7300LC option then your box is 715/64, 
>   715/80, 715/100, 725/100, A180, B132L(+), B160L(+), B180L(+), C160L, 
>   C180L, D200, D210, D220, D230, D300, D310, D320 or D330. There are 
>   also some systems from the E series but there are not yet supported.
> 
>   Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
>   B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000, 
>   J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000, 
>   L2000, L3000, N4000, V2200, V2250, V2500.
> 
>   Now, you should be sure of which CPU type. If not, please send a mail 
>   to parisc-linux@lists.parisc-linux.org.
[skipped]

Hi!

Minor note: 712 models are not mentioned anywhere.

Best regards,

Jurij.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Richard Allen]

On Tue, Oct 02, 2001 at 04:44:26AM -0400, Jurij Smakov wrote:
> [skipped]
> > Processor family
> > CONFIG_PA7100
> >   In this section, you will find enough informations to set correctly 
> >   your CPU type option. Nevertheless, if you need more, you can see 
> >   all the hardware content of your box at http://hwdb.parisc-linux.org.
> >   
> >   If you select the PA7000/PA7100 option, your box must be one of these 
> >   listed below: 705/35, 710/50, 715/33, 715/50, 715/75, 720/50, 725/50, 
> >   725/75, 730/66, 735/99, 735/125, 750/66, 755/99.
> > 
> >   If you select the PA7200 option, your box must be one of these listed 
> >   below: C100, C110, D250, D350, D260, D360, J200, J210, K100, K200, 
> >   K210, K220, K400, K410, K420.
> > 
> >   If you choose the PA7100LC/PA7300LC option then your box is 715/64, 
> >   715/80, 715/100, 725/100, A180, B132L(+), B160L(+), B180L(+), C160L, 
> >   C180L, D200, D210, D220, D230, D300, D310, D320 or D330. There are 
> >   also some systems from the E series but there are not yet supported.
> > 
> >   Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
> >   B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000, 
> >   J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000, 
> >   L2000, L3000, N4000, V2200, V2250, V2500.
> > 
> >   Now, you should be sure of which CPU type. If not, please send a mail 
> >   to parisc-linux@lists.parisc-linux.org.
> [skipped]
> 
> Hi!
> 
> Minor note: 712 models are not mentioned anywhere.

Neither is the C360

-- 
Rikki.         --  HP Technical Support, RHCE, RHCX, HP-UX Certified Admin.
               --  Solaris 7 Certified Systems and Network Administrator.
Bell Labs Unix --  Reach out and grep someone.
Those who do not understand Unix are condemned to reinvent it, poorly.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Bjorn Helgaas]

>   Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
>   B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000,
>   J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000,
>   L2000, L3000, N4000, V2200, V2250, V2500.

I think it is unlikely that V2200, V2250, and V2500 will ever be supported.

I'm not very familiar with PDC on most of these machines, but at least on 
Halfdome, you can get a pretty good clue as to what processor to target by 
doing "in fru" at the PDC BCH menu:

  Main Menu: Enter command or menu > in fru

  CELL 0 CPU FRU INFORMATION:             

  Cab/
  Slot/                     Part        Serial    Date Art Scan   FRU   
Specific
  CPU       FRU Name       Number       Number    Code Rev  Rev   
Information
  ----- ---------------- ----------- ------------ ---- --- ---- 
----------------
  0/0/0        Processor A6445-70001 00000000001P          0000   PA8700 
Rev 2.2

Maybe a pointer to similar functionality in other firmware would be useful 
and reduce the dependence on the lists of machines.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Grant Grundler]

Bjorn Helgaas wrote:
>   Main Menu: Enter command or menu > in fru
...
> Maybe a pointer to similar functionality in other firmware would be useful 
> and reduce the dependence on the lists of machines.

That's a good idea.  Different generations of machines have different
commands to list the type and revisions of chips/devices installed.
But it's only two or three commands need to be listed.

For newer machines, "in io" at "Main Menu" prompt will list all IO devices.
See "info" menu for more commands. I forgot what the equivalent cmd
was for older machines (eg 712 or 715).

grant

Re: [parisc-linux] Second Draft of the help for the kernel options

[Thomas Marteau]

Hi all,

	The Bjorn's idea is quite practical but the problem is we need to do a
complete list of command. With this list, users will know what commands
to do to get the cpu type...

	For the B132L, I need to do in cr. And for 712, "in" do not give you
the model of the cpu :(

Perhaps, we could a more general text saying:   1- You have to enter the
information menu by "in" (it seems to be general to all boxes)
						2- Here you need to find the command to get the revisions of your
chip/device. This must look like PAXXX0. For example this command is cr
for B132 and io for newer machines.

btw, we could add the complete list of the commands in the HOWTO.

This is a proposition. Tell me what you think of it. Thomas.
ESIEE Team

> >   Main Menu: Enter command or menu > in fru
> 
> For newer machines, "in io" at "Main Menu" prompt will list all IO devices.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Matthew Wilcox]

On Tue, Oct 02, 2001 at 01:16:39AM +0200, Thomas Marteau wrote:
> Processor family
> CONFIG_PA7100
>   In this section, you will find enough informations to set correctly 
>   your CPU type option. Nevertheless, if you need more, you can see 
>   all the hardware content of your box at http://hwdb.parisc-linux.org.
>   
>   If you select the PA7000/PA7100 option, your box must be one of these 
>   listed below: 705/35, 710/50, 715/33, 715/50, 715/75, 720/50, 725/50, 
>   725/75, 730/66, 735/99, 735/125, 750/66, 755/99.
> 
>   If you select the PA7200 option, your box must be one of these listed 
>   below: C100, C110, D250, D350, D260, D360, J200, J210, K100, K200, 
>   K210, K220, K400, K410, K420.
> 
>   If you choose the PA7100LC/PA7300LC option then your box is 715/64, 
>   715/80, 715/100, 725/100, A180, B132L(+), B160L(+), B180L(+), C160L, 
>   C180L, D200, D210, D220, D230, D300, D310, D320 or D330. There are 
>   also some systems from the E series but there are not yet supported.
> 
>   Finally, PA8x00 is the good choice for all new stuff like A500, B1000,
>   B2000, B2600, C200+, C240+, C3000, C3600, J282, J2240, J5000, J6000, 
>   J6700, J7000, K250, K260, K270, K370, K450, K460, K470, K570, L1000, 
>   L2000, L3000, N4000, V2200, V2250, V2500.
> 
>   Now, you should be sure of which CPU type. If not, please send a mail 
>   to parisc-linux@lists.parisc-linux.org.

Let's try this in the style of the x86 one:

Processor family
CONFIG_PA7100
  This is the processor type of your CPU. This information is used for
  optimizing purposes. In order to compile a kernel that can run on
  all 32-bit PA-RISC processors, you can specify PA7000 here.  If you
  have a 64-bit machine, you may need to select PA8x00 here and say
  'y' to '64-bit kernel' below.

  The kernel will not necessarily run on earlier architectures than
  the one you have chosen, e.g. a PA7200 optimised kernel will run on
  a PA8000 cpu, but not a PA7000.

  If you don't know what type of CPU you have, you can refer to the
  Hardware Database at http://hwdb.parisc-linux.org/

> 64-bit kernel
> CONFIG_PARISC64
>   The 64-bit kernel support give the capability of using 64-bit CPU to 
>   the kernel. This is useful for PA8X00 series minimum. Note that even
>   if your kernel is 64-bit, your userspace will be in 32-bit.

64-bit kernel
CONFIG_PARISC64
  Selecting this option will build a 64-bit kernel.  Some 64-bit machines
  require a 64-bit kernel (eg L2000, A500) while other machines don't
  have 64-bit firmware (eg C360, J200), so you may need to enable 32-bit
  PDC below if you select this option.  Note that 64-bit userspace is
  not yet supported.

32-bit PDC
CONFIG_PDC_NARROW
  Turning this option on enables support for 32-bit firmware when running
  a 64-bit kernel.  You should select this option if you have a machine
  from the C160-J2240 era.

-- 
Revolutions do not require corporate support.

Re: [parisc-linux] Second Draft of the help for the kernel options

[Grant Grundler]

Matthew Wilcox wrote:
> 32-bit PDC
> CONFIG_PDC_NARROW
>   Turning this option on enables support for 32-bit firmware when running
>   a 64-bit kernel.  You should select this option if you have a machine
>   from the C160-J2240 era.

s/machine/workstation/
I'm pretty sure all 64-bit capable servers properly handle
PDC calls in wide mode. PAT PDC supports a few calls in
narrow mode (for boot loader) but the rest must be in wide mode.

Note that IODC generally requires narrow mode.
(Superdome IODC is different - but I don't recall exactly how).

BTW, I prefer Matthew's rewrite over the Thomas' proposal.
No offense intended thomas - thanks for submitting the original.

grant

Re: [parisc-linux] Second Draft of the help for the kernel options

[Thomas Marteau]

Hi all,

	I have put the Matthew Wilcox's CPU and 64bit section. For the PDC
narrow, a section was already written. So, I do not the change unless
you tell that:
"
32-bit PDC
CONFIG_PDC_NARROW
  Turning this option on enables support for 32-bit firmware when
running
  a 64-bit kernel.  You should select this option if you have a
workstation
  from the C160-J2240 era.
"
is better than:
"
32-bit PDC
CONFIG_PDC_NARROW
  Saying Y here will allow developers with a C180, C200, C240, C360,
  J200, J210, and/or a J2240 to test 64-bit kernels by providing 
  a wrapper for the 32-bit PDC calls.  Since the machines which 
  which require this option do not support over 4G of RAM, this
  option is targeted for developers of these machines wishing to
  test changes on both 32-bit and 64-bit configurations.

  If unsure, say N.
"

Anyway, thanks for your comment and if you have any idea, please mail
me, Thomas.
ESIEE Team

Re: [parisc-linux] Second Draft of the help for the kernel options

[Matthew Wilcox]

My reasoning for the wording was that you're only presented with this
option when you've already selected a 64-bit kernel.

-- 
Revolutions do not require corporate support.