Broadcom BCM57xx(x)/BCM590x NetXtreme and NetLink family Ethernet driver
Info
====
This is an NDIS driver for Broadcom BCM57xx(x)/BCM590x NetXtreme
and NetLink family Ethernet adapters. The source code from the
FreeBSD "bge" driver has been compiled, unmodified, to run on OS/2.
This driver supports the following adapters.
The Broadcom 57xx series adapters.
These correspond to the following Vendor:Device numbers:
12AE:0003, 12AE:0004, 173B:03E8, 173B:03E9, 173B:03EA, 106B:1645,
14E4:1644, 14E4:1645, 14E4:1646, 14E4:16C6, 14E4:16A6, 14E4:1647,
14E4:16C7, 14E4:16A7, 14E4:1648, 14E4:16A8, 14E4:1649, 14E4:1653,
14E4:166E, 14E4:1654, 14E4:165D, 14E4:165E, 14E4:1668, 14E4:1669,
14E4:1678, 14E4:1679, 14E4:1655, 14E4:1665, 14E4:1656, 14E4:1657,
14E4:165F, 14E4:1659, 14E4:165A, 14E4:165B, 14E4:1643, 14E4:16F3,
14E4:1676, 14E4:167C, 14E4:1677, 14E4:167E, 14E4:167D, 14E4:1600,
14E4:1601, 14E4:16F7, 14E4:16FE, 14E4:16FD, 14E4:167A, 14E4:1672,
14E4:167B, 14E4:1673, 14E4:1674, 14E4:1681, 14E4:1680, 14E4:1688,
14E4:1689, 14E4:1687, 14E4:1684, 14E4:166A, 14E4:166B, 14E4:16DD,
14E4:1696, 14E4:1698, 14E4:16A0, 14E4:1699, 14E4:169A, 14E4:169B,
14E4:167F, 14E4:1693, 14E4:169C, 14E4:169D, 14E4:170D, 14E4:170E,
14E4:16FF, 14E4:1712, 14E4:1713, 14E4:1690, 14E4:16B0, 14E4:1682,
14E4:1642, 14E4:16B4, 14E4:1686, 14E4:1683, 14E4:1692, 14E4:16B1,
14E4:16B7, 14E4:16B5, 14E4:16B3, 14E4:1641, 14E4:1691, 14E4:1694,
14E4:16B2, 14E4:16B6, 1148:4400, 10B7:0003, 10CF:11A2, 10CF:11A1,
10CF:11CC
Use the PCI.EXE command to find the Vendor ID and Device ID of your
hardware. If the Vendor ID and the Device ID is listed above, then this
driver should work.
NOTICE:
This driver is built from 2 major pieces:
(1) The FreeBSD driver which is simply compiled to run on OS/2
(2) The system library which is the interface between the
FreeBSD driver and OS/2
While we will always try our best to support these drivers, please realize
that there is not much we can do about (1). We simply do not have the
manpower, or even the technical information necessary to debug or enhance
this portion of the driver. If this driver doesn't work on hardware that
it is supposed to, the limit of what we can do is verify that it is loading
properly. Other than that, we simply cannot debug problems in the FreeBSD
code and we cannot add support for more chipsets. We cannot even fix
problems if it doesn't work properly on your hardware because we don't have
the hardware data that would be required.
Development is continuing on (2) so there might be improvements to
the OS/2 interface as time goes on. This generally will not affect
whether the driver works or doesn't work on any given hardware, but
might affect things like traps, hangs, and interfacing to existing
features in the FreeBSD driver.
This driver was personally tested by the developer on 14E4:1654 hardware.
Copyright and License
=====================
Copyright (c) 2014-2017 David Azarewicz <david@88watts.net>
All rights reserved.
Copyright (c) 2008, Pyun YongHyeon <yongari@FreeBSD.org>
All rights reserved.
(c) Copyright IBM Corporation 1990,2000.
All rights reserved.
Important! By downloading or using this software, you acknowledge that
you have read and consent to the license agreement at the end of this
file, that you understand it, and that you agree to be bound by its terms.
Installation
============
You can install the network driver during operating system installation.
Or you can install the driver using the Warpin package.
This Warpin installer only copies the driver files to your system. After
you install the files, run mpts.exe and set up the network driver as
usual. Then reboot. If you are already using one of these drivers, then
this package will update the files on your disk and there is no need to
run mpts.exe again. The new driver will be used when you reboot.
Command line options
====================
/An
Selects a specific PCI adapter to use. If not specified, the driver will use the
first unused PCI adapter that is supported by the driver. For example, /A1 will
select the second PCI adapter that is supported by the driver. If the specified
PCI adapter does not exist, the driver will produce an error. /A0 = MMBGE$,
/A1 = MMBGE2$, /A2 = MMBGE3$, etc.
/V
Turns on the version banner when the driver loads.
Options only in the trace build
-------------------------------
/Tn
Sets the minor trace number for controlling trace output. Only applies
to the trace build of the driver. Ignored in the retail version.
Options only in the debug build
-------------------------------
The debug build is not included in the distribution package and is only
for developer use.
/Dn
Sets the debug output level to n. The default is 5. Only applies
to the debug build of the driver. Ignored in the retail version.
/COM=n
Sets the serial port for debug output. Valid values are 1 and 2
for COM1 and COM2, or the port address. The default is no serial
port output. Only applies to the debug build of the driver.
Ignored in the retail version.
PROTOCOL.INI Options
====================
There are currently no options.
Getting Support and Reporting Problems
======================================
Since the FreeBSD driver is simply compiled to run on OS/2, there
is no development, no debugging, and no support for that part of
the driver. There is only support for the interface between the
FreeBSD driver and OS/2.
For more information please visit:
and click on SUPPORT.
Or go directly to the MultiMac support wiki at:
https://www.arcanoae.com/wiki/multimac/
Source Code
===========
The source code will be available at: http://svn.netlabs.org/repos/multimac
Change log
==========
0.0.1 09-Jan-2017 - David Azarewicz
Initial release.
=============================================================================
End User License Agreement
1. Grant of License. Arca Noae, LLC ("Licensor") grants you a
non-exclusive license to use the program with which this
license is distributed (the "MMBGE Driver Software"), including any
documentation files accompanying the MMBGE Driver Software
("Documentation") provided that (i) the MMBGE Driver Software may not
be modified; (ii) all copyright notices are maintained; and (iii)
you agree to be bound by the terms of this License Agreement.
2. Ownership. You have no ownership rights in the MMBGE Driver Software.
Rather, you have a license to use the MMBGE Driver Software as long as
this License Agreement remains in full force and effect. Ownership of
the MMBGE Driver Software, Documentation and all intellectual property
rights therein shall remain at all times with Licensor. Any other use
of the MMBGE Driver Software by any person, business, corporation,
government organization, or any other entity is strictly forbidden and
is a violation of this License Agreement.
3. Copyright. The MMBGE Driver Software and Documentation contain material
that is protected by United States Copyright Law and trade secret law,
and by international treaty provisions. All rights not granted to you
herein are reserved to Licensor. You may not remove any proprietary notice
of Licensor from any copy of the MMBGE Driver Software or Documentation.
4. Restrictions. You must protect the MMBGE Driver Software and
Documentation consistent with Licensor's rights therein. You may not
publish, display, disclose, rent, lease, modify, loan, distribute, or
create derivative works based on the MMBGE Driver Software or any part
thereof. You may not reverse engineer, decompile, translate, adapt, or
disassemble the MMBGE Driver Software, nor shall you attempt to create
the source code from the object code for the MMBGE Driver Software.
You may only use the MMBGE Driver Software on the number of systems
that is specified in the product that you purchased. The Personal
edition allows for up to 5 systems. If you have the Commercial
edition, consult your invoice for the number of systems allowed.
5. Limited Warranty. Licensor warrants that the MMBGE Driver Software
will perform substantially as described by Licensor. Should the ACPI
Driver Software not so perform, your exclusive remedy, and Licensor's
sole obligation under this warranty shall be, at Licensor's sole
discretion, correction of the defect. Any use by you of the ACPI
Driver Software is at your own risk. This limited warranty is the
only warranty provided by Licensor regarding the MMBGE Driver Software.
Except for the limited warranty above, the MMBGE Driver Software is
provided "as is." To the maximum extent permitted by law, Licensor
disclaims all other warranties of any kind, either expressed or implied,
including, without limitation, implied warranties of merchantability
and fitness for a particular purpose. Licensor does not warrant that
the functions contained in the MMBGE Driver Software will meet any
requirements or needs you may have, or that the MMBGE Driver Software
will operate error free, or in an uninterrupted fashion, or that any
defects or errors in the MMBGE Driver Software will be corrected, or
that the MMBGE Driver Software is compatible with any particular system.
Licensor is not obligated to provide any updates to the ACPI Driver
Software. Some jurisdictions do not allow the waiver or exclusion of
implied warranties, so some of these waivers and/or exclusions may not
apply to you.
6. Limitation Of Liability. IN NO EVENT WILL LICENSOR BE LIABLE TO YOU
OR ANY THIRD PARTY FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING,
WITHOUT LIMITATION, INDIRECT, SPECIAL, PUNITIVE, OR EXEMPLARY DAMAGES
FOR LOSS OF BUSINESS, LOSS OF PROFITS, BUSINESS INTERRUPTION, OR LOSS
OF BUSINESS INFORMATION) ARISING OUT OF THE USE OF OR INABILITY TO USE
THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY, EVEN IF LICENSOR HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. LICENSOR'S LIABILITY
WITH RESPECT TO ITS OBLIGATIONS UNDER THIS AGREEMENT OR OTHERWISE WITH
RESPECT TO THE ACPI DRIVER SOFTWARE AND DOCUMENTATION OR OTHERWISE SHALL
NOT EXCEED $100. BECAUSE SOME STATES/COUNTRIES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE
ABOVE LIMITATION MAY NOT APPLY TO YOU.
7. Export Restrictions. This license agreement is expressly made subject
to any laws, regulations, orders, or other restrictions on the export
from the United States of America of the MMBGE Driver Software or
information about such MMBGE Driver Software which may be imposed from
time to time by the government of the United States of America. You shall
not export the MMBGE Driver Software, documentation, or information about
the MMBGE Driver Software and documentation without consent of Licensor
and compliance with such laws, regulations, orders, or other restrictions.
8. Termination. This License Agreement is effective until terminated.
You may terminate this License Agreement at any time by destroying or
returning to Licensor all copies of the MMBGE Driver Software and
Documentation in your possession or under your control. Licensor may
terminate this License Agreement if Licensor determines in its sole
discretion that termination is in Licensor's best interests or finds
that you have violated the terms of this License Agreement. Upon
notification of termination, you agree to destroy or return to Licensor
all copies of the MMBGE Driver Software and Documentation and to certify
in writing that all known copies, including backup copies, have been
destroyed. All provisions relating to confidentiality, proprietary
rights, and non-disclosure shall survive the termination of this
MMBGE Driver Software License Agreement.
9. General. This License Agreement shall be construed, interpreted and
governed by the laws of the State of Delaware without regard to
conflicts of law provisions thereof. This License Agreement shall
constitute the entire agreement between the parties hereto. Any waiver
or modification of this License Agreement shall only be effective if
it is in writing and signed by both parties hereto. If any part of this
License Agreement is found invalid or unenforceable by a court of
competent jurisdiction, the remainder of this License Agreement shall
be interpreted so as to reasonably affect the intention of the parties.