/**************************************************************************
DAVICOM DM9PCI Fast Ethernet Adapter Power Management Client Program V0.01
**************************************************************************/

1. Purpose:

    For generating magic packets and pattern matching wake-up frames

2. Requirement:

    Any Ethernet adapter which supports packet driver.

3. Procedures:

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


4. User Interface

DAVICOM DM9PCI Fast Ethernet Adapter Power Management Client Program V0.01
Copyright (C) 1998, DAVICOM Semiconductor Inc.

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

5. Operations:

   (1). Send a magic packet

	Step 1. Use "D" command to setup the magick packet address

	Step 2. Use "S" command to build up the magic packet and send it out

   (2). Transmit a wake-up frame

	Step 1. Use "R" command to read in a filter template file in which
		4 wake-up frames were defined

	Step 2. Use "T" command to chose and send out one of the 4 pre-defined
		wake-up frames

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

    Wake-Up-Frame Filter Template File is a text file which describes the
    definitions of the wake-up frames and used both by PM Server and PM Client.
    Server use the template file to setup Wake-Up-Frame Filter Registers.
    Client use it as a template to setup its internal database and user can
    send wake-up frames according to the instruction of the template file.

    Template file supports at most 4 definitions of Wake-Up-Frame.
    Each wake-up frame consist of two definitions:

	[WAKE_UP_FRAME]:    Describe the data pattern of the wake-up frame.
			    Always start from the first byte of the packet.

			    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 correspong position
			    in the defintion of [WAKE_UP_FRAME] will be invlove
			    in the pattern match checking.

			    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 wake-up frame which
    intends to use an ARP packet from a whatever station to wake-up a
    station with IP address 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 of wake-up frame,
    refer to the DM9102 Reference Manual.


/**************************************************************************
DAVICOM DM9PCI Fast Ethernet Adapter Power Management Server Program V0.01
**************************************************************************/

1. Purpose:

    Setup and enable 3 network device class power management event of
    DM9PCI Fast Ethernet adapter and then put the system in 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 node ID
	3. wake-up frame -- setup through a filter template file

2. Requirement:
    1. DM9PCI based Fast Ethernet adapter
    3. ATX power-supply with standy-by power
    2. Motherboard support ACPI/WOL power management

3. Procedures:

    Under DOS prompt:

	>PMD <filter template file path>

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