Differences

This shows you the differences between two versions of the page.

--- blog:x68_devtools [2020/06/29 20:11] – [Documentation] john
+++ blog:x68_devtools [2020/08/12 19:28] (current) – [The Lydux toolchain (GCC 4.6.2)] john
@@ Line 1: / Line 1: @@
-======= X68000 Development Tools =======
+======= Sharp X68000 Development Tools =======
 ===== Documentation =====
@@ Line 18: / Line 18: @@
 {{:blog:outside_x68000.png?200|}} [[https://archive.org/details/OutsideX680001993|archive.org]], {{ :blog:outside_x68000_1993_text.pdf |local copy}}
+----
+=== X68000 Programmers Reference ===
+Comprehensive set of programmers reference manuals covering most of the system calls, the use of (very early) GCC and GDB tools and more.
+{{:blog:x68000_programmers_reference_0.png?200|}}[[https://archive.org/details/X68kProgrammingSeries0X680x0Develop.LibcII1994|archive.org]], {{ :blog:x68k_programming_series_x680x0_develop_libc_ii_0_1994_text.pdf|local copy}} {{:blog:x68000_programmers_reference_1.png?200|}}[[https://archive.org/details/X68kProgrammingSeries1X680x0Develop.ManualBooksVol.2Reference19942|archive.org]], {{ :blog:x68k_programming_series_x680x0_develop_libc_ii_1_1994_text.pdf|local copy}}
+{{:blog:x68000_programmers_reference_2.png?190|}}[[https://archive.org/details/X68kProgrammingSeries2X680x0LibcManualBooksVol.2ProgrammersReferernce1994|archive.org]], {{ :blog:x68k_programming_series_x680x0_develop_libc_ii_2_1994_text.pdf|local copy}}
+   * Blue book (#0) covers the install and use of early versions of GCC, HAS assembler and GDB
+   * Red book (#1) covers the use of the early versions of GCC and the GDB debugger
+   * Green book (#2) covers function calls available in old versions of GCC and doscalls (including better worded descriptions compared to 'Inside X68000' or the 'PUNI docs')
+It's fair to say that #0 has more assembly examples than #2, which is probably the one you want if you are interested in figuring out how to use the various X68000 system calls in //doscalls/dos.h//.
+//Do be aware that when the various libc function calls are listed, this is referring to the old version of GCC, and not the new version which comes with newlib and a smaller set of functions.
+//
 ----
@@ Line 34: / Line 52: @@
 {{:blog:x6800_game_gcc.png?200|}} [[https://nfggames.com/X68000/Documentation/Books/X68000%20Game%20Programming%20with%20GCC%20(omnipage%20600dpi).pdf|NFG Games]], {{ :blog:x68000_game_programming_with_gcc_omnipage_600dpi_.pdf|local copy}}
-Source code: [[https://archive.org/details/GCCX680x0GAMEPRG1993|archive.org]], {{ :blog:gccx680x0gameprg_1993.zip |local copy}}
+{{:blog:gccx680x0gameprg1993.jpeg?200|}} Source code: [[https://archive.org/details/GCCX680x0GAMEPRG1993|archive.org]], {{ :blog:gccx680x0gameprg_1993.zip |local copy}}, {{ :blog:gccsample.zip|files extracted from disk images}}
+To be fair, the best source of material for this one is found in the example source code. Note: Disk 1 is just the old GCC compiler, the examples are found on Disk 2. You can either download the disk images and mount them in a real or emulated X68000, or download the extracted sample files so that you can view them with any normal text editor. Be aware that some of the code uses S-JIS encoded for actual function names!!!
@@ Line 54: / Line 74: @@
 | code.rtf | Note sure what this is - a character encoding table?? | {{ :blog:code.rtf |}} | - |
 | condition.rtf | Explanation of the condition bits in status registers resulting from arithmetic operations. | {{ :blog:condition.rtf |}} | - |
-| doscall.rtf | List of the available DOS/Human68k system calls; open file, get character input, allocate memory, etc. | {{ :blog:doscall.rtf |}} | - |
+| doscall.rtf | List of the available DOS/Human68k system calls; open file, get character input, allocate memory, etc. | {{ :blog:doscall.rtf |}} | [[https://gamesx.com/wiki/doku.php?id=x68000:doscall|Gamesx Wiki]] |
 | fdformat.rtf | Table of the various supported 3.5" and 5.25" floppy disk formats and their layout (sectors/tracks/heads) etc. | {{ :blog:fdformat.rtf |}} | - |
 | fefunc.rtf | List of the available arithmetic operators, including multiplication and division, and their parameters. | {{ :blog:fefunc.rtf |}} | - |
@@ Line 97: / Line 117: @@
 Pre-built binaries for Linux:
-   * {{ :blog:x68000_amd64_gcc-4.6.2.tar.bz2 |GCC 4.6.2 X68000 cross compiler}} (Linux x86_64 host)
+   * {{ :blog:x68000_amd64_gcc-4.6.2-with-dos-align-fix.tar.bz2| GCC 4.6.2 +dos.h struct align bugfix}} (Linux x86_64 host)
 If you want to build the tools from source, here's a handy script that patches them with a required fix before install; you must apply the patch, as there is a bug in this version of GCC which will cause a segfault during compilation otherwise:
    * {{ :blog:build_x68_gcc.zip |}} - Run the included bash script to configure and patch the source from Github
+Note as well, that the current distribution includes some C header prototypes that cause bus errors due to struct alignment problems. This is discussed here: https://nfggames.com/forum2/index.php?msg=41392
+The pre-compiled bundle above already has the fixes applied to //dos.h//.
+==== Makefiles & Compiling ====
 Using the toolchain:
-   * Download the archive and extract in /, it unpacks to /opt/toolchains/x68k
+   * Download the pre-built binaries above and extract in /, it unpacks to /opt/toolchains/x68k
    * X68000 library functions are defined in:
      * /opt/toolchains/x68k/human68k/include/dos.h
      * /opt/toolchains/x68k/human68k/include/iocs.h
    * Use the sample makefile below
 <code>
 # Names of the compiler and friends