Welcome to the Hack-o-Rocket!

The Hack-o-Rocket software suite is a replacement for the original firmware
on Copper Mountain's CopperRocket 201 SDSL and IDSL CPE units.  The devices
in question are long discontinued and the company that made them exists no
more; the units to be turned into Hack-o-Rockets are to be obtained from eBay
and similar sources instead.

The original function of unmodified CR201 units is connectivity to SDSL and
IDSL lines of CM's proprietary flavor which the Open SDSL Connectivity Project
has nicknamed CM 1483:

http://ifctfvax.Harhan.ORG/OpenSDSL/CM/cm1483.html

Unmodified CopperRockets cannot do anything else; they can't connect to any
other SDSL flavor in particular.

The Hack-o-Rocket firmware replaces the function of CM 1483 bridging
connectivity with two alternative functions:

* Connectivity to certain non-CM SDSL and IDSL flavors with rudimentary IP
  router functionality;

* Debug and hacking platform.

The original CM 1483 bridging functionality is lost, i.e., there is no code in
the present Hack-o-Rocket software release that performs a function similar to
CM's original firmware.  (You are perfectly free to write this code yourself
and make use of the existing Hack-o-Rocket software framework -- you have the
source code!  See the sw-arch document for the details.)

The non-CM SDSL connectivity function of the present HoR software release
supports the following flavors:

* IDSL (any channel configuration) with HDLC on the line, routed IP in RFC 1490
  encapsulation;
* SDSL Flavor B (HDLC on the line), routed IP in RFC 1490 encapsulation;
* Nokia SDSL/ATM (Flavor N1), routed IP in RFC 1483 ATM encapsulation.

All 3 are routed, not bridged DSL configurations and are supported via a
rudimentary IP router implemented directly on the rocket.  The supported
flavors most notably include Covad SDSL and IDSL circuits which cross-connect
to some 3rd-party ISP.  (Covad's own IP service is not supported due to their
PPPoA/PPPoFR which we haven't implemented.)  This function is documented
further in router.doc.

The debug and hacking platform function needs little explanation as those
interested in it probably don't need much in the way of documentation. :-)
There is an M68K processor level debug monitor for the rocket's MC68LC302 CPU
called MON302 (non-DSL-aware, same for CR201i and CR201s, documented in
mon302.doc) and there are DSL level debug utilities called IDEBUG and SDEBUG
(for IDSL and SDSL, respectively) documented in linedebug.doc.
