From f04be850f9c58f2f5b80a6055fdb88dff8dbd089 Mon Sep 17 00:00:00 2001 From: jonnosan Date: Thu, 20 Aug 2009 10:06:33 +0000 Subject: [PATCH] git-svn-id: http://svn.code.sf.net/p/netboot65/code@183 93682198-c243-4bdb-bd91-e943c89aac3b --- client/Makefile | 7 +- client/cfg/c64_16kcart.cfg | 3 +- client/cfg/c64prg.cfg | 11 +- client/cfg/rrbin.cfg | 2 +- client/examples/Makefile | 19 +- client/examples/comatomx.s | 309 ++++++++++++++++++++++----- client/examples/gamemusic.bin | Bin 0 -> 694 bytes client/examples/powertrain.bin | Bin 0 -> 3763 bytes client/inc/commonprint.i | 4 +- client/inc/nb65_constants.i | 14 ++ client/ip65/function_dispatcher.s | 29 +++ client/ip65/parser.s | 4 +- client/ip65/url.s | 8 +- client/nb65/Makefile | 7 +- client/nb65/crt8040.obj | Bin 0 -> 8192 bytes client/nb65/crt8040.src | 107 ++++++++++ client/nb65/nb65_c64.s | 22 +- client/test/Makefile | 2 +- doc/nb65_api_technical_reference.doc | Bin 138752 -> 143360 bytes 19 files changed, 461 insertions(+), 87 deletions(-) create mode 100644 client/examples/gamemusic.bin create mode 100644 client/examples/powertrain.bin create mode 100644 client/nb65/crt8040.obj create mode 100644 client/nb65/crt8040.src diff --git a/client/Makefile b/client/Makefile index 14be830..6723788 100644 --- a/client/Makefile +++ b/client/Makefile @@ -1,10 +1,10 @@ TARGET=c64 -.PHONY: ip65 drivers test clean distclean nb65 kipper +.PHONY: ip65 drivers test clean distclean nb65 kipper examples -all: ip65 drivers test nb65 kipper +all: ip65 drivers test nb65 kipper examples ip65: make -C ip65 all @@ -15,6 +15,9 @@ drivers: kipper: make -C kipper all +examples: + make -C examples all + test: make -C test TARGET=$(TARGET) all diff --git a/client/cfg/c64_16kcart.cfg b/client/cfg/c64_16kcart.cfg index f3922d6..b3dc4bf 100644 --- a/client/cfg/c64_16kcart.cfg +++ b/client/cfg/c64_16kcart.cfg @@ -15,7 +15,8 @@ SEGMENTS { IP65_DEFAULTS: load = DEFAULTS, type = ro; CODE: load = ROM, type = ro; RODATA: load = ROM, run=ROM, type = ro; - DATA: load = ROM, run = RAM, type = rw, define = yes; + DATA: load = ROM, run = RAM, type = rw, define = yes; + SELF_MODIFIED_CODE: load = ROM, run = RAM2, type = rw, define = yes; BSS: load = RAM, type = bss; APP_SCRATCH: load = RAM3, type = bss; TCP_VARS: load = RAM2, type = bss; diff --git a/client/cfg/c64prg.cfg b/client/cfg/c64prg.cfg index 64c622c..b660650 100644 --- a/client/cfg/c64prg.cfg +++ b/client/cfg/c64prg.cfg @@ -1,17 +1,20 @@ MEMORY { - ZP: start = $02, size = $1A, type = rw, define = yes; - IP65ZP: start = $5f, size = $10, type = rw, define = yes; - RAM: start = $07FF, size = $77ab, define = yes, file = %O; - DISCARD: start = $77FF, size = $10, define = yes; + ZP: start = $02, size = $1A, type = rw ; + IP65ZP: start = $5f, size = $10, type = rw; + RAM: start = $07FF, size = $77ab, file = %O; + RAM3000: start = $3000, size = $4800, type=rw; + DISCARD: start = $77FF, size = $10; } SEGMENTS { STARTUP: load = RAM, type = ro ,define = yes, optional=yes; CODE: load = RAM, type = ro,define = yes; DATA: load = RAM, type = rw,define = yes; + SELF_MODIFIED_CODE: load = RAM, type = rw,define = yes; VIC_DATA: load = RAM, type = rw,align = $800, optional=yes; RODATA: load = RAM, type = ro,define = yes, optional=yes; IP65_DEFAULTS: load = RAM, type = rw,define = yes, optional=yes; BSS: load = RAM, type = bss, optional=yes; + SAFE_BSS: load = RAM3000, type = bss, optional=yes; APP_SCRATCH: load = RAM, type = bss, optional=yes; ZEROPAGE: load = ZP, type = zp, optional=yes; IP65ZP: load = IP65ZP, type = zp, optional=yes; diff --git a/client/cfg/rrbin.cfg b/client/cfg/rrbin.cfg index 960c89a..a9c44d6 100644 --- a/client/cfg/rrbin.cfg +++ b/client/cfg/rrbin.cfg @@ -5,7 +5,7 @@ MEMORY { IP65ZP: start = $A3, size = $0E, type = rw, define = yes; HEADER: start = $8000, size = $18, file = %O; DEFAULTS: start = $8018, size = $1E, file = %O; - ROM: start = $8036, size = $1FC8, define = yes, file = %O; + ROM: start = $8036, size = $1FCA, define = yes, file = %O; RAM: start = $C010, size = $0fE0, define = yes; diff --git a/client/examples/Makefile b/client/examples/Makefile index 4f807af..b82bd4c 100644 --- a/client/examples/Makefile +++ b/client/examples/Makefile @@ -6,9 +6,8 @@ AFLAGS= IP65TCPLIB=../ip65/ip65_tcp.lib - -C64PROGLIB=../drivers/c64prog.lib - +#C64PROGLIB=../drivers/c64prog.lib +#NT2PLAY=nt2play.o INCFILES=\ ../inc/common.i\ ../inc/commonprint.i\ @@ -16,19 +15,21 @@ INCFILES=\ all: \ comatomx.prg \ + +%.o: %.s + $(AS) $(AFLAGS) $< -%.o: %.s sine_data.i +comatomx.o: comatomx.s sine_data.i $(AS) $(AFLAGS) $< sine_data.i: make_sine_data.rb ruby make_sine_data.rb -%.prg: %.o $(IP65LIB) $(C64PROGLIB) $(INCFILES) ../cfg/c64prg.cfg - $(LD) -m $*.map -vm -C ../cfg/c64prg.cfg -o $*.prg $(AFLAGS) $< $(IP65TCPLIB) $(C64PROGLIB) - +comatomx.prg: comatomx.o nt2play.o $(IP65TCPLIB) $(C64PROGLIB) $(INCFILES) ../cfg/c64prg.cfg + $(LD) -m comatomx.map -vm -C ../cfg/c64prg.cfg -o comatomx.prg $(AFLAGS) $< $(IP65TCPLIB) $(C64PROGLIB) $(NT2PLAY) + cp comatomx.prg ../../server/boot/ clean: - rm -f *.o *.pg2 *.prg - rm -f ip65test.dsk + rm -f *.o *.pg2 *.prg *.map distclean: clean rm -f *~ diff --git a/client/examples/comatomx.s b/client/examples/comatomx.s index 5fae3c0..560b6c2 100644 --- a/client/examples/comatomx.s +++ b/client/examples/comatomx.s @@ -1,27 +1,16 @@ .include "../inc/common.i" -.include "../inc/commonprint.i" -.include "../inc/net.i" + .ifndef NB65_API_VERSION_NUMBER .define EQU = .include "../inc/nb65_constants.i" .endif +print_a = $ffd2 -.import get_key -.import copymem -.importzp copy_src -.importzp copy_dest - -temp_buff=copy_dest - -.import url_download -.import url_download_buffer -.import url_download_buffer_length .import parser_init .import parser_skip_next - SCREEN_RAM = $0400 COLOUR_RAM = $d800 VIC_CTRL_A = $d011 @@ -33,6 +22,9 @@ VIC_IRQ_FLAG = $d019 IRQ_VECTOR=$fffe +MUSIC_BASE=$1000 ;where we relocate our music routine to +PLAYER_INIT=0 +PLAYER_PLAY=3 BORDER_COLOR = $d020 BACKGROUND_COLOR_0 = $d021 @@ -86,23 +78,14 @@ LIGHT_GRAY = 15 beq @loop .endmacro -.bss -current_input_ptr_ptr: .res 2 -param_offset: .res 1 +.macro nb65call function_number + ldy function_number + jsr NB65_DISPATCH_VECTOR +.endmacro -scroll_state: .res 1 - -download_buffer: -download_buffer_length=7600 - .res download_buffer_length - -scroll_buffer_0: - .res 2000 - -scroll_buffer_1: - .res 2000 - -string_offset: .res 1 +.zeropage +temp_buff: .res 2 +pptr: .res 2 .segment "STARTUP" ;this is what gets put at the start of the file on the C64 @@ -122,8 +105,42 @@ basicstub: init: - jsr ip65_init - jsr dhcp_init + ldax #NB65_CART_SIGNATURE ;where signature should be in cartridge (if cart is banked in) + jsr look_for_signature + bcc @found_nb65_signature + + ldax #NB65_RAM_STUB_SIGNATURE ;where signature should be in a RAM stub + jsr look_for_signature + bcs @nb65_signature_not_found + jsr NB65_RAM_STUB_ACTIVATE ;we need to turn on NB65 cartridge + jmp @found_nb65_signature + +@nb65_signature_not_found: + ldax #nb65_api_not_found_message + jsr print + rts +@found_nb65_signature: + + lda NB65_API_VERSION + cmp #02 + bpl @version_ok + ldax #incorrect_version + jsr print + jmp reset_after_keypress +@version_ok: + ldax #init_msg + jsr print + nb65call #NB65_INITIALIZE + bcc @init_ok + jsr print_cr + ldax #failed_msg + jsr print + jsr print_cr + jsr print_errorcode + jmp reset_after_keypress +@init_ok: + +;if we got here, we have found the NB65 API and initialised the IP stack jsr setup_static_scroll_text @@ -134,8 +151,41 @@ init: lda #YELLOW sta BACKGROUND_COLOR_0 + + + ;copy our music data up to a temp buffer (in case it gets overwritten by + ;one of the other unpacking moves) + ldax #musicdata+2 ;skip over the 2 byte address + stax nb65_param_buffer+NB65_BLOCK_SRC + ldax #download_buffer + stax nb65_param_buffer+NB65_BLOCK_DEST + ldax #musicdata_size-2 ;don't copy the 2 byte address + stax nb65_param_buffer+NB65_BLOCK_SIZE + ldax #nb65_param_buffer + nb65call #NB65_BLOCK_COPY + + ;copy our font data and the sprite data to $2000..$2fff + ldax #charset_font + stax nb65_param_buffer+NB65_BLOCK_SRC + ldax #$2000 + stax nb65_param_buffer+NB65_BLOCK_DEST + ldax #MUSIC_BASE + stax nb65_param_buffer+NB65_BLOCK_SIZE + ldax #nb65_param_buffer + nb65call #NB65_BLOCK_COPY - lda #<(charset_font >>10)+$10 + ;should now be now safe to copy the music data back down + ;copy our music data to $1000..$1fff + ldax #download_buffer + stax nb65_param_buffer+NB65_BLOCK_SRC + ldax #MUSIC_BASE + stax nb65_param_buffer+NB65_BLOCK_DEST + ldax #musicdata_size-2 ;don't copy the 2 byte address + stax nb65_param_buffer+NB65_BLOCK_SIZE + ldax #nb65_param_buffer + nb65call #NB65_BLOCK_COPY + + lda #$18 ; use charset at $2000 sta VIC_MEMORY_CTRL @@ -158,14 +208,22 @@ init: ;copy KERNAL to the RAM underneath, in case any ip65 routines need it - ldax #$e000 - stax copy_src - stax copy_dest + stax nb65_param_buffer+NB65_BLOCK_SRC + stax nb65_param_buffer+NB65_BLOCK_DEST ldax #$1FFF - - jsr copymem + stax nb65_param_buffer+NB65_BLOCK_SIZE + ldax #nb65_param_buffer + nb65call #NB65_BLOCK_COPY + ;copy NB65 cart to the RAM underneath, so we can swap it out and modify the IRQ vector + ldax #$8000 + stax nb65_param_buffer+NB65_BLOCK_SRC + stax nb65_param_buffer+NB65_BLOCK_DEST + ldax #$4000 + stax nb65_param_buffer+NB65_BLOCK_SIZE + ldax #nb65_param_buffer + nb65call #NB65_BLOCK_COPY lda #$35 ;we turn off the BASIC and KERNAL rom here, so we can overwrite the IRQ vector at $fffe @@ -174,6 +232,9 @@ init: jsr setup_sprites + jsr setup_music + + jsr set_next_irq_jump cli ;enable maskable interrupts again @@ -189,26 +250,28 @@ init: ;now download the feed @download_feed: - ldax #download_buffer - stax url_download_buffer - ldax #download_buffer_length - stax url_download_buffer_length ldax #feed_url - jsr url_download + stax nb65_param_buffer+NB65_URL + ldax #download_buffer + stax nb65_param_buffer+NB65_URL_DOWNLOAD_BUFFER + ldax #download_buffer_length + stax nb65_param_buffer+NB65_URL_DOWNLOAD_BUFFER_LENGTH + ldax #nb65_param_buffer + nb65call #NB65_DOWNLOAD_RESOURCE + bcs @download_feed ;if at first we don't succeed, try try again lda #1 sta scroll_state ldax #scroll_buffer_1 stax current_output_ptr - jsr emit_titles - +; jsr emit_titles ldax #scroll_buffer_1 stax current_input_ptr_ptr ;will get picked up once we have finished going through the message once - + @endless_loop: - jsr ip65_process + jsr NB65_PERIODIC_PROCESSING_VECTOR jmp @endless_loop reset_input_buffer: @@ -216,8 +279,31 @@ reset_input_buffer: stax current_input_ptr rts +;look for NB65 signature at location pointed at by AX +look_for_signature: + stax temp_buff + ldy #3 +@check_one_byte: + lda (temp_buff),y + cmp nb65_signature,y + bne @bad_match + dey + bpl @check_one_byte + clc + rts +@bad_match: + sec + rts + + +;set up the tune +setup_music: + lda #$00 ;init subtune 0 + jsr MUSIC_BASE+PLAYER_INIT + rts setup_sprites: + ;turn on all 8 sprites lda #$FF sta $d015 @@ -242,7 +328,7 @@ setup_sprites: lda sprite_text,x sbc #'A' clc - adc #<(sprite_font/64) + adc #<($2800/64) ;sprite font should be relocated to $2000 sta SCREEN_RAM+$03f8,x dex bpl @setup_sprite @@ -467,7 +553,7 @@ setup_static_scroll_text: @loaded_offset: sta param_offset - jsr cfg_get_configuration_ptr ;ax=base config, carry flag clear + nb65call #NB65_GET_IP_CONFIG adc param_offset bcc :+ inx @@ -557,6 +643,24 @@ emit_decimal: ;emit byte in A as a decimal number rts +reset_after_keypress: + ldax #press_a_key_to_continue + jsr print +@wait_key: + jsr $f142 ;not officially documented - where F13E (GETIN) falls through to if device # is 0 (KEYBD) + beq @wait_key + jmp $fce2 ;do a cold start + +print_errorcode: + ldax #error_code + jsr print + nb65call #NB65_GET_LAST_ERROR + nb65call #NB65_PRINT_HEX + jmp print_cr + + + + top_sprite_color_irq: start_irq wait_next_raster @@ -572,12 +676,26 @@ bottom_sprite_color_irq: inc $d026 ;sprite multicolor register 1 jmp exit_from_irq + +update_nb65_counters_irq: + start_irq + jsr NB65_VBL_VECTOR + jmp exit_from_irq + + +play_music_irq: + inc BORDER_COLOR + start_irq + jsr MUSIC_BASE+PLAYER_PLAY + dec BORDER_COLOR + jmp exit_from_irq + emit_titles: ldax #download_buffer jsr parser_init @next_title: ldax #title - jsr parser_skip_next + jsr parser_skip_next bcs @done jsr emit_tag_contents @@ -589,6 +707,8 @@ emit_titles: jsr emit_a jmp @next_title @done: + lda #0 + jsr emit_a rts emit_tag_contents: @@ -638,7 +758,25 @@ emit_tag_contents: @done: rts +print: + sta pptr + stx pptr + 1 + +@print_loop: + ldy #0 + lda (pptr),y + beq @done_print + jsr print_a + inc pptr + bne @print_loop + inc pptr+1 + bne @print_loop ;if we ever get to $ffff, we've probably gone far enough ;-) +@done_print: + rts +print_cr: + lda #13 + jmp print_a .data @@ -674,14 +812,18 @@ raster_jump_table: ;table needs to be sorted by scanlines .byte $0,$01 .word scroll_text_irq - .byte $0,$1b -; .word top_sprite_color_irq -; .byte $0,$20 + .byte $0,$20 .word pixel_scroll_irq - .byte $0,$80 -; .word bottom_sprite_color_irq -; .byte $0,255 - .word move_sprites_irq + + .byte $0,$30 + .word update_nb65_counters_irq + + .byte $0,$80 + .word play_music_irq + + + .byte $80,$05 + .word move_sprites_irq .byte $ff ;end of list @@ -703,7 +845,7 @@ scroll_template: sprite_text: .byte "COMATOMX" -.byte " configured via dhcp - ip: %i / gateway: %g / dns server %d / polling %f /" +.byte " / ip: %i / gateway: %g / dns server %d / polling %f /" .byte " ",0 @@ -714,8 +856,59 @@ feed_url: title: .byte "",0 -.segment "VIC_DATA" +nb65_api_not_found_message: + .byte "ERROR - NB65 API NOT FOUND.",13,0 +incorrect_version: + .byte "ERROR - NB65 API MUST BE AT LEAST VERSION 2.",13,0 + +failed_msg: + .byte "FAILED", 0 + +ok_msg: + .byte "OK", 0 + + +init_msg: + .byte " INITIALIZING ",0 + +press_a_key_to_continue: + .byte "PRESS A KEY TO CONTINUE",13,0 + +nb65_signature: +.byte $4E,$42,$36,$35 ; "NB65" - API signature + +error_code: + .asciiz "ERROR CODE: " + charset_font: .incbin "font16x8.bin" sprite_font: .incbin "spud_letters.spr" +musicdata: +;.incbin "tune.bin" +.incbin "powertrain.bin" +musicdata_size=*-musicdata + +.segment "SAFE_BSS" +;we want our variables to start at $3000, out of the way of our music player and the font data +current_input_ptr_ptr: .res 2 +param_offset: .res 1 + +temp_bin: .res 1 +temp_bcd: .res 2 + +scroll_state: .res 1 + +nb65_param_buffer: .res $20 + +download_buffer: +download_buffer_length=4000 + .res download_buffer_length + +scroll_buffer_0: + .res 1000 + +scroll_buffer_1: + .res 2000 + +string_offset: .res 1 diff --git a/client/examples/gamemusic.bin b/client/examples/gamemusic.bin new file mode 100644 index 0000000000000000000000000000000000000000..92a37537f8af3ce315c266dcf3e36ec902d30b48 GIT binary patch literal 694 zcmZ`%L2DC16n?YWot;U7tOcdwr9!c=xq1==_gK=>#zTY^!!B$g)zW~05Fz3&lnRrg z=t2Amxu`!NM`4xHLk^y{NImR%LA?yrbbJ$or})7)-+SMCvu}5HRxg>nQcXNh-FSD} z@RW!6yIdrmLO(%ic%#$rUq*m%^ir~`6)^3p11A6{A4bQicEPzDBZ5H1OvTH~iZMo3 z&MdNR#qsm%8!QAw8Ju&Vwr$e!c)WL1uh);r)oT{3IDF;Gs$mkqZ51|qAOS*j@cH=L zuj_a24c>nI^xHvPp5yisY=!TaphU|V)JR4ty@|YqbdeC6+G<hi7tKJ2zIJyl8MU9} z?RHcIkqn~!Jc@#%708zF=f2-8{B7L}T~qe@DWyeE_6J&HIq0L2_lhXMJcBOPjU5}8 zN60Rc!c&%F?=vCe7qe(6<jdFWl@JN0*+6zg6zW0-Yed!zS|ha*tr=?s-`Smo?tdz- z3msce{5Pzv2j1r?E&Q{GV%m~454rSHD$7|je;}sKhAx&T8**K2Y;x5Yo^OhR;z!_# zE#5fsWhkN@u6Bn%uyL{@@Qmi^*T>>wZ~rIS5|n{pQ+B}cM=z2oJIB(L&E$|Lm>jZ% fEfNl(N*1*>%jHB1Y$<aNyq`LP5HACP5&`-LJ?Y#S literal 0 HcmV?d00001 diff --git a/client/examples/powertrain.bin b/client/examples/powertrain.bin new file mode 100644 index 0000000000000000000000000000000000000000..b6aa81ad45075804504b00f54d9143ec38fc003b GIT binary patch literal 3763 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 literal 0 HcmV?d00001 diff --git a/client/inc/commonprint.i b/client/inc/commonprint.i index e5a003f..e51e192 100644 --- a/client/inc/commonprint.i +++ b/client/inc/commonprint.i @@ -21,7 +21,7 @@ .export tftp_server_msg .import ip65_error .export print_errorcode - + .export press_a_key_to_continue .import arp_cache .importzp ac_size @@ -379,3 +379,5 @@ dns_lookup_failed_msg: error_code: .asciiz "ERROR CODE: " +press_a_key_to_continue: + .byte "PRESS A KEY TO CONTINUE",13,0 diff --git a/client/inc/nb65_constants.i b/client/inc/nb65_constants.i index 06b32b7..36b7486 100644 --- a/client/inc/nb65_constants.i +++ b/client/inc/nb65_constants.i @@ -46,6 +46,8 @@ NB65_TFTP_CALLBACK_UPLOAD EQU $25 ;upload: AX points to a TFTP transfer par NB65_DNS_RESOLVE EQU $30 ;inputs: AX points to a DNS parameter structure, outputs: DNS param structure updated with ;NB65_DNS_HOSTNAME_IP updated with IP address corresponding to hostname. +NB65_DOWNLOAD_RESOURCE EQU $40 ;inputs: AX points to a URL download structure, outputs: none + NB65_PRINT_ASCIIZ EQU $80 ;inputs: AX=pointer to null terminated string to be printed to screen, outputs: none NB65_PRINT_HEX EQU $81 ;inputs: A=byte digit to be displayed on screen as (zero padded) hex digit, outputs: none @@ -59,6 +61,7 @@ NB65_INPUT_PORT_NUMBER EQU $92 ;no inputs, outputs: AX = port number ent NB65_BLOCK_COPY EQU $A0 ;inputs: AX points to a block copy structure, outputs: none + NB65_GET_LAST_ERROR EQU $FF ;no inputs, outputs A EQU error code (from last function that set the global error value, not necessarily the ;last function that was called) @@ -110,6 +113,17 @@ NB65_PAYLOAD_LENGTH EQU $08 ;2 byte length of payload ; in a TCP connection, if the length is $FFFF, this actually means "end of connection" NB65_PAYLOAD_POINTER EQU $0A ;2 byte pointer to payload of packet (after all headers) + +;offsets in URL download structure +;inputs: +NB65_URL EQU $00 ;2 byte pointer to null terminated URL (NB - must be ASCII not "native" string) +NB65_URL_DOWNLOAD_BUFFER EQU $02 ;2 byte pointer to buffer that resource specified by URL will be downloaded into +NB65_URL_DOWNLOAD_BUFFER_LENGTH EQU $04 ;2 byte length of buffer (download will truncate when buffer is full) + +;AX = address of URL string +; url_download_buffer - points to a buffer that url will be downloaded into +; url_download_buffer_length - length of buffer + ;error codes (as returned by NB65_GET_LAST_ERROR) NB65_ERROR_PORT_IN_USE EQU $80 NB65_ERROR_TIMEOUT_ON_RECEIVE EQU $81 diff --git a/client/ip65/function_dispatcher.s b/client/ip65/function_dispatcher.s index aacea2c..1a13832 100644 --- a/client/ip65/function_dispatcher.s +++ b/client/ip65/function_dispatcher.s @@ -437,6 +437,35 @@ ip_configured: nonzero_octets: .res 1 .code + cpy #NB65_DOWNLOAD_RESOURCE + bne :+ +.import url_download +.import url_download_buffer +.import url_download_buffer_length + + + ldy #NB65_URL_DOWNLOAD_BUFFER + lda (nb65_params),y + sta url_download_buffer + iny + lda (nb65_params),y + sta url_download_buffer+1 + + ldy #NB65_URL_DOWNLOAD_BUFFER_LENGTH + lda (nb65_params),y + sta url_download_buffer_length + iny + lda (nb65_params),y + sta url_download_buffer_length+1 + + ldy #NB65_URL+1 + lda (nb65_params),y + tax + dey + lda (nb65_params),y + jmp url_download +: + cpy #NB65_TCP_CONNECT bne :+ .import tcp_connect diff --git a/client/ip65/parser.s b/client/ip65/parser.s index 24b2200..b880579 100644 --- a/client/ip65/parser.s +++ b/client/ip65/parser.s @@ -19,9 +19,9 @@ search_string=copy_dest .endif .bss -int_value: .res 2 temp_ptr: .res 2 -.data + +.segment "SELF_MODIFIED_CODE" get_next_byte: current_string_ptr=get_next_byte+1 lda $ffff diff --git a/client/ip65/url.s b/client/ip65/url.s index 78d53ca..62cd06a 100644 --- a/client/ip65/url.s +++ b/client/ip65/url.s @@ -1,4 +1,4 @@ -;routine for parsing a URL +;routines for parsing a URL, and downloading an URL .include "../inc/common.i" @@ -46,7 +46,8 @@ target_string=copy_src search_string=copy_dest selector_buffer=output_buffer -.bss +.segment "TCP_VARS" + url_string: .res 2 url_ip: .res 4 ;will be set with ip address of host in url url_port: .res 2 ;will be set with port number of url @@ -277,7 +278,6 @@ skip_to_hostname: ldax #colon_slash_slash jmp parser_skip_next - .code ;download a resource specified by an URL @@ -290,7 +290,7 @@ skip_to_hostname: ; of specified resource (with an extra 2 null bytes at the end), ; AX = length of resource downloaded. url_download: - jsr url_parse + jsr url_parse bcc @url_parsed_ok rts @url_parsed_ok: diff --git a/client/nb65/Makefile b/client/nb65/Makefile index 33662ec..735475f 100644 --- a/client/nb65/Makefile +++ b/client/nb65/Makefile @@ -22,7 +22,7 @@ APPLE2PROGLIB=../drivers/apple2prog.lib BOOTA2.PG2=../../server/boot/BOOTA2.PG2 #all: utherboot.dsk $(BOOTA2.PG2) nb65_rrnet.bin nb65_std_cart.bin nb65_c64_ram.prg d64_upload.prg c64boot.d64 d64_upload.d64 -all: nb65_std_cart.bin nb65_tcp_cart.bin +all: nb65_std_cart.bin nb65_tcp_cart.bin nb65_tcp_cart_rr.bin nb65_c64_ram.o: nb65_c64.s $(INCFILES) $(AS) -DBANKSWITCH_SUPPORT=0 $(AFLAGS) -o $@ $< @@ -61,6 +61,11 @@ nb65_rrnet.bin: nb65_rrnet.o $(IP65LIB) $(C64NB65LIB) $(INCFILES) ../cfg/rrbin.c $(LD) -m nb65_rrnet.map -Ln nb65_rr.lab -vm -C ../cfg/rrbin.cfg -o $@ $< $(IP65LIB) $(C64NB65LIB) ruby fix_cart.rb $@ 8193 +nb65_tcp_cart_rr.bin: nb65_tcp_cart.bin + cp crt8040.obj rrnet_header.bin + cat rrnet_header.bin nb65_tcp_cart.bin > nb65_tcp_cart_rr.bin + ruby fix_cart.rb $@ 32768 + utherboot.pg2: utherboot.o $(IP65LIB) $(APPLE2PROGLIB) $(INCFILES) ../cfg/a2language_card.cfg $(LD) -m utherboot.map -C ../cfg/a2language_card.cfg -o $@ $< $(IP65LIB) $(APPLE2PROGLIB) diff --git a/client/nb65/crt8040.obj b/client/nb65/crt8040.obj new file mode 100644 index 0000000000000000000000000000000000000000..b5ab5c15fb4a1333c78f131e17485bb29ccd71fa GIT binary patch literal 8192 zcmeIuAqoOP7>40r*fL>ts~~7F2o}YlH_%}41fIY{%mwxU8w8p5hdqG7;+ADWm;>ly zHcZ_jqCvcY?fv5Wwa3`)t2kd46J4gQ+HFofyBAX>&037>A4JEg)Q{3Xk8;l>Dt)7~ zUx_lYpAtGI3{4pLD)Bn~zIlAj<6FDyb-vQV$!I557y<|&fB*srAb<b@2q1s}0tg_0 Z00IagfB*srAb<b@2q1s}0toy=;0-9JHTnPm literal 0 HcmV?d00001 diff --git a/client/nb65/crt8040.src b/client/nb65/crt8040.src new file mode 100644 index 0000000..f7f31bb --- /dev/null +++ b/client/nb65/crt8040.src @@ -0,0 +1,107 @@ +;taken from DocBacardi's CRT8040 tool - http://freenet-homepage.de/LittleDreamLand/CRT8040.html + +#segdef "zp", $57-$72 +#segdef "bank0", $8000-$9f10, force, fillup +#segdef "common", $df10-$e000, force, fillup + +#outfile @, $00, "bank0", "common" + +;-------------------------------------- +; init the startadr of all segments + + .segment "zp" + * = $57 + + .segment "bank0" + * = $8000 + + .segment "common" + * = $df10 + +;-------------------------------------- +; init the rr registers and copy +; bank 3 to ram + + .segment "bank0" + + .DW Bank0_Reset ;Reset vector + .DW $fe5e ;NMI vector is not used here, points to system + .PET "CBM80" ;Reset Magic + +Bank0_Reset: + lda #%01000111 ;Standard Memory Map, No Freeze, No Banking in $DF00 (+ allow access to accessory connector - Jonno 2009-08-20) + sta $de01 + + ldx #kickStack_len-1 +copyKickStack: + lda kickStack_org,x + sta kickStack,x + dex + bpl copyKickStack + jmp kickStack + +kickStack_org: + .pseudopc $0900 +kickStack: + + ldx #$1f + ldy #0 +copyCrt: + lda #%00101011 ; switch to bank 1 + sta $de00 +delay0: + nop + iny + bne delay0 +copyPage0: +smod0: + lda $e000,y + sta $0400,y + iny + bne copyPage0 + lda #%00110011 ; switch to bank 2 + sta $de00 +delay1: + nop + iny + bne delay1 +copyPage1: + lda $0400,y +smod1: + sta $8000,y + iny + bne copyPage1 + inc smod0+2 + inc smod1+2 + inc $d020 + dex + bpl copyCrt + + lda #%00110001 ; switch to 8040 + sta $de00 +delay2: + nop + iny + bne delay2 + + + ; during the copy process occured some irqs, clear them + lda $dc0d + lda $dd0d + asl $d019 + + ; set registers + ; NV-BDIZC + lda #%00110111 + pha + lda #$c3 + ldx #$00 + plp + + jmp ($8000) + +kickStack_len = *-kickStack + .realpc + +;-------------------------------------- + diff --git a/client/nb65/nb65_c64.s b/client/nb65/nb65_c64.s index ebfbb09..0401cb7 100644 --- a/client/nb65/nb65_c64.s +++ b/client/nb65/nb65_c64.s @@ -79,6 +79,7 @@ .import cfg_dns .import cfg_tftp_server + .import print_dotted_quad .import print_hex .import print_errorcode @@ -91,7 +92,8 @@ .import gateway_msg .import dns_server_msg .import tftp_server_msg - + .import press_a_key_to_continue + .import print_a .import print_cr .import print @@ -102,6 +104,10 @@ .import __DATA_LOAD__ .import __DATA_RUN__ .import __DATA_SIZE__ + .import __SELF_MODIFIED_CODE_LOAD__ + .import __SELF_MODIFIED_CODE_RUN__ + .import __SELF_MODIFIED_CODE_SIZE__ + .import cfg_tftp_server tftp_dir_buffer = $6020 nb65_param_buffer = $6000 @@ -183,6 +189,18 @@ init: ldax #__DATA_SIZE__ jsr copymem + +;relocate the self-modifying code (if necessary) +.if (BANKSWITCH_SUPPORT=$03) + ldax #__SELF_MODIFIED_CODE_LOAD__ + stax copy_src + ldax #__SELF_MODIFIED_CODE_RUN__ + stax copy_dest + ldax #__SELF_MODIFIED_CODE_SIZE__ + jsr copymem +.endif + + ;copy the RAM stub to RAM ldax #nb65_ram_stub stax copy_src @@ -739,8 +757,6 @@ tftp_file: no_files_on_server: .byte "NO MATCHING FILES",13,0 -press_a_key_to_continue: - .byte "PRESS A KEY TO CONTINUE",13,0 resolving: .byte "RESOLVING ",0 diff --git a/client/test/Makefile b/client/test/Makefile index 3058902..006b6bb 100644 --- a/client/test/Makefile +++ b/client/test/Makefile @@ -19,7 +19,7 @@ INCFILES=\ ../inc/net.i\ all: \ - ip65test.dsk \ +# ip65test.dsk \ testdns.prg \ test_disk_io.prg \ test_disk_io.d64 \ diff --git a/doc/nb65_api_technical_reference.doc b/doc/nb65_api_technical_reference.doc index 715363c971b437b3f5120bcdbd3345009c413d8a..be2acc31256149e41900262e84c0b36f031c4b97 100644 GIT binary patch delta 16459 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 delta 14323 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 L^0b2H`p*9VpE3MW