102 lines
3.2 KiB
Plaintext
102 lines
3.2 KiB
Plaintext
MIITool
|
|
-------
|
|
|
|
This utility allows to observe and change the physical parameters
|
|
of Ethernet NICs on AmigaOS. The parameters include autonegotiation
|
|
settings and forced speed/duplex combinations. While it is expected
|
|
that autonegotiation "just works" with modern equipment, there still
|
|
are people with some interest in retro-computing who might or might
|
|
not experience link-related problems or are just curious about some
|
|
inner workings of everyday hardware.
|
|
|
|
A modern switch ("link partner") should advertise it`s capabilities
|
|
properly such that the Ethernet hardware can select the optimal mode
|
|
out of the supported set. If that is not the case, you can narrow down
|
|
the list of advertised modes such that the link partners come to a
|
|
working agreement. The last resort is to set a fixed speed/duplex
|
|
combination. Please note that fixed parameters must be set at both
|
|
ends of the link. Otherwise the link will work slowly or not at all.
|
|
|
|
None of the settings this tool applies is permanent. Changed parameters
|
|
are only valid until the next reset of the NIC.
|
|
|
|
This utility is able to detect an active Ethernet interface in case that
|
|
the RoadShow TCP/IP stack is active. Otherwise, the device needs to be
|
|
passed as commandline option explicitly.
|
|
|
|
Examples for usage are given at the end of this text.
|
|
|
|
|
|
Prerequisites:
|
|
- AmigaOS 2.04 on 68k
|
|
- active Ethernet SANA-II driver, i.e. after starting the IP-Stack
|
|
|
|
|
|
Invocation:
|
|
- MIITool is supposed to be run from CLI/Shell.
|
|
|
|
|
|
Arguments template:
|
|
DEVICE/K,UNIT/K/N,V/S,FORCEMEDIA/K,ADVERTISE/K,RENEG/S,RESET/S,VV/S
|
|
|
|
|
|
Detailed description of arguments:
|
|
|
|
keyword - description
|
|
------------------------
|
|
DEVICE/K - device name corresponding to active ethernet interface
|
|
DEV/K example: DEVICE=enc624j6net.device
|
|
|
|
UNIT/K/N - unit number of device to be opened (default: 0)
|
|
example: UNIT=0
|
|
|
|
FORCEMEDIA - speed/duplex combination to set unconditionally,
|
|
see below for a list of valid speed or duplex modes
|
|
|
|
ADVERTISE - speed/duplex combinations to announce by autonegotiation,
|
|
implicitly restart autonegotiation,
|
|
see below for a list of valid speed or duplex modes
|
|
|
|
RENEG - restart autonegotiation, please allow a couple of seconds
|
|
RESTART until the negotiation is finished
|
|
|
|
RESET - reset PHY to power-on state
|
|
|
|
VERBOSE - more detailed outputs
|
|
V
|
|
|
|
VERYVERBOSE- even more detailed outputs
|
|
VV
|
|
|
|
|
|
Valid Speed/Duplex combinations (not case sensitive):
|
|
|
|
10baseT-HD - 10 Mbit/s half duplex
|
|
10baseT-FD - 10 Mbit/s full duplex
|
|
100baseTx-HD - 100 Mbit/s half duplex over two wire pairs
|
|
100baseTx-FD - 100 Mbit/s full duplex over two wire pairs (common)
|
|
100baseT4 - 100 Mbit/s full duplex over 4 wire pairs (rare)
|
|
10baseT - 10 Mbit/s half or full duplex
|
|
10bT - 10 Mbit/s half or full duplex
|
|
100baseTx - 100 Mbit/s half or full duplex
|
|
100bTx - 100 Mbit/s half or full duplex
|
|
|
|
|
|
Examples:
|
|
|
|
current status (detailed, autodetect)
|
|
miitool v
|
|
|
|
current status (detailed):
|
|
miitool DEV=enc624j6net.device v
|
|
|
|
negotiate 10 Mbit/s only
|
|
miitool DEV=enc624j6net.device ADVERTISE=10bT
|
|
|
|
negotiate 100baseTx and 10baseT half duplex only:
|
|
miitool DEV=enc624j6net.device ADVERTISE=100bTx,10baseT-HD
|
|
|
|
force 100 Mbit/s full duplex
|
|
miitool DEV=enc624j6net.device FORCEMEDIA=100baseTx-FD
|
|
|