Comprehensive KERNAL documentation

Discuss anything related to the VIC
Post Reply
User avatar
srowe
Vic 20 Scientist
Posts: 1338
Joined: Mon Jun 16, 2014 3:19 pm

Comprehensive KERNAL documentation

Post by srowe »

Is anyone aware of good, in depth material that explains the KERNAL routines, particularly I/O? I've accumulated quite an understanding recently and would consider writing it down if it hasn't already been done.

I'm aware of the Programmers Ref, VIC Revealed, etc. While they have their good points they don't always contain enough detail for a programmer (and have a number of errors/omissions).
User avatar
majikeyric
Vic 20 Afficionado
Posts: 350
Joined: Fri Oct 24, 2014 2:08 pm
Website: http://majikeyric.free.fr
Location: France

Re: Comprehensive KERNAL documentation

Post by majikeyric »

maybe that full documented VIC20 ROM disassembly ? http://www.mdawson.net/vic20chrome/vic2 ... sembly.txt
User avatar
srowe
Vic 20 Scientist
Posts: 1338
Joined: Mon Jun 16, 2014 3:19 pm

Re: Comprehensive KERNAL documentation

Post by srowe »

It is, and I've enhanced and expanded this very useful listing. But it can't clearly explain in prose the concept of logical files or what input from device 3 means or what setting the top bit in a secondary address does. As a user of the KERNAL you not only need to know which registers to set but also how to include them in the structure of your programs.

What I have in mind is more of a 'how to' document that complements the disassembly.
malcontent
Vic 20 Hobbyist
Posts: 129
Joined: Sun Dec 26, 2010 1:51 pm

Re: Comprehensive KERNAL documentation

Post by malcontent »

Check out Compute's Vic-20/C64 Toolkit: Kernal

It's follows the ML step by step, basically it would be the comments to the dissassembly, but the ROM couldn't be published for copyright reasons.

The Basic version of that book helped immensely with me understanding the floating point routines.
User avatar
srowe
Vic 20 Scientist
Posts: 1338
Joined: Mon Jun 16, 2014 3:19 pm

Re: Comprehensive KERNAL documentation

Post by srowe »

I had downloaded that book from Bombjack but not got around to reading it. It does have a lot of useful information but I find the layout and the fact it covers both VIC & C64 a bit hard to read.

I still think I'll try and put together a document that summarizes KERNAL concepts if only for my own reference.
Post Reply