Hello,

This is Helios, the first Firewire stack for the PPC/MorphOS system.

If you want to develop some applications using the helios.library,
I've put in the package everything you need to to that in the SDK directory.

*****************
*** ATTENTION ***
*****************

Helios is in Beta stage.

SBP2 permits TD_FORMAT and TD_WRITE and all SCSI commands!
The author (Guillaume ROGUEZ) declines any responsabilities in usage of Helios.
Your data may be loosed...

Current SDK is in testing stage, API may changes at any moments.

*****************


Helios package description
~~~~~~~~~~~~~~~~~~~~~~~~~~

- README                          : this file!
- libs/helios.library             : High level API and core of Helios.
- devs/Helios/ohci1394_pci.device : MorphOS device to handle OHCI-1394 complient
hardwares.
- classes/sbp2.class              : Class to drive SBP2 units found on the bus.
- SDK/                            : All files needed to develop applications
using Helios.
    include/                      : C header files (.h).
    lib/libhelios.a               : gluelib if you don't use inlines.
    examples/                     : some API usage examples written in C,
binaries are
                                    already built in C directory.
- C                               : Examples built for you.

Installation and usage
~~~~~~~~~~~~~~~~~~~~~~

1) Copy contents of libs/* in LIBS:, devs/* in DEVS: and classes/* in
SYS:Classes.
2) Then run in a shell, as first program (important!), helios_rom_start.
=> this program shall be run only one time, running twice causes troubles as it
install
many tasks and load classes each time.

=> Helios and others parties send some debug output throught the serial line.
If your computer has been run with RamDebug option you can see also them using
the program LogTool.

3) Now each time a device is connected you can see bus reset and enumeration
steps
by looking serial line debug ouput.
If a compatible SBP2 device is connected and recognized, SBP2 class auto-mount
all partitions.

- Normally Helios should not be removed of the system after run.
But if you're know what you do, unmount all SBP2 partitions and run program
helios_remove.
Finish the removal by running shell command "Flushlib sbp2* helios* ohci*".
You may launch it many time because the internal Helios GarbageCollector task is
trigged
only each 3 seconds.


Known issues and limitations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Isochrone modes not supported yet.

- Asynchrone modes limitations:
    * Stream request not supported.

- No SerialBusManager task yet.

- No GUI, no prefs, no localisation...

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 8551   20720  41.3% -lh5- bcca Feb 24  2011 Helios/C/helios_remove
[generic]                10014   23264  43.0% -lh5- a98b Feb 24  2011 Helios/C/helios_rom_start
[generic]                20148   43900  45.9% -lh5- 5c09 Feb 24  2011 Helios/Classes/Helios/sbp2.class
[generic]                24319   53496  45.5% -lh5- 2a1a Feb 24  2011 Helios/Devs/Helios/ohci1394_pci.device
[generic]                  909    2087  43.6% -lh5- 2641 Oct 10  2010 Helios/FAQ
[generic]                19929   46872  42.5% -lh5- 1ec0 Feb 24  2011 Helios/Libs/helios.library
[generic]                 1830    3821  47.9% -lh5- c7e1 Feb 24  2011 Helios/README
[generic]                  596    1322  45.1% -lh5- 02c7 Oct 14  2010 Helios/SDK/Examples/FWBusReset.c
[generic]                  312     505  61.8% -lh5- 4abd Oct  6  2010 Helios/SDK/Examples/FWDumpDevices.c
[generic]                 1548    4207  36.8% -lh5- 7174 Oct 23  2010 Helios/SDK/Examples/FWReadRom.c
[generic]                 1256    3396  37.0% -lh5- f7cd Oct 14  2010 Helios/SDK/Examples/FWReset.c
[generic]                 1000    2234  44.8% -lh5- 121b Oct 14  2010 Helios/SDK/Examples/FWSendPhy.c
[generic]                  485     772  62.8% -lh5- 2fb1 Feb 24  2011 Helios/SDK/Examples/Makefile
[generic]                 1578    5799  27.2% -lh5- 7b78 Oct  6  2010 Helios/SDK/Examples/SCSICmd6.c
[generic]                  995    2567  38.8% -lh5- 4809 Oct 25  2010 Helios/SDK/Examples/SimpleReportMsgClient.c
[generic]                  337     598  56.4% -lh5- 0425 Oct  6  2010 Helios/SDK/include/clib/heliosclsbase_protos.h
[generic]                 1310    5065  25.9% -lh5- a7d6 Oct 13  2010 Helios/SDK/include/clib/helios_protos.h
[generic]                  363     691  52.5% -lh5- 409b Oct  6  2010 Helios/SDK/include/devices/helios/ohci1394.h
[generic]                   78      84  92.9% -lh5- 3fa1 Oct 25  2010 Helios/SDK/include/fd/heliosclsbase_lib.fd
[generic]                  437    1701  25.7% -lh5- 9185 Oct 13  2010 Helios/SDK/include/fd/helios_lib.fd
[generic]                 2091   16864  12.4% -lh5- a37a Feb 24  2011 Helios/SDK/include/inline/helios.h
[generic]                  375     810  46.3% -lh5- 0959 Feb 24  2011 Helios/SDK/include/inline/heliosclsbase.h
[generic]                 4421   16046  27.6% -lh5- dae6 Oct 25  2010 Helios/SDK/include/libraries/helios.h
[generic]                 1508    9309  16.2% -lh5- 91d7 Feb 24  2011 Helios/SDK/include/ppcinline/helios.h
[generic]                  358     776  46.1% -lh5- 3ed1 Feb 24  2011 Helios/SDK/include/ppcinline/heliosclsbase.h
[generic]                  290     662  43.8% -lh5- 1479 Feb 24  2011 Helios/SDK/include/proto/helios.h
[generic]                  301     723  41.6% -lh5- 7501 Feb 24  2011 Helios/SDK/include/proto/heliosclsbase.h
[generic]                 2724   46096   5.9% -lh5- bd74 Feb 24  2011 Helios/SDK/lib/libhelios.a
[generic]                  387     924  41.9% -lh5- 0de1 Sep 16  2010 Helios/SDK/Examples/helios_remove.c
[generic]                  343     558  61.5% -lh5- 9a41 Sep 16  2010 Helios/SDK/Examples/helios_rom_start.c
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        30 files  108793  315869  34.4%            Apr 27 04:09