File	Date	Author	Commit
COPYING	2004-09-05	Ilkka Urtamo	[5818dc] Initial revision
ChangeLog	2007-02-10	Ilkka Urtamo	[f65d11] Preparing to 0.3.0 release
Makefile	2007-02-10	Ilkka Urtamo	[f65d11] Preparing to 0.3.0 release
Makefile.cw_wine	2007-02-10	Ilkka Urtamo	[0b2c1c] Spaces to tab .. oops
Makefile.sdcc	2005-06-11	Ilkka Urtamo	[e1eadc] fixed sdcc overlay problems with lib functions
README	2005-05-03	Ilkka Urtamo	[c2dd29] fixed to single configure with options
config.h	2007-02-10	Ilkka Urtamo	[43724e] oops, wrong settings for default irboy
configure	2005-05-03	Ilkka Urtamo	[c2dd29] fixed to single configure with options
decode.c	2007-01-14	Aapo Tamminen	[be9ba2] v 0.3.0
filter.c	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
filter.h	2005-06-09	Ilkka Urtamo	[893ef7] Updated sdcc support (devu/3 bug still remains)...
intvect.c	2005-05-03	Aapo Tamminen	[e90b05] version 0.2.1
ir.c	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
ir.h	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
main.c	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
mc68hc908jb8.h	2005-10-11	Ilkka Urtamo	[f401e9] Added dev version of new driver base : Updated ...
sdcc.opt	2005-06-12	Ilkka Urtamo	[033c16] removed cw warning, added sdcc optimize peephole
serial.c	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
serial.h	2005-06-09	Ilkka Urtamo	[893ef7] Updated sdcc support (devu/3 bug still remains)...
start08.c	2005-05-03	Aapo Tamminen	[e90b05] version 0.2.1
start08.h	2005-05-03	Aapo Tamminen	[e90b05] version 0.2.1
types.h	2005-06-09	Ilkka Urtamo	[893ef7] Updated sdcc support (devu/3 bug still remains)...
usbcore.c	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
usbcore.h	2007-02-17	Ilkka Urtamo	[0b9cee] Rolled back to previous MCU code due problems w...
usbirboy.prm	2007-01-14	Aapo Tamminen	[be9ba2] v 0.3.0

Read Me

USB-IR-BOY firmware sources
----------------------------

2005-05-02 / AT:

For your convenience, the hex file is available in ../mcubin 
(compiled with CodeWarrior).
 
If you want to compile it yourself, you can use either SDCC or 
Metrowerks CodeWarrior for HC08. However:
- the hex file compiled with SDCC does not work at the moment
- CodeWarrior is only available on Windows, but the stand alone 
compiler and linker run under Wine (the IDE apparently does not).


Building firmware (using CodeWarrior and Wine):
-----------------------------------------------

1. Install Wine, then install CodeWarrior (and its license file)

2. run ./configure cw

3. run make


Building firmware (using sdcc):
---------------------------------

1. Install SDCC (sdcc.sourceforge.net)
 
2. run ./configure sdcc

3. run make


Burning MCU flash using commercial prommer hardware:
 - refer to prommer user manual how to use it

Burning MCU flash using prommer provided by usbirboy project:
---------------------------------------------------------------

First! Get Spgmr08 ( and see that it is fully working )

    1.  Start promming software :
      $ ./spgmr -P /dev/ttySn
      Where n is 0 for COM1 and 1 for COM2 etc.

   2. Select CPU type:
       cpu jb8

   3. Power on the prommer

   4. Clear secure codes: (this will fail but that's ok)
       scodes try blank

   5. Erase device:
       erase

   6. Power off the prommer

   7. Power on the pormmer

   8. Clear secure codes:
       scodes try blank
      (NOTE: for new, never programmed chip you need to repeat steps 4-8 two times)

   9. Program your hex image:
       program from /path/to/usbirboy.s19 

   10. Exit spgmr08 by pressing Ctrl-D.

 Thats it. Have fun.


Author: Ilkka Urtamo