<title>* Mice</title>

      <title>Mice</title>

  	  <para><emphasis>Contributed by Joel Sutton

      <para></para>

  	  <email>jsutton@bbcon.com.au</email> January 2000</emphasis></para>

  	  <para>FreeBSD supports a variety of different mice via the PS/2, serial and

  	  USB ports. Most users choose to use the mouse daemon to handle their mouse

  	  because it allows interaction in both X and on the system console.

  	  For more information on the mouse daemon refer to &man.moused.8;. The

  	  examples throughout this section assume that the mouse daemon is being used.

  	  </para>

  	  <note>

        <para>This section contains the names of specific products that the

        author has confirmed will work with FreeBSD. Other similar devices not

        listed may also be supported.</para>

      </note>

      <sect3>

        <title>PS/2</title>

        <para></para>

        <sect4>

          <title>System Configuration</title>

          <para>To ensure that your PS/2 mouse functions correctly with the mouse daemon

          you will need to include the following text in

          <filename>/etc/rc.conf</filename></para>

          <programlisting>moused_enable="YES"

moused_type="ps/2"

moused_port="/dev/psm0"</programlisting>

        </sect4>

        <sect4>

          <title>Known Compatible Devices</title>

          <itemizedlist>

            <listitem>

              <para>Logitech First Mouse - Three Button</para>

            </listitem>

            <listitem>

              <para>Microsoft Serial - PS/2 Compatible Mouse</para>

            </listitem>

          </itemizedlist>

        </sect4>

      </sect3>

      <sect3>

        <title>Serial</title>

        <para></para>

        <sect4>

          <title>System Configuration</title>

          <para>To ensure that your serial mouse functions correctly with the mouse daemon

          you will need to include the following text in <filename>/etc/rc.conf</filename>.

          This example assumes that the mouse is connected to COM1: and can be

          automatically recognised by the mouse daemon.</para>

          <programlisting>moused_enable="YES"

moused_type="auto"

moused_port="/dev/cuaa0"</programlisting>

          <para>See the &man.moused.8; manual page for a detailed description

          of how to configure the mouse daemon to work with specific types

          of serial mice.</para>

        </sect4>

        <sect4>

          <title>Known Compatible Devices</title>

          <itemizedlist>

            <listitem>

              <para>Generic Microsoft Compatible Mice</para>

            </listitem>

            <listitem>

              <para>Logitech First Mouse - Three Button</para>

            </listitem>

            <listitem>

              <para>Microsoft Serial - PS/2 Compatible Mouse</para>

            </listitem>

          </itemizedlist>

        </sect4>

      </sect3>

      <sect3>

        <title>USB</title>

        <para></para>

        <sect4>

          <title>System Configuration</title>

          <para>The USB device drivers are a relatively new addition to FreeBSD

          and have not yet been included in the GENERIC kernel. The following

          prodecure is an example of how to setup the relevant drivers on a

          typical system.</para>

          <procedure>

            <step>

       	      <para>Add the <devicename>ums</devicename> device to the usb

       	      section of your <link	linkend="kernelconfig-config">kernel

       	      configuration</link>. For example:

       	      </para>

        	    <programlisting>controller usb0

controller uhci0

device ums0</programlisting>

        	  </step>

        	  <step>

        	    <para><link linkend="kernelconfig-building">Rebuild and

          		install</link> the new kernel.</para>

        	  </step>

       	    <step>

       	      <para>Make the <link linkend="kernelconfig-nodes">device node</link> by

       	      typing:</para>

        	    <screen>&prompt.root; <userinput>cd /dev</userinput>

&prompt.root; <userinput>sh MAKEDEV ums0</userinput></screen>

        	  </step>

        	  <step>

        	    <para>Include the following text in <filename>/etc/rc.conf</filename>

        	    to ensure correct operation of the mouse daemon:</para>

             <programlisting>moused_enable="YES"

moused_type="auto"

moused_port="/dev/ums0"</programlisting>

            </step>

            <step>

              <para>Reboot the system.</para>

        	    <screen>&prompt.root; <userinput>shutdown -r now</userinput></screen>

            </step>

          </procedure>

        </sect4>

        <sect4>

          <title>Known Compatible Devices</title>

          <itemizedlist>

            <listitem>

              <para>Logitech TrackMan - Marble Wheel</para>

            </listitem>

          </itemizedlist>

        </sect4>

      </sect3>