/**************************************************************************
CNET PRO200WL PCI Fast Ethernet Adapter Power Management Server Program V0.02
**************************************************************************/

1. Purpose:

    Setup and enable the three (3) network device class power management
    events on a DM9PCI Fast Ethernet Adapter, and then put the system
    in a power-down mode.

    Supported power management event:
        1. Link changed -- Both link-on and link-down
        2. Magic Packet -- Magic Packet ID will be the same as the node ID
        3. Wake-Up frame -- Setup through a filter template file

2. Requirement:
    1. CNET PRO200WL PCI Fast Ethernet Adapter
    3. ATX power-supply with standy-by power
    2. The Motherboard that supports ACPI/WOL power management

3. Procedures:

    Under DOS prompt:

        >PMD <filter template file path>
    Ex.
        >PMD PING.FIL

    The server program PMD.EXE will setup all power managment configuration,
    and then power down the system (recommended) or wait for a key stroke
    from a user to power down the system.

/**************************************************************************
CNet PRO200WL PCI Fast Ethernet Adapter Power Management Client Program V0.02
**************************************************************************/

1. Purpose:

    This program is for generating Magic Packets and patterns matching
    Wake-Up frames.

2. Requirement:

    An Ethernet adapter that supports packet drivers.

3. Procedures:

   a. Load the packet driver provided by NIC vendor first
   b. Execute PMC.EXE under DOS

   ex.
   C:>DM9PCIPD 0x60
   C:>PMC

4. User Interface

CNET PRO200WL PCI Fast Ethernet Adapter Power Management Client Program V0.02

Command Menu:
    M <Magic Packet Address>    : Set Magic Packet IEEE Address
    D <Destination Address>     : Set Destination Address of Magic Packet
    S                           : Send Magic Packet
    R <Template File>           : Read Wake-Up-Frame Filter Template File
    L [Wake-Up-Frame Number]    : List Wake-Up-Frame
    T <Wake-Up-Frame Number>    : Transmit Wake-Up-Frame
    H                           : Display Command Menu
    X                           : Exit

Ex.
   >M 00 80 AD XX XX XX
   >D 00 80 AD XX XX XX
   >S   (send Magic Packet)
   >R PING.Fil
   >T 1 (or T 2 or T 3 or T 4 ;send Wake-up Frame)

5. Operations:

   (1). Send a magic packet

        Step 1. Use the "M" command to setup the Magic Packet address

        Step 2. Use the "S" command to build up the Magic Packets and send them out

   (2). Transmit a Wake-Up frame

        Step 1. Use the "R" command to read in the filter template file in which
                four (4) Wake-Up frames were defined

        Step 2. Use the "T" command to chose and send out one of the four (4) pre-defined
                Wake-Up frames

6. Format for Wake-Up-Frame Filter Template File

    The Wake-Up-Frame Filter Template File is a text file which describes the
    definitions for the Wake-Up frames used by the PM Server and PM Client.
    The server uses the template file to setup the Wake-Up-Frame Filter Registers.
    The client uses it as a template to setup its internal database. Users can
    send Wake-Up frames according to the instructions for the template file.

    The template file supports no more than four (4) Wake-Up-Frame definitions.
    Each wake-up frame consist of two definitions:

        [WAKE_UP_FRAME]:    Describe the Wake-Up frame's data pattern.
                            Always start from the packet's first byte.

                            Sample:

                            [WAKE_UP_FRAME]
                            00  22  33  44  <-- 1st byte of every packet
                            80  22  33  44
                            C8  22  33  44
                            00  22  33  44
                            06  22  33  44
                            0B  22  33  44
                            00  22  33  44
                            .   .   .   .
                            .   .   .   .
                            .   .   .   .

                            ^   ^   ^   ^
                            |   |   |   |
                            1st 2nd 3rd 4th
                            p   p   p   p
                            a   a   a   a
                            c   c   c   c
                            k   k   k   k
                            e   e   e   e
                            t   t   t   t

        [BYTE_MASK]:        Indicate which data byte in the corresponding position
                            of the defintion [WAKE_UP_FRAME] will be invloved
                            in the pattern match check.

                            Sample:
                            [BYTE_MASK]
                            01  00  01  00
                            01  00  01  00
                            01  00  01  00
                            01  00  01  00
                            01  00  01  00
                            01  00  01  00
                            00  00  01  00
                            .   .   .   .
                            .   .   .   .
                            .   .   .   .
                            01  00  00  03
                            01  03  00  00
                            03  00  03  00

                            00 - corresponding byte will be ignored
                            01 - corresponding byte will be check
                            03 - end of the pattern -- the corrsponding byte
                                 in [WAKE_UP_FRAME] will not be check, but
                                 must always have a whatever data.

    The following is an example of the definition of a Wake-Up frame which
    intends to use an ARP packet from whatever station to a Wake-Up
    station with an IP address of 192.9.222.190

        [WAKE_UP_FRAME]
        FF 22 33 44
        FF 22 33 44
        FF 22 33 44
        FF 22 33 44
        FF 22 33 44
        FF 22 33 44
        00 52 53 54
        91 52 53 54
        02 52 53 54
        00 52 53 54
        00 52 53 54
        06 52 53 54
        08 01 01 01
        06 00 00 00
        00 55 55 55
        01 aa aa aa
        08 55 55 55
        00 aa aa aa
        06 55 55 55
        04 aa aa aa
        00 55 55 55
        01 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        00 55 55 55
        00 aa aa aa
        C0 55 55 55
        09 aa aa aa
        DE 55 55 55
        BE aa aa aa
        55 55 55 55

        [BYTE_MASK]
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        00 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        01 01 01 01
        03 03 03 03

    For futher details about the filter definitions for Wake-Up frames,
    refer to the DM9102 Reference Manual.