mirror of https://github.com/wwarthen/RomWBW.git
b1ackmai1er
7 years ago
committed by
GitHub
GitHub
14 changed files with 8299 additions and 1 deletions
@ -0,0 +1,17 @@ |
|||||
|
@echo off |
||||
|
setlocal |
||||
|
|
||||
|
set TOOLS=../../../Tools |
||||
|
|
||||
|
set PATH=%TOOLS%\tasm32;%TOOLS%\zx;%PATH% |
||||
|
|
||||
|
set TASMTABS=%TOOLS%\tasm32 |
||||
|
|
||||
|
set ZXBINDIR=%TOOLS%/cpm/bin/ |
||||
|
set ZXLIBDIR=%TOOLS%/cpm/lib/ |
||||
|
set ZXINCDIR=%TOOLS%/cpm/include/ |
||||
|
|
||||
|
zx z80mr camel80 |
||||
|
zx MLOAD25 -camel80.bin=camel80.hex |
||||
|
|
||||
|
goto :eof |
||||
@ -0,0 +1,7 @@ |
|||||
|
@echo off |
||||
|
setlocal |
||||
|
|
||||
|
if exist *.bin del *.bin |
||||
|
if exist *.lst del *.lst |
||||
|
if exist *.prn del *.prn |
||||
|
if exist *.hex del *.hex |
||||
File diff suppressed because it is too large
Binary file not shown.
@ -0,0 +1,354 @@ |
|||||
|
:100100002A06002E0025F924E5DDE12525E5FDE19F |
||||
|
:10011000110100C3A9160000000445584954DD5ED2 |
||||
|
:1001200000DD23DD5600DD23EB5E235623EBE919CA |
||||
|
:100130000100034C4954C51A4F131A4713EB5E23B1 |
||||
|
:100140005623EBE9320100074558454355544560B5 |
||||
|
:1001500069C1E9DD2BDD7200DD2BDD7300E15E237B |
||||
|
:100160005623EBE9470100085641524941424C45AC |
||||
|
:10017000CD53011513360101009208230F1E01E132 |
||||
|
:10018000C5444DEB5E235623EBE967010008434F5E |
||||
|
:100190004E5354414E54CD53011513310F4713E1C3 |
||||
|
:1001A000C54E2346EB5E235623EBE98D0100045533 |
||||
|
:1001B000534552CD53011513310F4713E1C54E235B |
||||
|
:1001C00046FDE5E109444DEB5E235623EBE9DD2BCB |
||||
|
:1001D000DD7200DD2BDD7300D1E1C5444DEB5E2304 |
||||
|
:1001E0005623EBE9AE01000442444F53EBD1E5DD69 |
||||
|
:1001F000E5FDE5CD05004F0600FDE1DDE1D1EB5E5B |
||||
|
:10020000235623EBE9E7010004454D4954CD530142 |
||||
|
:1002100036010600EC01D7021E0108020007534117 |
||||
|
:1002200056454B4559CD7F0100001D0200044B454A |
||||
|
:10023000593FCD53013601FF0036010600EC01B4F1 |
||||
|
:10024000022502E2031E012D0200034B4559CD5346 |
||||
|
:1002500001250205047E05310663023202D7021B26 |
||||
|
:1002600006510225020504360100002502E2031EA4 |
||||
|
:10027000014A02000943504D414343455054CD5378 |
||||
|
:1002800001E7023601020061043103E203B40236E1 |
||||
|
:10029000010A00EC01D702E104050436010A000D51 |
||||
|
:1002A000021E0174020003425945C30000A6020069 |
||||
|
:1002B00003445550C5EB5E235623EBE9B00200041E |
||||
|
:1002C0003F44555078B120ECEB5E235623EBE9BF59 |
||||
|
:1002D00002000444524F50C1EB5E235623EBE9D297 |
||||
|
:1002E00002000453574150E1C5444DEB5E235623B1 |
||||
|
:1002F000EBE9E20200044F564552E1E5C5444DEBFF |
||||
|
:100300005E235623EBE9F5020003524F54E1E3C5A7 |
||||
|
:10031000444DEB5E235623EBE9090300034E49509D |
||||
|
:10032000CD5301E702D7021E011C030004545543BC |
||||
|
:100330004BCD5301E702FA021E012C0300023E528C |
||||
|
:10034000DD2BDD7000DD2BDD7100C1EB5E2356235C |
||||
|
:10035000EBE93D030002523EC5DD4E00DD23DD46E4 |
||||
|
:1003600000DD23EB5E235623EBE9550300025240E8 |
||||
|
:10037000C5DD4E00DD4601EB5E235623EBE96D0340 |
||||
|
:100380000003535040C521000039444DEB5E235615 |
||||
|
:1003900023EBE9810300035350216069F9C1EB5E4F |
||||
|
:1003A000235623EBE996030003525040C5DDE5C117 |
||||
|
:1003B000EB5E235623EBE9A8030003525021C5DD71 |
||||
|
:1003C000E1C1EB5E235623EBE9BA0300012160692A |
||||
|
:1003D000C1712370C1EB5E235623EBE9CC0300020D |
||||
|
:1003E00043216069C171C1EB5E235623EBE9DF0352 |
||||
|
:1003F00000014060694E2346EB5E235623EBE9F192 |
||||
|
:1004000003000243400A4F0600EB5E235623EBE94C |
||||
|
:1004100002040003504321E1ED69C1EB5E23562342 |
||||
|
:10042000EBE913040003504340ED480600EB5E2364 |
||||
|
:100430005623EBE9250400012BE109444DEB5E2333 |
||||
|
:100440005623EBE9370400024D2BEBD1E309424B75 |
||||
|
:10045000300103D1E5EB5E235623EBE947040001AD |
||||
|
:100460002DE1B7ED42444DEB5E235623EBE95F04EB |
||||
|
:100470000003414E44E178A44779A54FEB5E235633 |
||||
|
:1004800023EBE9710400024F52E178B44779B54F8C |
||||
|
:10049000EB5E235623EBE986040003584F52E178C4 |
||||
|
:1004A000AC4779AD4FEB5E235623EBE99A04000687 |
||||
|
:1004B000494E56455254782F47792F4FEB5E2356BD |
||||
|
:1004C00023EBE9AF0400064E4547415445782F47DA |
||||
|
:1004D000792F4F03EB5E235623EBE9C6040002316C |
||||
|
:1004E0002B03EB5E235623EBE9DE040002312D0BD8 |
||||
|
:1004F000EB5E235623EBE9EC0400023E3C78414FCF |
||||
|
:10050000EB5E235623EBE9FA040002322ACB21CB1F |
||||
|
:1005100010EB5E235623EBE90A050002322FCB28AD |
||||
|
:10052000CB19EB5E235623EBE91B0500064C534821 |
||||
|
:1005300049465441E10418012910FD444DEB5E2366 |
||||
|
:100540005623EBE92C05000652534849465441E135 |
||||
|
:10055000041804CB3CCB1D10FA444DEB5E2356230C |
||||
|
:10056000EBE9470500022B21E10A8502030A8C0210 |
||||
|
:10057000C1EB5E235623EBE965050002303D78B1FF |
||||
|
:10058000D6019F474FEB5E235623EBE97B05000224 |
||||
|
:10059000303CCB209F474FEB5E235623EBE98F0582 |
||||
|
:1005A00000013DE1B7ED422828010000EB5E235633 |
||||
|
:1005B00023EBE9A10500023C3ECD5301A3057E05D6 |
||||
|
:1005C0001E01B60500013CE1B7ED42EADB05F2A9E8 |
||||
|
:1005D0000501FFFFEB5E235623EBE9FAA90518F1AD |
||||
|
:1005E000C50500013ECD5301E702C7051E01E30525 |
||||
|
:1005F0000002553CE1B7ED429F474FEB5E23562387 |
||||
|
:10060000EBE9F1050002553ECD5301E702F4051E6A |
||||
|
:1006100001050600064252414E43481A6F131A67FD |
||||
|
:100620005E235623EBE9140600073F4252414E4336 |
||||
|
:100630004878B1C128E51313EB5E235623EBE92973 |
||||
|
:1006400006000428444F29EBE3EB210080B7ED526C |
||||
|
:10065000DD2BDD7400DD2BDD750009DD2BDD740085 |
||||
|
:10066000DD2BDD7500D1C1EB5E235623EBE942069D |
||||
|
:100670000006284C4F4F5029D9010100DD6E00DDE6 |
||||
|
:100680006601B7ED4AEA9106DD7500DD7401D918FF |
||||
|
:100690008A010400DD09D91313EB5E235623EBE92D |
||||
|
:1006A00071060007282B4C4F4F5029E1C5444DD906 |
||||
|
:1006B000C118C9A306000149C5DD6E00DD6601DD74 |
||||
|
:1006C0004E02DD4603B7ED42444DEB5E235623EB6D |
||||
|
:1006D000E9B60600014AC5DD6E04DD6605DD4E069D |
||||
|
:1006E000DD4607B7ED42444DEB5E235623EBE9D4DC |
||||
|
:1006F000060006554E4C4F4F50DD23DD23DD23DD34 |
||||
|
:1007000023EB5E235623EBE9F2060003554D2AC581 |
||||
|
:10071000D9C1D12100003E11B7CB1CCB1DCB1ACBC8 |
||||
|
:100720001B3001093D20F2D5E5D9C1EB5E235623EC |
||||
|
:10073000EBE90B070006554D2F4D4F44C5D9C1E1DC |
||||
|
:10074000D13E10CB23CB12ED6A3006B7ED42B7187D |
||||
|
:1007500006ED4230020937CB13CB123D20E97A2F48 |
||||
|
:10076000477B2F4FE5C5D9C1EB5E235623EBE93517 |
||||
|
:1007700007000446494C4C79D9C1D1B721FFFFEDA0 |
||||
|
:100780004A30091228060B626B13EDB0D9C1EB5E3B |
||||
|
:10079000235623EBE972070005434D4F5645C5D953 |
||||
|
:1007A000C1D1E178B12802EDB0D9C1EB5E23562367 |
||||
|
:1007B000EBE998070006434D4F56453EC5D9C1E1C8 |
||||
|
:1007C000D178B12807092BEB092BEDB8D9C1EB5E25 |
||||
|
:1007D000235623EBE9B5070004534B495079D9C19F |
||||
|
:1007E000E15F78B1280C7BEDA12005EAE70718024C |
||||
|
:1007F000032BE5C5D9C1EB5E235623EBE9D80700EF |
||||
|
:10080000045343414E79D9C1E15F78B128077BEDAC |
||||
|
:10081000B12002032BE5C5D9C1EB5E235623EBE9DA |
||||
|
:1008200000080002533DC5D9C1E1D178B128091AA9 |
||||
|
:1008300013EDA12009EA2F08D901000018082BBEEA |
||||
|
:100840009FD947F6014FEB5E235623EBE9230800BF |
||||
|
:1008500005414C49474EEB5E235623EBE950080017 |
||||
|
:1008600007414C49474E454418EC60080004434595 |
||||
|
:100870004C4CCD9F0102006D08000543454C4C2BAC |
||||
|
:100880000303EB5E235623EBE97A08000543454C4E |
||||
|
:100890004C53C30D058C080005434841522BC3E15E |
||||
|
:1008A0000498080005434841525318AAA4080005BB |
||||
|
:1008B0003E424F4459CD53013601030039041E0115 |
||||
|
:1008C000AF080008434F4D50494C452CC3310FC36E |
||||
|
:1008D000080003214346CD53013601CD00FA02E260 |
||||
|
:1008E00003E104CE031E01D20800032C4346CD537E |
||||
|
:1008F00001110FD60836010300230F1E01EA08007C |
||||
|
:100900000621434F4C4F4ECD53013601FDFF230FBF |
||||
|
:1009100036015301EE081E01000900052C45584917 |
||||
|
:1009200054CD530136011E01CC081E011B090007DE |
||||
|
:100930002C4252414E4348C3310F2F0900052C442D |
||||
|
:10094000455354C3310F3D0900052144455354C359 |
||||
|
:10095000CE0349090002424CCD9F012000550900F9 |
||||
|
:100960000754494253495A45CD9F017C0060090014 |
||||
|
:1009700003544942CD9F018200700900025530CDD9 |
||||
|
:10098000BC0100007C0900033E494ECDBC010200C1 |
||||
|
:100990008709000442415345CDBC0104009309007E |
||||
|
:1009A000055354415445CDBC010600A00900024442 |
||||
|
:1009B00050CDBC010800AE09000727534F555243E4 |
||||
|
:1009C00045CDBC010A00B90900064C4154455354B9 |
||||
|
:1009D000CDBC010E00C90900024850CDBC01100079 |
||||
|
:1009E000D80900024C50CDBC011200E309000253AB |
||||
|
:1009F00030CDBC010001EE090003504144CDBC01E3 |
||||
|
:100A00002801F90900024C30CDBC018001050A0023 |
||||
|
:100A1000025230CDBC010002100A000555494E4972 |
||||
|
:100A200054CD7F01000000000A000000E61600001F |
||||
|
:100A30000000A41600001B0A000523494E4954CDAE |
||||
|
:100A40009F011200390A0003533E44CD5301B40202 |
||||
|
:100A500092051E01470A00073F4E4547415445CDC8 |
||||
|
:100A60005301920531066A0ACD041E01570A00039C |
||||
|
:100A7000414253CD5301B4025F0A1E016F0A0007C1 |
||||
|
:100A8000444E4547415445CD5301E702B604E702C1 |
||||
|
:100A9000B604360101004A041E017F0A00083F44E3 |
||||
|
:100AA0004E4547415445CD530192053106B10A8761 |
||||
|
:100AB0000A1E019D0A000444414253CD5301B40271 |
||||
|
:100AC000A60A1E01B60A00024D2ACD53011B0C9E38 |
||||
|
:100AD000044003E702730AE702730A0F075803A6EC |
||||
|
:100AE0000A1E01C70A0006534D2F52454DCD530132 |
||||
|
:100AF0001B0C9E044003FA024003730A4003BB0A26 |
||||
|
:100B000058033C07E70258035F0AE70258035F0AED |
||||
|
:100B10001E01E60A0006464D2F4D4F44CD5301B449 |
||||
|
:100B2000024003ED0AB402920531063B0BE702587E |
||||
|
:100B3000033904E702EF041B063F0B5803D7021EDC |
||||
|
:100B400001150B00012ACD5301CA0AD7021E014428 |
||||
|
:100B50000B00042F4D4F44CD530140034B0A580363 |
||||
|
:100B60001C0B1E01520B00012FCD5301570B20030C |
||||
|
:100B70001E01670B00034D4F44CD5301570BD702A5 |
||||
|
:100B80001E01750B00052A2F4D4F44CD5301400324 |
||||
|
:100B9000CA0A58031C0B1E01850B00022A2FCD53D5 |
||||
|
:100BA000018B0B20031E019B0B00034D4158CD53BD |
||||
|
:100BB000011B0CC7053106BB0BE702D7021E01AAB9 |
||||
|
:100BC0000B00034D494ECD53011B0CE5053106D3F7 |
||||
|
:100BD0000BE702D7021E01C20B00023240CD5301C7 |
||||
|
:100BE000B4028008F303E702F3031E01DA0B0002EC |
||||
|
:100BF0003221CD5301E702FA02CE038008CE031E54 |
||||
|
:100C000001EF0B00053244524F50CD5301D702D7AC |
||||
|
:100C1000021E01040C000432445550CD5301FA0267 |
||||
|
:100C2000FA021E01160C00053253574150CD5301F4 |
||||
|
:100C30000D0340030D0358031E01270C0005324F1E |
||||
|
:100C4000564552CD5301400340031B0C5803580333 |
||||
|
:100C50002D0C1E013D0C0005434F554E54CD530144 |
||||
|
:100C6000B4029E08E70205041E01570C000243521D |
||||
|
:100C7000CD530136010D000D0236010A000D021E92 |
||||
|
:100C8000016D0C00055350414345CD530158090DEA |
||||
|
:100C9000021E01840C0006535041434553CD5301BD |
||||
|
:100CA000B4023106AE0C8A0CEF041B06A00CD7026E |
||||
|
:100CB0001E01960C0004554D494ECD53011B0C08E6 |
||||
|
:100CC000063106C70CE702D7021E01B50C00045519 |
||||
|
:100CD0004D4158CD53011B0CF4053106E00CE702E1 |
||||
|
:100CE000D7021E01CE0C0006414343455054CD535C |
||||
|
:100CF00001FA023904EF04FA024E02B40236010D81 |
||||
|
:100D000000B9053106350DB4020D02B402360108F2 |
||||
|
:100D100000A3053106270DD702EF044003FA02585D |
||||
|
:100D200003D30C1B06310DFA02E203E104FA02BA06 |
||||
|
:100D30000C1B06F90CD7022003E70261041E01E731 |
||||
|
:100D40000C000454595045CD5301C4023106660DC0 |
||||
|
:100D5000FA023904E7024706B80605040D027806D0 |
||||
|
:100D6000580D1B06680DD7021E01420D00042853C2 |
||||
|
:100D70002229CD530158035D0C1B0C39046808402F |
||||
|
:100D8000031E016D0D01025322CD53013601720D78 |
||||
|
:100D9000CC0836012200AB0F0504E1046808230FDC |
||||
|
:100DA0001E01860D01022E22CD5301890D36014709 |
||||
|
:100DB0000DCC081E01A50D000655442F4D4F44CD06 |
||||
|
:100DC000530140033601000070033C070D030D037F |
||||
|
:100DD00058033C070D031E01B80D000355442ACDEE |
||||
|
:100DE0005301B40240030F07D702E70258030F076D |
||||
|
:100DF0000D0339041E01DB0D0004484F4C44CD5354 |
||||
|
:100E0000013601FFFFDB096805DB09F303E2031E7E |
||||
|
:100E100001F90D00023C23CD5301FD09DB09CE038E |
||||
|
:100E20001E01140E00063E4449474954CD5301B4F7 |
||||
|
:100E30000236010900E5053601070075043904365C |
||||
|
:100E400001300039041E01250E000123CD53019805 |
||||
|
:100E500009F303BF0D0D032C0EFE0D1E014A0E00FB |
||||
|
:100E6000022353CD53014C0E1B0C89047E05310621 |
||||
|
:100E7000660E1E01600E0002233ECD53010A0CDBFC |
||||
|
:100E800009F303FD09FA0261041E01770E00045301 |
||||
|
:100E900049474ECD530192053106A20E36012D0071 |
||||
|
:100EA000FE0D1E018E0E0002552ECD5301170E367B |
||||
|
:100EB000010000630E7A0E470D8A0C1E01A70E007A |
||||
|
:100EC000012ECD5301170EB402730A3601000063E0 |
||||
|
:100ED0000E0D03930E7A0E470D8A0C1E01C00E00F4 |
||||
|
:100EE00007444543494D414CCD530136010A009812 |
||||
|
:100EF00009CE031E01E00E0003484558CD530136CC |
||||
|
:100F00000110009809CE031E01F80E000448455256 |
||||
|
:100F100045CD5301B109F3031E010C0F0005414CEF |
||||
|
:100F20004C4F54CD5301B10968051E011D0F00013E |
||||
|
:100F30002CCD5301110FCE03360101009208230F6F |
||||
|
:100F40001E012F0F0002432CCD5301110FE2033677 |
||||
|
:100F5000010100AA08230F1E01450F0006534F553B |
||||
|
:100F6000524345CD5301C109DD0B1E015C0F000743 |
||||
|
:100F70002F535452494E47CD53010D03FA02390401 |
||||
|
:100F80000D030D0361041E016F0F00083E434F5512 |
||||
|
:100F90004E544544CD53011B0CE2039E08E7029ECC |
||||
|
:100FA000071E018B0F0004574F5244CD5301B4026A |
||||
|
:100FB000630F8B09F303770FB40240030D03DD07C2 |
||||
|
:100FC000FA0240030D030508B4023106D00FEF0406 |
||||
|
:100FD000580358030D0361048B096805310361044C |
||||
|
:100FE000110F940F110F5809FA025D0C3904E20336 |
||||
|
:100FF0001E01A60F00074E46413E4C4641CD53010F |
||||
|
:101000003601030061041E01F50F00074E46413E04 |
||||
|
:10101000434641CD53015D0C36017F007504390410 |
||||
|
:101020001E010B100006494D4D45443FCD5301EFC5 |
||||
|
:101030000405041E012510000446494E44CD530109 |
||||
|
:10104000D009F3031B0CFA0205049E082608B4021B |
||||
|
:1010500031065C10D702FD0FF303B4027E053106A2 |
||||
|
:101060004410B40231067A102003B4021310E702D0 |
||||
|
:101070002C107E053601010089041E01381001077D |
||||
|
:101080004C49544552414CCD5301A609F303310656 |
||||
|
:101090009A1036013601CC08310F1E017F10000670 |
||||
|
:1010A00044494749543FCD5301B40236013900E564 |
||||
|
:1010B000053601000175043904B40236014001E52A |
||||
|
:1010C000053601070175046104360130006104B47E |
||||
|
:1010D000029809F303F4051E019F1000053F5349D0 |
||||
|
:1010E000474ECD5301FA02050436012C006104B4C9 |
||||
|
:1010F00002730A36010100A3057504B40231060D1E |
||||
|
:1011000011E104400336010100770F58031E01DC92 |
||||
|
:101110001000073E4E554D424552CD5301B40231A9 |
||||
|
:10112000064D11FA020504A6107E0531063311D7CB |
||||
|
:10113000021E0140032D0C9809F303DF0D58034AEA |
||||
|
:10114000042D0C36010100770F1B061D111E011224 |
||||
|
:101150001100073F4E554D424552CD5301B4023662 |
||||
|
:10116000010000B4020D035D0CE21040031A1131BE |
||||
|
:1011700006811158030A0C0A0C360100001B069167 |
||||
|
:10118000110A0C2003580331068D11CD043601FFDE |
||||
|
:10119000FF1E0152110009494E5445525052455408 |
||||
|
:1011A000CD5301C109F20B360100008B09CE035863 |
||||
|
:1011B00009AB0FB40205043106FB113D10C4023126 |
||||
|
:1011C00006DD11E104A609F3037E0589043106D783 |
||||
|
:1011D000114F011B06D911CC081B06F7115A11310A |
||||
|
:1011E00006E91187101B06F7115D0C470D36013F0C |
||||
|
:1011F000000D02700C78121B06AF11D7021E01966B |
||||
|
:101200001100084556414C55415445CD5301C10983 |
||||
|
:10121000DD0B400340038B09F3034003A011580387 |
||||
|
:101220008B09CE0358035803C109F20B1E010212A9 |
||||
|
:10123000000451554954CD5301080AE609CE031361 |
||||
|
:101240000ABE0336010000A609CE037409B4026881 |
||||
|
:10125000097E028A0CA011A609F3037E0531066BF4 |
||||
|
:1012600012700C720D036F6B20470D1B064B123171 |
||||
|
:1012700012000541424F5254CD5301F1099A0336F1 |
||||
|
:1012800012721200063F41424F5254CD53010D03DA |
||||
|
:1012900031069812470D78120A0C1E0184120106BD |
||||
|
:1012A00041424F525422CD5301890D36018B12CC4D |
||||
|
:1012B000081E019F12000127CD53015809AB0F3DB5 |
||||
|
:1012C000107E05720D013F8B121E01B61200044301 |
||||
|
:1012D000484152CD53015809AB0FE10405041E01EA |
||||
|
:1012E000CE1201065B434841525DCD5301D3123605 |
||||
|
:1012F000013601CC08310F1E01E312010128CD5344 |
||||
|
:101300000136012900AB0FD7021E01FC1200064373 |
||||
|
:101310005245415445CD5301D009F303310F3601F5 |
||||
|
:101320000000480F110FD009CE035809AB0F050478 |
||||
|
:10133000E104230F36017F01EE081E010E130007A2 |
||||
|
:1013400028444F45533E29CD53015803D009F30398 |
||||
|
:101350001310D6081E013F130105444F45533ECDDF |
||||
|
:10136000530136014713CC083601CE01EE081E01A9 |
||||
|
:101370005913010752454355525345CD5301D009E6 |
||||
|
:10138000F3031310CC081E01731301015BCD53014D |
||||
|
:1013900036010000A609CE031E018B1300015DCDAE |
||||
|
:1013A00053013601FFFFA609CE031E019D13000461 |
||||
|
:1013B00048494445CD5301D009F303B4020504362E |
||||
|
:1013C0000180008904E702E2031E01AF1300065208 |
||||
|
:1013D000455645414CCD5301D009F303B4020504F1 |
||||
|
:1013E00036017F007504E702E2031E01CE130009F7 |
||||
|
:1013F000494D4D454449415445CD53013601010005 |
||||
|
:10140000D009F303EF04E2031E01EF1300013ACD0C |
||||
|
:1014100053011513B4139F1307091E010D14010185 |
||||
|
:101420003BCD5301D51321098D131E011F14010358 |
||||
|
:101430005B275DCD5301B81236013601CC08310F60 |
||||
|
:101440001E012F140108504F5354504F4E45CD5399 |
||||
|
:10145000015809AB0F3D10B4027E05720D013F8BA0 |
||||
|
:101460001292053106791436013601CC08310F3657 |
||||
|
:1014700001CC08CC081B067B14CC081E01451401C6 |
||||
|
:10148000024946CD5301360131063709110FB40226 |
||||
|
:1014900043091E01801401045448454ECD530111E7 |
||||
|
:1014A0000FE7024F091E0197140104454C5345CD27 |
||||
|
:1014B000530136011B063709110FB4024309E70235 |
||||
|
:1014C0009C141E01AA140105424547494EC3110F41 |
||||
|
:1014D000C7140105554E54494CCD53013601310610 |
||||
|
:1014E000370943091E01D3140105414741494ECD37 |
||||
|
:1014F000530136011B06370943091E01E914010592 |
||||
|
:101500005748494C45C38314FF14010652455045C2 |
||||
|
:101510004154CD5301E702EF149C141E010B15003A |
||||
|
:10152000023E4CCD53017208E6096805E609F30353 |
||||
|
:10153000CE031E01201500024C3ECD5301E609F3F7 |
||||
|
:1015400003F3037208CD04E60968051E013715018F |
||||
|
:1015500002444FCD530136014706CC08110F360126 |
||||
|
:10156000000023151E0150150007454E444C4F4FF7 |
||||
|
:1015700050CD5301370943093A15C4023106861587 |
||||
|
:101580009C141B0678151E01691501044C4F4F5021 |
||||
|
:10159000CD53013601780671151E018B1501052BFF |
||||
|
:1015A0004C4F4F50CD53013601AB0671151E019EB5 |
||||
|
:1015B0001501054C45415645CD53013601F906CC80 |
||||
|
:1015C0000836011B063709110FB402430923151E03 |
||||
|
:1015D00001B215000657495448494ECD5301FA024D |
||||
|
:1015E0006104400361045803F4051E01D41500048E |
||||
|
:1015F0004D4F5645CD530140031B0CE702B402701A |
||||
|
:10160000033904DB15310611165803BC071B0615F8 |
||||
|
:101610001658039E071E01EF150005444550544817 |
||||
|
:10162000CD53018503F109E70261041E051E011A6D |
||||
|
:1016300016000C454E5649524F4E4D454E543FCD27 |
||||
|
:1016400053010A0C360100001E0132160005574FE7 |
||||
|
:10165000524453CD5301D009F303B4025D0C470D3E |
||||
|
:101660008A0CFD0FF303B4027E0531065A16D70229 |
||||
|
:101670001E014D1600022E53CD53018503F1096161 |
||||
|
:101680000431069F168503F1093601020061044703 |
||||
|
:1016900006B806F303AA0E3601FEFFAB0691161E2E |
||||
|
:1016A0000175160004434F4C44CD5301210A7F09B4 |
||||
|
:1016B0003F0A9E07360180005D0CA011720D235A6F |
||||
|
:1016C00038302043616D656C466F727468207631E6 |
||||
|
:1016D0002E303120203235204A616E2031393935A3 |
||||
|
:0616E0000D0A470D78120F |
||||
|
:0000000000 |
||||
|
1016C00038302043616D656C466F727468207631E6 |
||||
|
:1016D0002E303120203235204A616E20313939 |
||||
File diff suppressed because it is too large
@ -0,0 +1,154 @@ |
|||||
|
; LISTING 3. |
||||
|
; |
||||
|
; =============================================== |
||||
|
; CamelForth for the Zilog Z80 |
||||
|
; Copyright (c) 1994,1995 Bradford J. Rodriguez |
||||
|
; |
||||
|
; This program is free software; you can redistribute it and/or modify |
||||
|
; it under the terms of the GNU General Public License as published by |
||||
|
; the Free Software Foundation; either version 3 of the License, or |
||||
|
; (at your option) any later version. |
||||
|
; |
||||
|
; This program is distributed in the hope that it will be useful, |
||||
|
; but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||
|
; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||
|
; GNU General Public License for more details. |
||||
|
; |
||||
|
; You should have received a copy of the GNU General Public License |
||||
|
; along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||
|
|
||||
|
; Commercial inquiries should be directed to the author at |
||||
|
; 115 First St., #105, Collingwood, Ontario L9Y 4W3 Canada |
||||
|
; or via email to bj@camelforth.com |
||||
|
; |
||||
|
; =============================================== |
||||
|
; CAMEL80D.AZM: CPU and Model Dependencies |
||||
|
; Source code is for the Z80MR macro assembler. |
||||
|
; Forth words are documented as follows: |
||||
|
;* NAME stack -- stack description |
||||
|
; Word names in upper case are from the ANS |
||||
|
; Forth Core word set. Names in lower case are |
||||
|
; "internal" implementation words & extensions. |
||||
|
; |
||||
|
; Direct-Threaded Forth model for Zilog Z80 |
||||
|
; cell size is 16 bits (2 bytes) |
||||
|
; char size is 8 bits (1 byte) |
||||
|
; address unit is 8 bits (1 byte), i.e., |
||||
|
; addresses are byte-aligned. |
||||
|
; =============================================== |
||||
|
|
||||
|
; ALIGNMENT AND PORTABILITY OPERATORS =========== |
||||
|
; Many of these are synonyms for other words, |
||||
|
; and so are defined as CODE words. |
||||
|
|
||||
|
;C ALIGN -- align HERE |
||||
|
head ALIGN,5,ALIGN,docode |
||||
|
noop: next |
||||
|
|
||||
|
;C ALIGNED addr -- a-addr align given addr |
||||
|
head ALIGNED,7,ALIGNED,docode |
||||
|
jr noop |
||||
|
|
||||
|
;Z CELL -- n size of one cell |
||||
|
head CELL,4,CELL,docon |
||||
|
dw 2 |
||||
|
|
||||
|
;C CELL+ a-addr1 -- a-addr2 add cell size |
||||
|
; 2 + ; |
||||
|
head CELLPLUS,5,CELL+,docode |
||||
|
inc bc |
||||
|
inc bc |
||||
|
next |
||||
|
|
||||
|
;C CELLS n1 -- n2 cells->adrs units |
||||
|
head CELLS,5,CELLS,docode |
||||
|
jp twostar |
||||
|
|
||||
|
;C CHAR+ c-addr1 -- c-addr2 add char size |
||||
|
head CHARPLUS,5,CHAR+,docode |
||||
|
jp oneplus |
||||
|
|
||||
|
;C CHARS n1 -- n2 chars->adrs units |
||||
|
head CHARS,5,CHARS,docode |
||||
|
jr noop |
||||
|
|
||||
|
;C >BODY xt -- a-addr adrs of param field |
||||
|
; 3 + ; Z80 (3 byte CALL) |
||||
|
head TOBODY,5,>BODY,docolon |
||||
|
DW LIT,3,PLUS,EXIT |
||||
|
|
||||
|
;X COMPILE, xt -- append execution token |
||||
|
; I called this word ,XT before I discovered that |
||||
|
; it is defined in the ANSI standard as COMPILE,. |
||||
|
; On a DTC Forth this simply appends xt (like , ) |
||||
|
; but on an STC Forth this must append 'CALL xt'. |
||||
|
head COMMAXT,8,'COMPILE,',docode |
||||
|
jp COMMA |
||||
|
|
||||
|
;Z !CF adrs cfa -- set code action of a word |
||||
|
; 0CD OVER C! store 'CALL adrs' instr |
||||
|
; 1+ ! ; Z80 VERSION |
||||
|
; Depending on the implementation this could |
||||
|
; append CALL adrs or JUMP adrs. |
||||
|
head STORECF,3,!CF,docolon |
||||
|
DW LIT,0CDH,OVER,CSTORE |
||||
|
DW ONEPLUS,STORE,EXIT |
||||
|
|
||||
|
;Z ,CF adrs -- append a code field |
||||
|
; HERE !CF 3 ALLOT ; Z80 VERSION (3 bytes) |
||||
|
head COMMACF,3,',CF',docolon |
||||
|
DW HERE,STORECF,LIT,3,ALLOT,EXIT |
||||
|
|
||||
|
;Z !COLON -- change code field to docolon |
||||
|
; -3 ALLOT docolon-adrs ,CF ; |
||||
|
; This should be used immediately after CREATE. |
||||
|
; This is made a distinct word, because on an STC |
||||
|
; Forth, colon definitions have no code field. |
||||
|
head STORCOLON,6,'!COLON',docolon |
||||
|
DW LIT,-3,ALLOT |
||||
|
DW LIT,docolon,COMMACF,EXIT |
||||
|
|
||||
|
;Z ,EXIT -- append hi-level EXIT action |
||||
|
; ['] EXIT ,XT ; |
||||
|
; This is made a distinct word, because on an STC |
||||
|
; Forth, it appends a RET instruction, not an xt. |
||||
|
head CEXIT,5,',EXIT',docolon |
||||
|
DW LIT,EXIT,COMMAXT,EXIT |
||||
|
|
||||
|
; CONTROL STRUCTURES ============================ |
||||
|
; These words allow Forth control structure words |
||||
|
; to be defined portably. |
||||
|
|
||||
|
;Z ,BRANCH xt -- append a branch instruction |
||||
|
; xt is the branch operator to use, e.g. qbranch |
||||
|
; or (loop). It does NOT append the destination |
||||
|
; address. On the Z80 this is equivalent to ,XT. |
||||
|
head COMMABRANCH,7,',BRANCH',docode |
||||
|
jp COMMA |
||||
|
|
||||
|
;Z ,DEST dest -- append a branch address |
||||
|
; This appends the given destination address to |
||||
|
; the branch instruction. On the Z80 this is ',' |
||||
|
; ...other CPUs may use relative addressing. |
||||
|
head COMMADEST,5,',DEST',docode |
||||
|
jp COMMA |
||||
|
|
||||
|
;Z !DEST dest adrs -- change a branch dest'n |
||||
|
; Changes the destination address found at 'adrs' |
||||
|
; to the given 'dest'. On the Z80 this is '!' |
||||
|
; ...other CPUs may need relative addressing. |
||||
|
head STOREDEST,5,'!DEST',docode |
||||
|
jp STORE |
||||
|
|
||||
|
; HEADER STRUCTURE ============================== |
||||
|
; The structure of the Forth dictionary headers |
||||
|
; (name, link, immediate flag, and "smudge" bit) |
||||
|
; does not necessarily differ across CPUs. This |
||||
|
; structure is not easily factored into distinct |
||||
|
; "portable" words; instead, it is implicit in |
||||
|
; the definitions of FIND and CREATE, and also in |
||||
|
; NFA>LFA, NFA>CFA, IMMED?, IMMEDIATE, HIDE, and |
||||
|
; REVEAL. These words must be (substantially) |
||||
|
; rewritten if either the header structure or its |
||||
|
; inherent assumptions are changed. |
||||
|
|
||||
File diff suppressed because it is too large
@ -0,0 +1,93 @@ |
|||||
|
; Listing 1. |
||||
|
; =============================================== |
||||
|
; CamelForth for the Zilog Z80 |
||||
|
; Primitive testing code |
||||
|
; |
||||
|
; This is the "minimal" test of the CamelForth |
||||
|
; kernel. It verifies the threading and nesting |
||||
|
; mechanisms, the stacks, and the primitives |
||||
|
; DUP EMIT EXIT lit branch ONEPLUS. |
||||
|
; It is particularly useful because it does not |
||||
|
; use the DO..LOOP, multiply, or divide words, |
||||
|
; and because it can be used on embedded CPUs. |
||||
|
; The numeric display word .A is also useful |
||||
|
; for testing the rest of the Core wordset. |
||||
|
; |
||||
|
; The required macros and CPU initialization |
||||
|
; are in file CAMEL80.AZM. |
||||
|
; =============================================== |
||||
|
|
||||
|
;Z >< u1 -- u2 swap the bytes of TOS |
||||
|
head SWAB,2,><,docode |
||||
|
ld a,b |
||||
|
ld b,c |
||||
|
ld c,a |
||||
|
next |
||||
|
|
||||
|
;Z LO c1 -- c2 return low nybble of TOS |
||||
|
head LO,2,LO,docode |
||||
|
ld a,c |
||||
|
and 0fh |
||||
|
ld c,a |
||||
|
ld b,0 |
||||
|
next |
||||
|
|
||||
|
;Z HI c1 -- c2 return high nybble of TOS |
||||
|
head HI,2,HI,docode |
||||
|
ld a,c |
||||
|
and 0f0h |
||||
|
rrca |
||||
|
rrca |
||||
|
rrca |
||||
|
rrca |
||||
|
ld c,a |
||||
|
ld b,0 |
||||
|
next |
||||
|
|
||||
|
;Z >HEX c1 -- c2 convert nybble to hex char |
||||
|
head TOHEX,4,>HEX,docode |
||||
|
ld a,c |
||||
|
sub 0ah |
||||
|
jr c,numeric |
||||
|
add a,7 |
||||
|
numeric: add a,3ah |
||||
|
ld c,a |
||||
|
next |
||||
|
|
||||
|
;Z .HH c -- print byte as 2 hex digits |
||||
|
; DUP HI >HEX EMIT LO >HEX EMIT ; |
||||
|
head DOTHH,3,.HH,docolon |
||||
|
DW DUP,HI,TOHEX,EMIT,LO,TOHEX,EMIT,EXIT |
||||
|
|
||||
|
;Z .B a -- a+1 fetch & print byte, advancing |
||||
|
; DUP C@ .HH 20 EMIT 1+ ; |
||||
|
head DOTB,2,.B,docolon |
||||
|
DW DUP,CFETCH,DOTHH,lit,20h,EMIT,ONEPLUS,EXIT |
||||
|
|
||||
|
;Z .A u -- print unsigned as 4 hex digits |
||||
|
; DUP >< .HH .HH 20 EMIT ; |
||||
|
head DOTA,2,.A,docolon |
||||
|
DW DUP,SWAB,DOTHH,DOTHH,lit,20h,EMIT,EXIT |
||||
|
|
||||
|
;X DUMP addr u -- dump u locations at addr |
||||
|
; 0 DO |
||||
|
; I 15 AND 0= IF CR DUP .A THEN |
||||
|
; .B |
||||
|
; LOOP DROP ; |
||||
|
head DUMP,4,DUMP,docolon |
||||
|
DW LIT,0,XDO |
||||
|
DUMP2: DW II,LIT,15,AND,ZEROEQUAL,qbranch,DUMP1 |
||||
|
DW CR,DUP,DOTA |
||||
|
DUMP1: DW DOTB,XLOOP,DUMP2,DROP,EXIT |
||||
|
|
||||
|
;Z ZQUIT -- endless dump for testing |
||||
|
; 0 BEGIN 0D EMIT 0A EMIT DUP .A |
||||
|
; .B .B .B .B .B .B .B .B |
||||
|
; .B .B .B .B .B .B .B .B |
||||
|
; AGAIN ; |
||||
|
head ZQUIT,5,ZQUIT,docolon |
||||
|
DW lit,0 |
||||
|
zquit1: DW lit,0dh,EMIT,lit,0ah,EMIT,DUP,DOTA |
||||
|
DW DOTB,DOTB,DOTB,DOTB,DOTB,DOTB,DOTB,DOTB |
||||
|
DW DOTB,DOTB,DOTB,DOTB,DOTB,DOTB,DOTB,DOTB |
||||
|
DW branch,zquit1 |
||||
@ -0,0 +1,7 @@ |
|||||
|
;Z DUMP adr n -- +++TEMP+++ |
||||
|
; 1 UMAX 0 DO .B LOOP DROP ; |
||||
|
head DUMP,4,DUMP,docolon |
||||
|
DW LIT,1,UMAX,LIT,0,XDO |
||||
|
DUMP1: DW DOTB,XLOOP,DUMP1 |
||||
|
DW DROP,EXIT |
||||
|
|
||||
@ -0,0 +1,674 @@ |
|||||
|
GNU GENERAL PUBLIC LICENSE |
||||
|
Version 3, 29 June 2007 |
||||
|
|
||||
|
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
||||
|
Everyone is permitted to copy and distribute verbatim copies |
||||
|
of this license document, but changing it is not allowed. |
||||
|
|
||||
|
Preamble |
||||
|
|
||||
|
The GNU General Public License is a free, copyleft license for |
||||
|
software and other kinds of works. |
||||
|
|
||||
|
The licenses for most software and other practical works are designed |
||||
|
to take away your freedom to share and change the works. By contrast, |
||||
|
the GNU General Public License is intended to guarantee your freedom to |
||||
|
share and change all versions of a program--to make sure it remains free |
||||
|
software for all its users. We, the Free Software Foundation, use the |
||||
|
GNU General Public License for most of our software; it applies also to |
||||
|
any other work released this way by its authors. You can apply it to |
||||
|
your programs, too. |
||||
|
|
||||
|
When we speak of free software, we are referring to freedom, not |
||||
|
price. Our General Public Licenses are designed to make sure that you |
||||
|
have the freedom to distribute copies of free software (and charge for |
||||
|
them if you wish), that you receive source code or can get it if you |
||||
|
want it, that you can change the software or use pieces of it in new |
||||
|
free programs, and that you know you can do these things. |
||||
|
|
||||
|
To protect your rights, we need to prevent others from denying you |
||||
|
these rights or asking you to surrender the rights. Therefore, you have |
||||
|
certain responsibilities if you distribute copies of the software, or if |
||||
|
you modify it: responsibilities to respect the freedom of others. |
||||
|
|
||||
|
For example, if you distribute copies of such a program, whether |
||||
|
gratis or for a fee, you must pass on to the recipients the same |
||||
|
freedoms that you received. You must make sure that they, too, receive |
||||
|
or can get the source code. And you must show them these terms so they |
||||
|
know their rights. |
||||
|
|
||||
|
Developers that use the GNU GPL protect your rights with two steps: |
||||
|
(1) assert copyright on the software, and (2) offer you this License |
||||
|
giving you legal permission to copy, distribute and/or modify it. |
||||
|
|
||||
|
For the developers' and authors' protection, the GPL clearly explains |
||||
|
that there is no warranty for this free software. For both users' and |
||||
|
authors' sake, the GPL requires that modified versions be marked as |
||||
|
changed, so that their problems will not be attributed erroneously to |
||||
|
authors of previous versions. |
||||
|
|
||||
|
Some devices are designed to deny users access to install or run |
||||
|
modified versions of the software inside them, although the manufacturer |
||||
|
can do so. This is fundamentally incompatible with the aim of |
||||
|
protecting users' freedom to change the software. The systematic |
||||
|
pattern of such abuse occurs in the area of products for individuals to |
||||
|
use, which is precisely where it is most unacceptable. Therefore, we |
||||
|
have designed this version of the GPL to prohibit the practice for those |
||||
|
products. If such problems arise substantially in other domains, we |
||||
|
stand ready to extend this provision to those domains in future versions |
||||
|
of the GPL, as needed to protect the freedom of users. |
||||
|
|
||||
|
Finally, every program is threatened constantly by software patents. |
||||
|
States should not allow patents to restrict development and use of |
||||
|
software on general-purpose computers, but in those that do, we wish to |
||||
|
avoid the special danger that patents applied to a free program could |
||||
|
make it effectively proprietary. To prevent this, the GPL assures that |
||||
|
patents cannot be used to render the program non-free. |
||||
|
|
||||
|
The precise terms and conditions for copying, distribution and |
||||
|
modification follow. |
||||
|
|
||||
|
TERMS AND CONDITIONS |
||||
|
|
||||
|
0. Definitions. |
||||
|
|
||||
|
"This License" refers to version 3 of the GNU General Public License. |
||||
|
|
||||
|
"Copyright" also means copyright-like laws that apply to other kinds of |
||||
|
works, such as semiconductor masks. |
||||
|
|
||||
|
"The Program" refers to any copyrightable work licensed under this |
||||
|
License. Each licensee is addressed as "you". "Licensees" and |
||||
|
"recipients" may be individuals or organizations. |
||||
|
|
||||
|
To "modify" a work means to copy from or adapt all or part of the work |
||||
|
in a fashion requiring copyright permission, other than the making of an |
||||
|
exact copy. The resulting work is called a "modified version" of the |
||||
|
earlier work or a work "based on" the earlier work. |
||||
|
|
||||
|
A "covered work" means either the unmodified Program or a work based |
||||
|
on the Program. |
||||
|
|
||||
|
To "propagate" a work means to do anything with it that, without |
||||
|
permission, would make you directly or secondarily liable for |
||||
|
infringement under applicable copyright law, except executing it on a |
||||
|
computer or modifying a private copy. Propagation includes copying, |
||||
|
distribution (with or without modification), making available to the |
||||
|
public, and in some countries other activities as well. |
||||
|
|
||||
|
To "convey" a work means any kind of propagation that enables other |
||||
|
parties to make or receive copies. Mere interaction with a user through |
||||
|
a computer network, with no transfer of a copy, is not conveying. |
||||
|
|
||||
|
An interactive user interface displays "Appropriate Legal Notices" |
||||
|
to the extent that it includes a convenient and prominently visible |
||||
|
feature that (1) displays an appropriate copyright notice, and (2) |
||||
|
tells the user that there is no warranty for the work (except to the |
||||
|
extent that warranties are provided), that licensees may convey the |
||||
|
work under this License, and how to view a copy of this License. If |
||||
|
the interface presents a list of user commands or options, such as a |
||||
|
menu, a prominent item in the list meets this criterion. |
||||
|
|
||||
|
1. Source Code. |
||||
|
|
||||
|
The "source code" for a work means the preferred form of the work |
||||
|
for making modifications to it. "Object code" means any non-source |
||||
|
form of a work. |
||||
|
|
||||
|
A "Standard Interface" means an interface that either is an official |
||||
|
standard defined by a recognized standards body, or, in the case of |
||||
|
interfaces specified for a particular programming language, one that |
||||
|
is widely used among developers working in that language. |
||||
|
|
||||
|
The "System Libraries" of an executable work include anything, other |
||||
|
than the work as a whole, that (a) is included in the normal form of |
||||
|
packaging a Major Component, but which is not part of that Major |
||||
|
Component, and (b) serves only to enable use of the work with that |
||||
|
Major Component, or to implement a Standard Interface for which an |
||||
|
implementation is available to the public in source code form. A |
||||
|
"Major Component", in this context, means a major essential component |
||||
|
(kernel, window system, and so on) of the specific operating system |
||||
|
(if any) on which the executable work runs, or a compiler used to |
||||
|
produce the work, or an object code interpreter used to run it. |
||||
|
|
||||
|
The "Corresponding Source" for a work in object code form means all |
||||
|
the source code needed to generate, install, and (for an executable |
||||
|
work) run the object code and to modify the work, including scripts to |
||||
|
control those activities. However, it does not include the work's |
||||
|
System Libraries, or general-purpose tools or generally available free |
||||
|
programs which are used unmodified in performing those activities but |
||||
|
which are not part of the work. For example, Corresponding Source |
||||
|
includes interface definition files associated with source files for |
||||
|
the work, and the source code for shared libraries and dynamically |
||||
|
linked subprograms that the work is specifically designed to require, |
||||
|
such as by intimate data communication or control flow between those |
||||
|
subprograms and other parts of the work. |
||||
|
|
||||
|
The Corresponding Source need not include anything that users |
||||
|
can regenerate automatically from other parts of the Corresponding |
||||
|
Source. |
||||
|
|
||||
|
The Corresponding Source for a work in source code form is that |
||||
|
same work. |
||||
|
|
||||
|
2. Basic Permissions. |
||||
|
|
||||
|
All rights granted under this License are granted for the term of |
||||
|
copyright on the Program, and are irrevocable provided the stated |
||||
|
conditions are met. This License explicitly affirms your unlimited |
||||
|
permission to run the unmodified Program. The output from running a |
||||
|
covered work is covered by this License only if the output, given its |
||||
|
content, constitutes a covered work. This License acknowledges your |
||||
|
rights of fair use or other equivalent, as provided by copyright law. |
||||
|
|
||||
|
You may make, run and propagate covered works that you do not |
||||
|
convey, without conditions so long as your license otherwise remains |
||||
|
in force. You may convey covered works to others for the sole purpose |
||||
|
of having them make modifications exclusively for you, or provide you |
||||
|
with facilities for running those works, provided that you comply with |
||||
|
the terms of this License in conveying all material for which you do |
||||
|
not control copyright. Those thus making or running the covered works |
||||
|
for you must do so exclusively on your behalf, under your direction |
||||
|
and control, on terms that prohibit them from making any copies of |
||||
|
your copyrighted material outside their relationship with you. |
||||
|
|
||||
|
Conveying under any other circumstances is permitted solely under |
||||
|
the conditions stated below. Sublicensing is not allowed; section 10 |
||||
|
makes it unnecessary. |
||||
|
|
||||
|
3. Protecting Users' Legal Rights From Anti-Circumvention Law. |
||||
|
|
||||
|
No covered work shall be deemed part of an effective technological |
||||
|
measure under any applicable law fulfilling obligations under article |
||||
|
11 of the WIPO copyright treaty adopted on 20 December 1996, or |
||||
|
similar laws prohibiting or restricting circumvention of such |
||||
|
measures. |
||||
|
|
||||
|
When you convey a covered work, you waive any legal power to forbid |
||||
|
circumvention of technological measures to the extent such circumvention |
||||
|
is effected by exercising rights under this License with respect to |
||||
|
the covered work, and you disclaim any intention to limit operation or |
||||
|
modification of the work as a means of enforcing, against the work's |
||||
|
users, your or third parties' legal rights to forbid circumvention of |
||||
|
technological measures. |
||||
|
|
||||
|
4. Conveying Verbatim Copies. |
||||
|
|
||||
|
You may convey verbatim copies of the Program's source code as you |
||||
|
receive it, in any medium, provided that you conspicuously and |
||||
|
appropriately publish on each copy an appropriate copyright notice; |
||||
|
keep intact all notices stating that this License and any |
||||
|
non-permissive terms added in accord with section 7 apply to the code; |
||||
|
keep intact all notices of the absence of any warranty; and give all |
||||
|
recipients a copy of this License along with the Program. |
||||
|
|
||||
|
You may charge any price or no price for each copy that you convey, |
||||
|
and you may offer support or warranty protection for a fee. |
||||
|
|
||||
|
5. Conveying Modified Source Versions. |
||||
|
|
||||
|
You may convey a work based on the Program, or the modifications to |
||||
|
produce it from the Program, in the form of source code under the |
||||
|
terms of section 4, provided that you also meet all of these conditions: |
||||
|
|
||||
|
a) The work must carry prominent notices stating that you modified |
||||
|
it, and giving a relevant date. |
||||
|
|
||||
|
b) The work must carry prominent notices stating that it is |
||||
|
released under this License and any conditions added under section |
||||
|
7. This requirement modifies the requirement in section 4 to |
||||
|
"keep intact all notices". |
||||
|
|
||||
|
c) You must license the entire work, as a whole, under this |
||||
|
License to anyone who comes into possession of a copy. This |
||||
|
License will therefore apply, along with any applicable section 7 |
||||
|
additional terms, to the whole of the work, and all its parts, |
||||
|
regardless of how they are packaged. This License gives no |
||||
|
permission to license the work in any other way, but it does not |
||||
|
invalidate such permission if you have separately received it. |
||||
|
|
||||
|
d) If the work has interactive user interfaces, each must display |
||||
|
Appropriate Legal Notices; however, if the Program has interactive |
||||
|
interfaces that do not display Appropriate Legal Notices, your |
||||
|
work need not make them do so. |
||||
|
|
||||
|
A compilation of a covered work with other separate and independent |
||||
|
works, which are not by their nature extensions of the covered work, |
||||
|
and which are not combined with it such as to form a larger program, |
||||
|
in or on a volume of a storage or distribution medium, is called an |
||||
|
"aggregate" if the compilation and its resulting copyright are not |
||||
|
used to limit the access or legal rights of the compilation's users |
||||
|
beyond what the individual works permit. Inclusion of a covered work |
||||
|
in an aggregate does not cause this License to apply to the other |
||||
|
parts of the aggregate. |
||||
|
|
||||
|
6. Conveying Non-Source Forms. |
||||
|
|
||||
|
You may convey a covered work in object code form under the terms |
||||
|
of sections 4 and 5, provided that you also convey the |
||||
|
machine-readable Corresponding Source under the terms of this License, |
||||
|
in one of these ways: |
||||
|
|
||||
|
a) Convey the object code in, or embodied in, a physical product |
||||
|
(including a physical distribution medium), accompanied by the |
||||
|
Corresponding Source fixed on a durable physical medium |
||||
|
customarily used for software interchange. |
||||
|
|
||||
|
b) Convey the object code in, or embodied in, a physical product |
||||
|
(including a physical distribution medium), accompanied by a |
||||
|
written offer, valid for at least three years and valid for as |
||||
|
long as you offer spare parts or customer support for that product |
||||
|
model, to give anyone who possesses the object code either (1) a |
||||
|
copy of the Corresponding Source for all the software in the |
||||
|
product that is covered by this License, on a durable physical |
||||
|
medium customarily used for software interchange, for a price no |
||||
|
more than your reasonable cost of physically performing this |
||||
|
conveying of source, or (2) access to copy the |
||||
|
Corresponding Source from a network server at no charge. |
||||
|
|
||||
|
c) Convey individual copies of the object code with a copy of the |
||||
|
written offer to provide the Corresponding Source. This |
||||
|
alternative is allowed only occasionally and noncommercially, and |
||||
|
only if you received the object code with such an offer, in accord |
||||
|
with subsection 6b. |
||||
|
|
||||
|
d) Convey the object code by offering access from a designated |
||||
|
place (gratis or for a charge), and offer equivalent access to the |
||||
|
Corresponding Source in the same way through the same place at no |
||||
|
further charge. You need not require recipients to copy the |
||||
|
Corresponding Source along with the object code. If the place to |
||||
|
copy the object code is a network server, the Corresponding Source |
||||
|
may be on a different server (operated by you or a third party) |
||||
|
that supports equivalent copying facilities, provided you maintain |
||||
|
clear directions next to the object code saying where to find the |
||||
|
Corresponding Source. Regardless of what server hosts the |
||||
|
Corresponding Source, you remain obligated to ensure that it is |
||||
|
available for as long as needed to satisfy these requirements. |
||||
|
|
||||
|
e) Convey the object code using peer-to-peer transmission, provided |
||||
|
you inform other peers where the object code and Corresponding |
||||
|
Source of the work are being offered to the general public at no |
||||
|
charge under subsection 6d. |
||||
|
|
||||
|
A separable portion of the object code, whose source code is excluded |
||||
|
from the Corresponding Source as a System Library, need not be |
||||
|
included in conveying the object code work. |
||||
|
|
||||
|
A "User Product" is either (1) a "consumer product", which means any |
||||
|
tangible personal property which is normally used for personal, family, |
||||
|
or household purposes, or (2) anything designed or sold for incorporation |
||||
|
into a dwelling. In determining whether a product is a consumer product, |
||||
|
doubtful cases shall be resolved in favor of coverage. For a particular |
||||
|
product received by a particular user, "normally used" refers to a |
||||
|
typical or common use of that class of product, regardless of the status |
||||
|
of the particular user or of the way in which the particular user |
||||
|
actually uses, or expects or is expected to use, the product. A product |
||||
|
is a consumer product regardless of whether the product has substantial |
||||
|
commercial, industrial or non-consumer uses, unless such uses represent |
||||
|
the only significant mode of use of the product. |
||||
|
|
||||
|
"Installation Information" for a User Product means any methods, |
||||
|
procedures, authorization keys, or other information required to install |
||||
|
and execute modified versions of a covered work in that User Product from |
||||
|
a modified version of its Corresponding Source. The information must |
||||
|
suffice to ensure that the continued functioning of the modified object |
||||
|
code is in no case prevented or interfered with solely because |
||||
|
modification has been made. |
||||
|
|
||||
|
If you convey an object code work under this section in, or with, or |
||||
|
specifically for use in, a User Product, and the conveying occurs as |
||||
|
part of a transaction in which the right of possession and use of the |
||||
|
User Product is transferred to the recipient in perpetuity or for a |
||||
|
fixed term (regardless of how the transaction is characterized), the |
||||
|
Corresponding Source conveyed under this section must be accompanied |
||||
|
by the Installation Information. But this requirement does not apply |
||||
|
if neither you nor any third party retains the ability to install |
||||
|
modified object code on the User Product (for example, the work has |
||||
|
been installed in ROM). |
||||
|
|
||||
|
The requirement to provide Installation Information does not include a |
||||
|
requirement to continue to provide support service, warranty, or updates |
||||
|
for a work that has been modified or installed by the recipient, or for |
||||
|
the User Product in which it has been modified or installed. Access to a |
||||
|
network may be denied when the modification itself materially and |
||||
|
adversely affects the operation of the network or violates the rules and |
||||
|
protocols for communication across the network. |
||||
|
|
||||
|
Corresponding Source conveyed, and Installation Information provided, |
||||
|
in accord with this section must be in a format that is publicly |
||||
|
documented (and with an implementation available to the public in |
||||
|
source code form), and must require no special password or key for |
||||
|
unpacking, reading or copying. |
||||
|
|
||||
|
7. Additional Terms. |
||||
|
|
||||
|
"Additional permissions" are terms that supplement the terms of this |
||||
|
License by making exceptions from one or more of its conditions. |
||||
|
Additional permissions that are applicable to the entire Program shall |
||||
|
be treated as though they were included in this License, to the extent |
||||
|
that they are valid under applicable law. If additional permissions |
||||
|
apply only to part of the Program, that part may be used separately |
||||
|
under those permissions, but the entire Program remains governed by |
||||
|
this License without regard to the additional permissions. |
||||
|
|
||||
|
When you convey a copy of a covered work, you may at your option |
||||
|
remove any additional permissions from that copy, or from any part of |
||||
|
it. (Additional permissions may be written to require their own |
||||
|
removal in certain cases when you modify the work.) You may place |
||||
|
additional permissions on material, added by you to a covered work, |
||||
|
for which you have or can give appropriate copyright permission. |
||||
|
|
||||
|
Notwithstanding any other provision of this License, for material you |
||||
|
add to a covered work, you may (if authorized by the copyright holders of |
||||
|
that material) supplement the terms of this License with terms: |
||||
|
|
||||
|
a) Disclaiming warranty or limiting liability differently from the |
||||
|
terms of sections 15 and 16 of this License; or |
||||
|
|
||||
|
b) Requiring preservation of specified reasonable legal notices or |
||||
|
author attributions in that material or in the Appropriate Legal |
||||
|
Notices displayed by works containing it; or |
||||
|
|
||||
|
c) Prohibiting misrepresentation of the origin of that material, or |
||||
|
requiring that modified versions of such material be marked in |
||||
|
reasonable ways as different from the original version; or |
||||
|
|
||||
|
d) Limiting the use for publicity purposes of names of licensors or |
||||
|
authors of the material; or |
||||
|
|
||||
|
e) Declining to grant rights under trademark law for use of some |
||||
|
trade names, trademarks, or service marks; or |
||||
|
|
||||
|
f) Requiring indemnification of licensors and authors of that |
||||
|
material by anyone who conveys the material (or modified versions of |
||||
|
it) with contractual assumptions of liability to the recipient, for |
||||
|
any liability that these contractual assumptions directly impose on |
||||
|
those licensors and authors. |
||||
|
|
||||
|
All other non-permissive additional terms are considered "further |
||||
|
restrictions" within the meaning of section 10. If the Program as you |
||||
|
received it, or any part of it, contains a notice stating that it is |
||||
|
governed by this License along with a term that is a further |
||||
|
restriction, you may remove that term. If a license document contains |
||||
|
a further restriction but permits relicensing or conveying under this |
||||
|
License, you may add to a covered work material governed by the terms |
||||
|
of that license document, provided that the further restriction does |
||||
|
not survive such relicensing or conveying. |
||||
|
|
||||
|
If you add terms to a covered work in accord with this section, you |
||||
|
must place, in the relevant source files, a statement of the |
||||
|
additional terms that apply to those files, or a notice indicating |
||||
|
where to find the applicable terms. |
||||
|
|
||||
|
Additional terms, permissive or non-permissive, may be stated in the |
||||
|
form of a separately written license, or stated as exceptions; |
||||
|
the above requirements apply either way. |
||||
|
|
||||
|
8. Termination. |
||||
|
|
||||
|
You may not propagate or modify a covered work except as expressly |
||||
|
provided under this License. Any attempt otherwise to propagate or |
||||
|
modify it is void, and will automatically terminate your rights under |
||||
|
this License (including any patent licenses granted under the third |
||||
|
paragraph of section 11). |
||||
|
|
||||
|
However, if you cease all violation of this License, then your |
||||
|
license from a particular copyright holder is reinstated (a) |
||||
|
provisionally, unless and until the copyright holder explicitly and |
||||
|
finally terminates your license, and (b) permanently, if the copyright |
||||
|
holder fails to notify you of the violation by some reasonable means |
||||
|
prior to 60 days after the cessation. |
||||
|
|
||||
|
Moreover, your license from a particular copyright holder is |
||||
|
reinstated permanently if the copyright holder notifies you of the |
||||
|
violation by some reasonable means, this is the first time you have |
||||
|
received notice of violation of this License (for any work) from that |
||||
|
copyright holder, and you cure the violation prior to 30 days after |
||||
|
your receipt of the notice. |
||||
|
|
||||
|
Termination of your rights under this section does not terminate the |
||||
|
licenses of parties who have received copies or rights from you under |
||||
|
this License. If your rights have been terminated and not permanently |
||||
|
reinstated, you do not qualify to receive new licenses for the same |
||||
|
material under section 10. |
||||
|
|
||||
|
9. Acceptance Not Required for Having Copies. |
||||
|
|
||||
|
You are not required to accept this License in order to receive or |
||||
|
run a copy of the Program. Ancillary propagation of a covered work |
||||
|
occurring solely as a consequence of using peer-to-peer transmission |
||||
|
to receive a copy likewise does not require acceptance. However, |
||||
|
nothing other than this License grants you permission to propagate or |
||||
|
modify any covered work. These actions infringe copyright if you do |
||||
|
not accept this License. Therefore, by modifying or propagating a |
||||
|
covered work, you indicate your acceptance of this License to do so. |
||||
|
|
||||
|
10. Automatic Licensing of Downstream Recipients. |
||||
|
|
||||
|
Each time you convey a covered work, the recipient automatically |
||||
|
receives a license from the original licensors, to run, modify and |
||||
|
propagate that work, subject to this License. You are not responsible |
||||
|
for enforcing compliance by third parties with this License. |
||||
|
|
||||
|
An "entity transaction" is a transaction transferring control of an |
||||
|
organization, or substantially all assets of one, or subdividing an |
||||
|
organization, or merging organizations. If propagation of a covered |
||||
|
work results from an entity transaction, each party to that |
||||
|
transaction who receives a copy of the work also receives whatever |
||||
|
licenses to the work the party's predecessor in interest had or could |
||||
|
give under the previous paragraph, plus a right to possession of the |
||||
|
Corresponding Source of the work from the predecessor in interest, if |
||||
|
the predecessor has it or can get it with reasonable efforts. |
||||
|
|
||||
|
You may not impose any further restrictions on the exercise of the |
||||
|
rights granted or affirmed under this License. For example, you may |
||||
|
not impose a license fee, royalty, or other charge for exercise of |
||||
|
rights granted under this License, and you may not initiate litigation |
||||
|
(including a cross-claim or counterclaim in a lawsuit) alleging that |
||||
|
any patent claim is infringed by making, using, selling, offering for |
||||
|
sale, or importing the Program or any portion of it. |
||||
|
|
||||
|
11. Patents. |
||||
|
|
||||
|
A "contributor" is a copyright holder who authorizes use under this |
||||
|
License of the Program or a work on which the Program is based. The |
||||
|
work thus licensed is called the contributor's "contributor version". |
||||
|
|
||||
|
A contributor's "essential patent claims" are all patent claims |
||||
|
owned or controlled by the contributor, whether already acquired or |
||||
|
hereafter acquired, that would be infringed by some manner, permitted |
||||
|
by this License, of making, using, or selling its contributor version, |
||||
|
but do not include claims that would be infringed only as a |
||||
|
consequence of further modification of the contributor version. For |
||||
|
purposes of this definition, "control" includes the right to grant |
||||
|
patent sublicenses in a manner consistent with the requirements of |
||||
|
this License. |
||||
|
|
||||
|
Each contributor grants you a non-exclusive, worldwide, royalty-free |
||||
|
patent license under the contributor's essential patent claims, to |
||||
|
make, use, sell, offer for sale, import and otherwise run, modify and |
||||
|
propagate the contents of its contributor version. |
||||
|
|
||||
|
In the following three paragraphs, a "patent license" is any express |
||||
|
agreement or commitment, however denominated, not to enforce a patent |
||||
|
(such as an express permission to practice a patent or covenant not to |
||||
|
sue for patent infringement). To "grant" such a patent license to a |
||||
|
party means to make such an agreement or commitment not to enforce a |
||||
|
patent against the party. |
||||
|
|
||||
|
If you convey a covered work, knowingly relying on a patent license, |
||||
|
and the Corresponding Source of the work is not available for anyone |
||||
|
to copy, free of charge and under the terms of this License, through a |
||||
|
publicly available network server or other readily accessible means, |
||||
|
then you must either (1) cause the Corresponding Source to be so |
||||
|
available, or (2) arrange to deprive yourself of the benefit of the |
||||
|
patent license for this particular work, or (3) arrange, in a manner |
||||
|
consistent with the requirements of this License, to extend the patent |
||||
|
license to downstream recipients. "Knowingly relying" means you have |
||||
|
actual knowledge that, but for the patent license, your conveying the |
||||
|
covered work in a country, or your recipient's use of the covered work |
||||
|
in a country, would infringe one or more identifiable patents in that |
||||
|
country that you have reason to believe are valid. |
||||
|
|
||||
|
If, pursuant to or in connection with a single transaction or |
||||
|
arrangement, you convey, or propagate by procuring conveyance of, a |
||||
|
covered work, and grant a patent license to some of the parties |
||||
|
receiving the covered work authorizing them to use, propagate, modify |
||||
|
or convey a specific copy of the covered work, then the patent license |
||||
|
you grant is automatically extended to all recipients of the covered |
||||
|
work and works based on it. |
||||
|
|
||||
|
A patent license is "discriminatory" if it does not include within |
||||
|
the scope of its coverage, prohibits the exercise of, or is |
||||
|
conditioned on the non-exercise of one or more of the rights that are |
||||
|
specifically granted under this License. You may not convey a covered |
||||
|
work if you are a party to an arrangement with a third party that is |
||||
|
in the business of distributing software, under which you make payment |
||||
|
to the third party based on the extent of your activity of conveying |
||||
|
the work, and under which the third party grants, to any of the |
||||
|
parties who would receive the covered work from you, a discriminatory |
||||
|
patent license (a) in connection with copies of the covered work |
||||
|
conveyed by you (or copies made from those copies), or (b) primarily |
||||
|
for and in connection with specific products or compilations that |
||||
|
contain the covered work, unless you entered into that arrangement, |
||||
|
or that patent license was granted, prior to 28 March 2007. |
||||
|
|
||||
|
Nothing in this License shall be construed as excluding or limiting |
||||
|
any implied license or other defenses to infringement that may |
||||
|
otherwise be available to you under applicable patent law. |
||||
|
|
||||
|
12. No Surrender of Others' Freedom. |
||||
|
|
||||
|
If conditions are imposed on you (whether by court order, agreement or |
||||
|
otherwise) that contradict the conditions of this License, they do not |
||||
|
excuse you from the conditions of this License. If you cannot convey a |
||||
|
covered work so as to satisfy simultaneously your obligations under this |
||||
|
License and any other pertinent obligations, then as a consequence you may |
||||
|
not convey it at all. For example, if you agree to terms that obligate you |
||||
|
to collect a royalty for further conveying from those to whom you convey |
||||
|
the Program, the only way you could satisfy both those terms and this |
||||
|
License would be to refrain entirely from conveying the Program. |
||||
|
|
||||
|
13. Use with the GNU Affero General Public License. |
||||
|
|
||||
|
Notwithstanding any other provision of this License, you have |
||||
|
permission to link or combine any covered work with a work licensed |
||||
|
under version 3 of the GNU Affero General Public License into a single |
||||
|
combined work, and to convey the resulting work. The terms of this |
||||
|
License will continue to apply to the part which is the covered work, |
||||
|
but the special requirements of the GNU Affero General Public License, |
||||
|
section 13, concerning interaction through a network will apply to the |
||||
|
combination as such. |
||||
|
|
||||
|
14. Revised Versions of this License. |
||||
|
|
||||
|
The Free Software Foundation may publish revised and/or new versions of |
||||
|
the GNU General Public License from time to time. Such new versions will |
||||
|
be similar in spirit to the present version, but may differ in detail to |
||||
|
address new problems or concerns. |
||||
|
|
||||
|
Each version is given a distinguishing version number. If the |
||||
|
Program specifies that a certain numbered version of the GNU General |
||||
|
Public License "or any later version" applies to it, you have the |
||||
|
option of following the terms and conditions either of that numbered |
||||
|
version or of any later version published by the Free Software |
||||
|
Foundation. If the Program does not specify a version number of the |
||||
|
GNU General Public License, you may choose any version ever published |
||||
|
by the Free Software Foundation. |
||||
|
|
||||
|
If the Program specifies that a proxy can decide which future |
||||
|
versions of the GNU General Public License can be used, that proxy's |
||||
|
public statement of acceptance of a version permanently authorizes you |
||||
|
to choose that version for the Program. |
||||
|
|
||||
|
Later license versions may give you additional or different |
||||
|
permissions. However, no additional obligations are imposed on any |
||||
|
author or copyright holder as a result of your choosing to follow a |
||||
|
later version. |
||||
|
|
||||
|
15. Disclaimer of Warranty. |
||||
|
|
||||
|
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY |
||||
|
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT |
||||
|
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY |
||||
|
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, |
||||
|
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
||||
|
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM |
||||
|
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF |
||||
|
ALL NECESSARY SERVICING, REPAIR OR CORRECTION. |
||||
|
|
||||
|
16. Limitation of Liability. |
||||
|
|
||||
|
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS |
||||
|
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY |
||||
|
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE |
||||
|
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF |
||||
|
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD |
||||
|
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), |
||||
|
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF |
||||
|
SUCH DAMAGES. |
||||
|
|
||||
|
17. Interpretation of Sections 15 and 16. |
||||
|
|
||||
|
If the disclaimer of warranty and limitation of liability provided |
||||
|
above cannot be given local legal effect according to their terms, |
||||
|
reviewing courts shall apply local law that most closely approximates |
||||
|
an absolute waiver of all civil liability in connection with the |
||||
|
Program, unless a warranty or assumption of liability accompanies a |
||||
|
copy of the Program in return for a fee. |
||||
|
|
||||
|
END OF TERMS AND CONDITIONS |
||||
|
|
||||
|
How to Apply These Terms to Your New Programs |
||||
|
|
||||
|
If you develop a new program, and you want it to be of the greatest |
||||
|
possible use to the public, the best way to achieve this is to make it |
||||
|
free software which everyone can redistribute and change under these terms. |
||||
|
|
||||
|
To do so, attach the following notices to the program. It is safest |
||||
|
to attach them to the start of each source file to most effectively |
||||
|
state the exclusion of warranty; and each file should have at least |
||||
|
the "copyright" line and a pointer to where the full notice is found. |
||||
|
|
||||
|
<one line to give the program's name and a brief idea of what it does.> |
||||
|
Copyright (C) <year> <name of author> |
||||
|
|
||||
|
This program is free software: you can redistribute it and/or modify |
||||
|
it under the terms of the GNU General Public License as published by |
||||
|
the Free Software Foundation, either version 3 of the License, or |
||||
|
(at your option) any later version. |
||||
|
|
||||
|
This program is distributed in the hope that it will be useful, |
||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||
|
GNU General Public License for more details. |
||||
|
|
||||
|
You should have received a copy of the GNU General Public License |
||||
|
along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||
|
|
||||
|
Also add information on how to contact you by electronic and paper mail. |
||||
|
|
||||
|
If the program does terminal interaction, make it output a short |
||||
|
notice like this when it starts in an interactive mode: |
||||
|
|
||||
|
<program> Copyright (C) <year> <name of author> |
||||
|
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
||||
|
This is free software, and you are welcome to redistribute it |
||||
|
under certain conditions; type `show c' for details. |
||||
|
|
||||
|
The hypothetical commands `show w' and `show c' should show the appropriate |
||||
|
parts of the General Public License. Of course, your program's commands |
||||
|
might be different; for a GUI interface, you would use an "about box". |
||||
|
|
||||
|
You should also get your employer (if you work as a programmer) or school, |
||||
|
if any, to sign a "copyright disclaimer" for the program, if necessary. |
||||
|
For more information on this, and how to apply and follow the GNU GPL, see |
||||
|
<http://www.gnu.org/licenses/>. |
||||
|
|
||||
|
The GNU General Public License does not permit incorporating your program |
||||
|
into proprietary programs. If your program is a subroutine library, you |
||||
|
may consider it more useful to permit linking proprietary applications with |
||||
|
the library. If this is what you want to do, use the GNU Lesser General |
||||
|
Public License instead of this License. But first, please read |
||||
|
<http://www.gnu.org/philosophy/why-not-lgpl.html>. |
||||
@ -0,0 +1,184 @@ |
|||||
|
TABLE 1. GLOSSARY OF "HIGH LEVEL" WORDS |
||||
|
(files CAMEL80D.AZM and CAMEL80H.AZM) |
||||
|
|
||||
|
NAME stack in -- stack out description |
||||
|
|
||||
|
Guide to stack diagrams: R: = return stack, |
||||
|
c = 8-bit character, flag = boolean (0 or -1), |
||||
|
n = signed 16-bit, u = unsigned 16-bit, |
||||
|
d = signed 32-bit, ud = unsigned 32-bit, |
||||
|
+n = unsigned 15-bit, x = any cell value, |
||||
|
i*x j*x = any number of cell values, |
||||
|
a-addr = aligned adrs, c-addr = character adrs |
||||
|
p-addr = I/O port adrs, sys = system-specific. |
||||
|
Refer to ANS Forth document for more details. |
||||
|
|
||||
|
ANS Forth Core words |
||||
|
These are required words whose definitions are |
||||
|
specified by the ANS Forth document. |
||||
|
|
||||
|
# ud1 -- ud2 convert 1 digit of output |
||||
|
#S ud1 -- ud2 convert remaining digits |
||||
|
#> ud1 -- c-addr u end conv., get string |
||||
|
' -- xt find word in dictionary |
||||
|
( -- skip input until ) |
||||
|
* n1 n2 -- n3 signed multiply |
||||
|
*/ n1 n2 n3 -- n4 n1*n2/n3 |
||||
|
*/MOD n1 n2 n3 -- n4 n5 n1*n2/n3, rem & quot |
||||
|
+LOOP adrs -- L: 0 a1 a2 .. aN -- |
||||
|
, x -- append cell to dict |
||||
|
/ n1 n2 -- n3 signed divide |
||||
|
/MOD n1 n2 -- n3 n4 signed divide, rem & quot |
||||
|
: -- begin a colon definition |
||||
|
; end a colon definition |
||||
|
<# -- begin numeric conversion |
||||
|
>BODY xt -- a-addr adrs of param field |
||||
|
>IN -- a-addr holds offset into TIB |
||||
|
>NUMBER ud adr u -- ud' adr' u' |
||||
|
convert string to number |
||||
|
2DROP x1 x2 -- drop 2 cells |
||||
|
2DUP x1 x2 -- x1 x2 x1 x2 dup top 2 cells |
||||
|
2OVER x1 x2 x3 x4 -- x1 x2 x3 x4 x1 x2 per diag |
||||
|
2SWAP x1 x2 x3 x4 -- x3 x4 x1 x2 per diagram |
||||
|
2! x1 x2 a-addr -- store 2 cells |
||||
|
2@ a-addr -- x1 x2 fetch 2 cells |
||||
|
ABORT i*x -- R: j*x -- clear stack & QUIT |
||||
|
ABORT" i*x 0 -- i*x R: j*x -- j*x print msg & |
||||
|
i*x x1 -- R: j*x -- abort,x1<>0 |
||||
|
ABS n1 -- +n2 absolute value |
||||
|
ACCEPT c-addr +n -- +n' get line from terminal |
||||
|
ALIGN -- align HERE |
||||
|
ALIGNED addr -- a-addr align given addr |
||||
|
ALLOT n -- allocate n bytes in dict |
||||
|
BASE -- a-addr holds conversion radix |
||||
|
BEGIN -- adrs target for backward branch |
||||
|
BL -- char an ASCII space |
||||
|
C, char -- append char to dict |
||||
|
CELLS n1 -- n2 cells->adrs units |
||||
|
CELL+ a-addr1 -- a-addr2 add cell size to adrs |
||||
|
CHAR -- char parse ASCII character |
||||
|
CHARS n1 -- n2 chars->adrs units |
||||
|
CHAR+ c-addr1 -- c-addr2 add char size to adrs |
||||
|
COUNT c-addr1 -- c-addr2 u counted->adr/len |
||||
|
CR -- output newline |
||||
|
CREATE -- create an empty definition |
||||
|
DECIMAL -- set number base to decimal |
||||
|
DEPTH -- +n number of items on stack |
||||
|
DO -- adrs L: -- 0 start of DO..LOOP |
||||
|
DOES> -- change action of latest def'n |
||||
|
ELSE adrs1 -- adrs2 branch for IF..ELSE |
||||
|
ENVIRONMENT? c-addr u -- false system query |
||||
|
EVALUATE i*x c-addr u -- j*x interpret string |
||||
|
FIND c-addr -- c-addr 0 ..if name not found |
||||
|
xt 1 ..if immediate |
||||
|
xt -1 ..if "normal" |
||||
|
FM/MOD d1 n1 -- n2 n3 floored signed division |
||||
|
HERE -- addr returns dictionary pointer |
||||
|
HOLD char -- add char to output string |
||||
|
IF -- adrs conditional forward branch |
||||
|
IMMEDIATE -- make last def'n immediate |
||||
|
LEAVE -- L: -- adrs exit DO..LOOP |
||||
|
LITERAL x -- append numeric literal to dict. |
||||
|
LOOP adrs -- L: 0 a1 a2 .. aN -- |
||||
|
MAX n1 n2 -- n3 signed maximum |
||||
|
MIN n1 n2 -- n3 signed minimum |
||||
|
MOD n1 n2 -- n3 signed remainder |
||||
|
MOVE addr1 addr2 u -- smart move |
||||
|
M* n1 n2 -- d signed 16*16->32 multiply |
||||
|
POSTPONE -- postpone compile action of word |
||||
|
QUIT -- R: i*x -- interpret from keyboard |
||||
|
RECURSE -- recurse current definition |
||||
|
REPEAT adrs1 adrs2 -- resolve WHILE loop |
||||
|
SIGN n -- add minus sign if n<0 |
||||
|
SM/REM d1 n1 -- n2 n3 symmetric signed division |
||||
|
SOURCE -- adr n current input buffer |
||||
|
SPACE -- output a space |
||||
|
SPACES n -- output n spaces |
||||
|
STATE -- a-addr holds compiler state |
||||
|
S" -- compile in-line string |
||||
|
." -- compile string to print |
||||
|
S>D n -- d single -> double precision |
||||
|
THEN adrs -- resolve forward branch |
||||
|
TYPE c-addr +n -- type line to terminal |
||||
|
UNTIL adrs -- conditional backward branch |
||||
|
U. u -- display u unsigned |
||||
|
. n -- display n signed |
||||
|
WHILE -- adrs branch for WHILE loop |
||||
|
WORD char -- c-addr n parse word delim by char |
||||
|
[ -- enter interpretive state |
||||
|
[CHAR] -- compile character literal |
||||
|
['] -- find word & compile as literal |
||||
|
] -- enter compiling state |
||||
|
|
||||
|
ANS Forth Extensions |
||||
|
These are optional words whose definitions are |
||||
|
specified by the ANS Forth document. |
||||
|
|
||||
|
.S -- print stack contents |
||||
|
/STRING a u n -- a+n u-n trim string |
||||
|
AGAIN adrs -- uncond'l backward branch |
||||
|
COMPILE, xt -- append execution token |
||||
|
DABS d1 -- +d2 absolute value, dbl.prec. |
||||
|
DNEGATE d1 -- d2 negate, double precision |
||||
|
HEX -- set number base to hex |
||||
|
PAD -- a-addr user PAD buffer |
||||
|
TIB -- a-addr Terminal Input Buffer |
||||
|
WITHIN n1|u1 n2|u2 n3|u3 -- f test n2<=n1<n3? |
||||
|
WORDS -- list all words in dict. |
||||
|
|
||||
|
Private Extensions |
||||
|
These are words which are unique to CamelForth. |
||||
|
Many of these are necessary to implement ANS |
||||
|
Forth words, but are not specified by the ANS |
||||
|
document. Others are functions I find useful. |
||||
|
|
||||
|
!CF adrs cfa -- set code action of a word |
||||
|
!COLON -- change code field to docolon |
||||
|
!DEST dest adrs -- change a branch dest'n |
||||
|
#INIT -- n #bytes of user area init data |
||||
|
'SOURCE -- a-addr two cells: len, adrs |
||||
|
(DOES>) -- run-time action of DOES> |
||||
|
(S") -- c-addr u run-time code for S" |
||||
|
,BRANCH xt -- append a branch instruction |
||||
|
,CF adrs -- append a code field |
||||
|
,DEST dest -- append a branch address |
||||
|
,EXIT -- append hi-level EXIT action |
||||
|
>COUNTED src n dst -- copy to counted str |
||||
|
>DIGIT n -- c convert to 0..9A..Z |
||||
|
>L x -- L: -- x move to Leave stack |
||||
|
?ABORT f c-addr u -- abort & print msg |
||||
|
?DNEGATE d1 n -- d2 negate d1 if n negative |
||||
|
?NEGATE n1 n2 -- n3 negate n1 if n2 negative |
||||
|
?NUMBER c-addr -- n -1 convert string->number |
||||
|
-- c-addr 0 if convert error |
||||
|
?SIGN adr n -- adr' n' f get optional sign |
||||
|
advance adr/n if sign; return NZ if negative |
||||
|
CELL -- n size of one cell |
||||
|
COLD -- cold start Forth system |
||||
|
COMPILE -- append inline execution token |
||||
|
DIGIT? c -- n -1 ..if c is a valid digit |
||||
|
-- x 0 ..otherwise |
||||
|
DP -- a-addr holds dictionary ptr |
||||
|
ENDLOOP adrs xt -- L: 0 a1 a2 .. aN -- |
||||
|
HIDE -- "hide" latest definition |
||||
|
HP -- a-addr HOLD pointer |
||||
|
IMMED? nfa -- f fetch immediate flag |
||||
|
INTERPRET i*x c-addr u -- j*x |
||||
|
interpret given buffer |
||||
|
L0 -- a-addr bottom of Leave stack |
||||
|
LATEST -- a-addr last word in dictionary |
||||
|
LP -- a-addr Leave-stack pointer |
||||
|
L> -- x L: x -- move from Leave stack |
||||
|
NFA>CFA nfa -- cfa name adr -> code field |
||||
|
NFA>LFA nfa -- lfa name adr -> link field |
||||
|
R0 -- a-addr end of return stack |
||||
|
REVEAL -- "reveal" latest definition |
||||
|
S0 -- a-addr end of parameter stack |
||||
|
TIBSIZE -- n size of TIB |
||||
|
U0 -- a-addr current user area adrs |
||||
|
UD* ud1 d2 -- ud3 32*16->32 multiply |
||||
|
UD/MOD ud1 u2 -- u3 ud4 32/16->32 divide |
||||
|
UINIT -- addr initial values for user area |
||||
|
UMAX u1 u2 -- u unsigned maximum |
||||
|
UMIN u1 u2 -- u unsigned minimum |
||||
|
|
||||
@ -0,0 +1,112 @@ |
|||||
|
TABLE 1. GLOSSARY OF WORDS IN CAMEL80.AZM |
||||
|
Words which are (usually) written in CODE. |
||||
|
|
||||
|
NAME stack in -- stack out description |
||||
|
|
||||
|
Guide to stack diagrams: R: = return stack, |
||||
|
c = 8-bit character, flag = boolean (0 or -1), |
||||
|
n = signed 16-bit, u = unsigned 16-bit, |
||||
|
d = signed 32-bit, ud = unsigned 32-bit, |
||||
|
+n = unsigned 15-bit, x = any cell value, |
||||
|
i*x j*x = any number of cell values, |
||||
|
a-addr = aligned adrs, c-addr = character adrs |
||||
|
p-addr = I/O port adrs, sys = system-specific. |
||||
|
Refer to ANS Forth document for more details. |
||||
|
|
||||
|
ANS Forth Core words |
||||
|
These are required words whose definitions are |
||||
|
specified by the ANS Forth document. |
||||
|
|
||||
|
! x a-addr -- store cell in memory |
||||
|
+ n1/u1 n2/u2 -- n3/u3 add n1+n2 |
||||
|
+! n/u a-addr -- add cell to memory |
||||
|
- n1/u1 n2/u2 -- n3/u3 subtract n1-n2 |
||||
|
< n1 n2 -- flag test n1<n2, signed |
||||
|
= x1 x2 -- flag test x1=x2 |
||||
|
> n1 n2 -- flag test n1>n2, signed |
||||
|
>R x -- R: -- x push to return stack |
||||
|
?DUP x -- 0 | x x DUP if nonzero |
||||
|
@ a-addr -- x fetch cell from memory |
||||
|
0< n -- flag true if TOS negative |
||||
|
0= n/u -- flag return true if TOS=0 |
||||
|
1+ n1/u1 -- n2/u2 add 1 to TOS |
||||
|
1- n1/u1 -- n2/u2 subtract 1 from TOS |
||||
|
2* x1 -- x2 arithmetic left shift |
||||
|
2/ x1 -- x2 arithmetic right shift |
||||
|
AND x1 x2 -- x3 logical AND |
||||
|
CONSTANT n -- define a Forth constant |
||||
|
C! c c-addr -- store char in memory |
||||
|
C@ c-addr -- c fetch char from memory |
||||
|
DROP x -- drop top of stack |
||||
|
DUP x -- x x duplicate top of stack |
||||
|
EMIT c -- output character to console |
||||
|
EXECUTE i*x xt -- j*x execute Forth word 'xt' |
||||
|
EXIT -- exit a colon definition |
||||
|
FILL c-addr u c -- fill memory with char |
||||
|
I -- n R: sys1 sys2 -- sys1 sys2 |
||||
|
get the innermost loop index |
||||
|
INVERT x1 -- x2 bitwise inversion |
||||
|
J -- n R: 4*sys -- 4*sys |
||||
|
get the second loop index |
||||
|
KEY -- c get character from keyboard |
||||
|
LSHIFT x1 u -- x2 logical L shift u places |
||||
|
NEGATE x1 -- x2 two's complement |
||||
|
OR x1 x2 -- x3 logical OR |
||||
|
OVER x1 x2 -- x1 x2 x1 per stack diagram |
||||
|
ROT x1 x2 x3 -- x2 x3 x1 per stack diagram |
||||
|
RSHIFT x1 u -- x2 logical R shift u places |
||||
|
R> -- x R: x -- pop from return stack |
||||
|
R@ -- x R: x -- x fetch from rtn stk |
||||
|
SWAP x1 x2 -- x2 x1 swap top two items |
||||
|
UM* u1 u2 -- ud unsigned 16x16->32 mult. |
||||
|
UM/MOD ud u1 -- u2 u3 unsigned 32/16->16 div. |
||||
|
UNLOOP -- R: sys1 sys2 -- drop loop parms |
||||
|
U< u1 u2 -- flag test u1<n2, unsigned |
||||
|
VARIABLE -- define a Forth variable |
||||
|
XOR x1 x2 -- x3 logical XOR |
||||
|
|
||||
|
ANS Forth Extensions |
||||
|
These are optional words whose definitions are |
||||
|
specified by the ANS Forth document. |
||||
|
|
||||
|
<> x1 x2 -- flag test not equal |
||||
|
BYE i*x -- return to CP/M |
||||
|
CMOVE c-addr1 c-addr2 u -- move from bottom |
||||
|
CMOVE> c-addr1 c-addr2 u -- move from top |
||||
|
KEY? -- flag return true if char waiting |
||||
|
M+ d1 n -- d2 add single to double |
||||
|
NIP x1 x2 -- x2 per stack diagram |
||||
|
TUCK x1 x2 -- x2 x1 x2 per stack diagram |
||||
|
U> u1 u2 -- flag test u1>u2, unsigned |
||||
|
|
||||
|
Private Extensions |
||||
|
These are words which are unique to CamelForth. |
||||
|
Many of these are necessary to implement ANS |
||||
|
Forth words, but are not specified by the ANS |
||||
|
document. Others are functions I find useful. |
||||
|
|
||||
|
(do) n1|u1 n2|u2 -- R: -- sys1 sys2 |
||||
|
run-time code for DO |
||||
|
(loop) R: sys1 sys2 -- | sys1 sys2 |
||||
|
run-time code for LOOP |
||||
|
(+loop) n -- R: sys1 sys2 -- | sys1 sys2 |
||||
|
run-time code for +LOOP |
||||
|
>< x1 -- x2 swap bytes |
||||
|
?branch x -- branch if TOS zero |
||||
|
BDOS DE C -- A call CP/M BDOS |
||||
|
branch -- branch always |
||||
|
lit -- x fetch inline literal to stack |
||||
|
PC! c p-addr -- output char to port |
||||
|
PC@ p-addr -- c input char from port |
||||
|
RP! a-addr -- set return stack pointer |
||||
|
RP@ -- a-addr get return stack pointer |
||||
|
SCAN c-addr1 u1 c -- c-addr2 u2 |
||||
|
find matching char |
||||
|
SKIP c-addr1 u1 c -- c-addr2 u2 |
||||
|
skip matching chars |
||||
|
SP! a-addr -- set data stack pointer |
||||
|
SP@ -- a-addr get data stack pointer |
||||
|
S= c-addr1 c-addr2 u -- n string compare |
||||
|
n<0: s1<s2, n=0: s1=s2, n>0: s1>s2 |
||||
|
USER n -- define user variable 'n' |
||||
|
|
||||
@ -1 +1,166 @@ |
|||||
|
|
||||
|
CAMELFORTH FOR THE Z80 - BETA TEST VERSION - 16 APRIL 1995 |
||||
|
========================================================== |
||||
|
|
||||
|
This is a BETA TEST version of CamelForth/80, an ANSI Standard Forth for |
||||
|
the Zilog Z80 microprocessor and the CP/M operating system. This means |
||||
|
that, although I have tested the bulk of this code for correct |
||||
|
functioning, and have fixed several bugs, you may discover new bugs. |
||||
|
I'd appreciate hearing of any such, either |
||||
|
|
||||
|
by Internet: bj@camelforth.com |
||||
|
|
||||
|
I'll also answer questions and try to solve problems. |
||||
|
|
||||
|
* * * |
||||
|
|
||||
|
As distributed, CamelForth will assemble to run under CP/M 2.x. It |
||||
|
determines the highest available RAM location from CP/M, and places its |
||||
|
data areas (stacks, user area, etc.) immediately below that. The |
||||
|
CamelForth program resides in the bottom of the CP/M program area |
||||
|
(100h), and any user definitions are added immediately after. CP/M's |
||||
|
default command buffer at 80h is used for the Terminal Input Buffer. |
||||
|
|
||||
|
To start CamelForth under CP/M, type the command |
||||
|
|
||||
|
CAMEL80 ...any Forth commands... |
||||
|
|
||||
|
CamelForth will execute the rest of the CP/M command line as a Forth |
||||
|
statement, and then enter the Forth interpreter. To return to CP/M, use |
||||
|
the command |
||||
|
|
||||
|
BYE |
||||
|
|
||||
|
Note that CamelForth is CASE SENSITIVE, and all Forth words are in UPPER |
||||
|
CASE. |
||||
|
|
||||
|
MODIFICATION FOR STANDALONE USE |
||||
|
|
||||
|
CamelForth can be easily assembled for a standalone or embedded Z80. |
||||
|
About 6K of PROM and 640 bytes of RAM are used by CamelForth, plus |
||||
|
whatever additional PROM and RAM is needed by your program. You will |
||||
|
probably need to provide the Z80 reset vector, e.g. |
||||
|
|
||||
|
org 0 |
||||
|
jp reset |
||||
|
|
||||
|
You must also add any required hardware initialization, and the Forth |
||||
|
words KEY KEY? and EMIT for your hardware. You should modify the |
||||
|
'reset' routine to use an equate for end of RAM, e.g. |
||||
|
|
||||
|
reset: ld hl,ramend ; end of available memory (EM) |
||||
|
dec h ; EM-100h |
||||
|
ld sp,hl ; = top of param stack |
||||
|
inc h ; EM |
||||
|
etc. |
||||
|
|
||||
|
If you are putting CamelForth in PROM, but want to have a Forth |
||||
|
dictionary in RAM (so you can add new definitions), you'll have to |
||||
|
change the 'enddict' equate (at the end of camel80.azm) to the your |
||||
|
starting RAM address. Do NOT change the 'lastword' equate. |
||||
|
|
||||
|
The Terminal Input Buffer must be moved to a new location in RAM. The |
||||
|
usual CamelForth usage is 80h bytes below the user area. TIB can be |
||||
|
redefined as |
||||
|
|
||||
|
;X tib -- a-addr Terminal Input Buffer |
||||
|
; HEX -80 USER TIB below user area |
||||
|
head TIB,3,TIB,douser |
||||
|
dw -80h |
||||
|
|
||||
|
You should also delete the line |
||||
|
|
||||
|
DW LIT,80h,COUNT,INTERPRET |
||||
|
|
||||
|
from the routine COLD. This line causes the CP/M command "tail" to be |
||||
|
executed as a Forth command...inapplicable in a standalone system. |
||||
|
|
||||
|
* * * |
||||
|
|
||||
|
This program was written using the Z80MR macro assembler under CP/M. |
||||
|
Z80MR is a freeware assembler, available from GEnie and several other |
||||
|
CP/M archives. Assemble the CamelForth source files with the commands |
||||
|
|
||||
|
z80mr camel80 |
||||
|
load camel80 |
||||
|
|
||||
|
Z80MR produces an Intel hex file camel80.hex, and LOAD generates the |
||||
|
file camel80.com. (Note: do NOT use the version of Z80MR that directly |
||||
|
outputs a .COM file; that version of the assembler has bugs.) For |
||||
|
embedded applications you probably can skip the LOAD, since most PROM |
||||
|
programmers, PROM emulators, and debug programs will accept Intel hex |
||||
|
files. |
||||
|
|
||||
|
If you don't have CP/M, you can use the MYZ80 emulator on an IBM PC, or |
||||
|
you can rewrite the source code for your Z80 macro assembler. |
||||
|
|
||||
|
There are TWO WAYS to write embedded programs in CamelForth: |
||||
|
|
||||
|
1. If you have CamelForth running on an embedded Z80, you can download |
||||
|
Forth code directly to CamelForth. This lets you type new words from |
||||
|
the keyboard, test them as they are defined, and re-define them to make |
||||
|
changes. Or you can edit an ASCII text file, and use a program such as |
||||
|
Procomm to send this file over the serial port to your Z80. It can take |
||||
|
a few seconds to compile each line, so be sure to leave plenty of delay |
||||
|
after the line. (I'm working on handshaking to improve this.) Also be |
||||
|
sure that no line exceeds 80 characters. |
||||
|
|
||||
|
2. If you you want to burn your program into PROM, you can add your code |
||||
|
to the file CAMEL80.ASM. (I recommend creating a separate file and |
||||
|
using the *INCLUDE directive.) This requires you to convert your Forth |
||||
|
code to assembler code. To show how this is done, every high-level |
||||
|
Forth word in the file is shown with its equivalent Forth code in a |
||||
|
comment. Be especially careful with control structures (IF..ELSE..THEN, |
||||
|
BEGIN..UNTIL, DO..LOOP, and the like), and with the Forth word headers. |
||||
|
Reassemble CAMEL80.AZM and burn a PROM (or download to a PROM emulator |
||||
|
or debug monitor), then test. This is a much slower process, and is |
||||
|
best saved for the final stage when you have a tested & debugged program |
||||
|
that you want to put in PROM. |
||||
|
|
||||
|
Disk I/O is not yet supported under CP/M. However, CamelForth v1.2 will |
||||
|
accept commands from a CP/M SUBMIT file using the XSUB utility. The |
||||
|
SUBMIT file should contain the commands |
||||
|
|
||||
|
XSUB |
||||
|
CAMEL80 |
||||
|
...Forth source code... |
||||
|
|
||||
|
This will run CamelForth/80 under XSUB, which will feed the rest of the |
||||
|
file to CamelForth as terminal input. You can automatically return to |
||||
|
CP/M by putting the CamelForth BYE command in the file. Then you can |
||||
|
save the modified CamelForth image with the CP/M command |
||||
|
|
||||
|
SAVE nn CAMELNEW.COM |
||||
|
|
||||
|
'nn' is the decimal number of pages occupied by the CamelForth |
||||
|
dictionary. You can determine this value while in CamelForth with the |
||||
|
statement |
||||
|
|
||||
|
DECIMAL HERE 0 256 UM/MOD NIP . |
||||
|
|
||||
|
Unfortunately, at the moment there's no way to totally automate this as |
||||
|
part of the SUBMIT file. And I'm reluctant to add SAVE to CamelForth |
||||
|
when CP/M has a perfectly good SAVE command. |
||||
|
|
||||
|
* * * |
||||
|
|
||||
|
--------------------------- LICENSE TERMS ------------------------------ |
||||
|
CamelForth for the Zilog Z80 Copyright 1994,1995 Bradford J. Rodriguez. |
||||
|
|
||||
|
This program is free software; you can redistribute it and/or modify |
||||
|
it under the terms of the GNU General Public License as published by |
||||
|
the Free Software Foundation; either version 3 of the License, or |
||||
|
(at your option) any later version. |
||||
|
|
||||
|
This program is distributed in the hope that it will be useful, |
||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||
|
GNU General Public License for more details. |
||||
|
|
||||
|
You should have received a copy of the GNU General Public License |
||||
|
along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||
|
|
||||
|
Commercial inquiries should be directed to the author at |
||||
|
115 First St., #105, Collingwood, Ontario L9Y 4W3 Canada |
||||
|
or via email to bj@camelforth.com |
||||
|
------------------------------------------------------------------------ |
||||
|
|
||||
|
|||||
Loading…
Reference in new issue