[BUS ERROR] RSS feed for wiki pages

Welcome to Atari coding wiki!

buserror@nokturnal.pl — Wed, 01 Apr 2026 14:59:30 +0000

description		description
01.04.2026	There's new Atari ST Visual Studio Code Extension, which can accelerate development of Atari ST games and applications. Allows building, running and debugging C, C++ and 68k assembly projects targeting Atari ST / TT / Falcon systems. Contains cross-compiler GCC toolchain (mintelf) with GDB, provides debug-time views of CPU registers, memory and hardware information, hooks into Hatari's debugger via the cppdbg debug adapter. From extension folder structure looks like it should work on Windows / Linux and MacOS (Darwin).

What it is all about?

buserror@nokturnal.pl — Wed, 01 Apr 2026 14:50:03 +0000

- If you're programmer or coder with Atari programming experience and would like to commit to this wiki, have some interesting article to share or you've spotted an error or just stumbled upon something that could be better described then contact us. Any help or feedback will be appreciated.

+ If you're programmer or coder with Atari programming experience and would like to commit to this wiki, have some interesting article to share or you've spotted an error or just stumbled upon something that could be better described then contact us. Any help or feedback will be appreciated. Use of any AI / LLM / Machine learning tools on content from this site prohibited, no consent.

Using OPL soundchips on ATARI ST

buserror@nokturnal.pl — Wed, 15 Oct 2025 21:05:36 +0000

-
5" >Copy to clipboard
5" >8MHz

+
1" >Copy to clipboard
1" >8MHz

-
6" >Copy to clipboard
6" >TIMERD_VEC  equ $11

+
2" >Copy to clipboard
2" >TIMERD_VEC  equ $11

-
7" >Copy to clipboard
7" >#include <mint/falcon.h>

+
3" >Copy to clipboard
3" >#include <mint/falcon.h>

-
8" >Copy to clipboard
8" >; OPL2 timings

+
4" >Copy to clipboard
4" >; OPL2 timings

- Here's a demo of replaying samples on YM2413(OPLL) on MSX, so probably similar thing would be possible to replicate on Atari with OPL2 or OPL3 too ~~on Atari~~. Here's FMPCM recording from MSX.

+ Here's a demo of replaying samples on YM2413(OPLL) on MSX, so probably similar thing would be possible to replicate on Atari with OPL2 or OPL3 too. Here's FMPCM recording from MSX.

V4SA

buserror@nokturnal.pl — Tue, 14 Oct 2025 15:37:39 +0000

-
id="rbox_754bf83f6
26d
7
7d51bbf
dda25
3e" cla~~ss="a~~l~~ert~~ alert-da~~nger~~ alert-dismissible"><~~button~~ ~~typ~~e="~~button~~" class="btn-cl~~ose~~" data-b~~s-dismiss~~="~~alert" aria-la~~b~~el="Cl~~ose"><~~/button>~~iv c~~lass~~="al~~ert-hea~~di~~ng h4"><~~span ~~class~~="~~icon~~ i~~con-error~~ fa~~s fa-exc~~l~~ama~~t~~ion-circle~~ " > class="r~~boxtitl~~e~~">Plu~~gin Imagep~~an>~~iv>
tent" ~~style="d~~ispl~~ay:~~ i~~nline~~">~~File not found.~~div>

+
style="display: inline-block; display:block; margin-left:auto; margin-right:auto; max-width: 1

%; width:5
2px; height:6
4px"> <a href="dl186?display" class="internal" data-box="box"> mg src="dl186?display" width="5

" height="6
2" alt="V4" class="regImage pluginImg186 img-fluid" /> a>

Native coding tools

buserror@nokturnal.pl — Sat, 18 Dec 2021 13:35:42 +0000

+ HiSoft BASIC
+ Omikron Basic
+ GFA Basic
+ Devpac
+ Turbo Assembler
+ DSP-Tools
+ asm56k
+ DSPdit
+ Quick DSP assembler
+ Aztec C
+ Pure C
+ Hisoft C
+ Megamax C
+ Lattice C
+ Personal Pascal
+
+
Debuggers
+ Bugaboo
+ Adebug
+ MonST
+ Peacebug
+ DSP 56001 Debugger
+ BSSdebug
+
+
Disassemblers
+ TT-Digger
+ Desert Drain

Creating TOS binaries with gcc cross-compiler and SCONS

admin — Tue, 06 Dec 2011 22:33:39 +0000

-
main.c
17" >Copy to clipboard
17" >
#include <stdio.h>
+
main.c
9" >Copy to clipboard
9" >
#include <stdio.h>
-
SConstruct
8" >Copy to clipboard
8" >
import sys
+
SConstruct

" >Copy to clipboard

" >
import sys
-
SConstruct
9" >Copy to clipboard
9" >
SConscript(&#
39;SConscript&#
39;, variant_dir=&#
39;../build_release&#
39;, duplicate=
, exports={&#
39;MODE&#
39;:&#
39;release&#
39;})
+
SConstruct
1" >Copy to clipboard
1" >
SConscript(&#
39;SConscript&#
39;, variant_dir=&#
39;../build_release&#
39;, duplicate=
, exports={&#
39;MODE&#
39;:&#
39;release&#
39;})
-
SConstript

" >Copy to clipboard

" >
import sys
+
SConstript
12" >Copy to clipboard
12" >
import sys
-
hello.s
21" >Copy to clipboard
21" >
XDEF _hello ;export symbol
+
hello.s
3" >Copy to clipboard
3" >
XDEF _hello ;export symbol
- addq.l #6,-(sp)
+ addq.l #6,sp
-
main.c
22" >Copy to clipboard
22" >
#include <mintbind.h>
+
main.c
14" >Copy to clipboard
14" >
#include <mintbind.h>
-
23" >Copy to clipboard
23" >
extern void hello(void);

+
15" >Copy to clipboard
15" >
extern void hello(void);

-
24" >Copy to clipboard
24" >
extern "C"{
+
16" >Copy to clipboard
16" >
extern "C"{

Creating TOS binaries with CMake and cross compiler

admin — Mon, 25 Apr 2011 18:39:43 +0000

-
-
Install CMake
- You should get it directly from CMake official site or get it from packages available for your system distribution (in case of Linux).
- For CMake to be able to crosscompile software, it requires you to write a toolchain file, which tells CMake some information about the toolchain. With the examples used above it will look like(note: for Cygwin you have to exchange "/usr/m68k-atari-mint" path with "/opt/cross-mint" (TODO: verify it)):
- {C~~ODE(~~caption="Toolchain-m68k-atari-mint.cmake~~",wr~~ap=<e~~m>N~~o such attachment on this pageem>"
")}# the name of the target operating system

SET(CMAKE_SYSTEM_NAME AtariTOS)
+ For CMake to be able to crosscompile software, it requires you to write a toolchain file, which tells CMake some information about the toolchain. With the examples used above it will look like (ready to use file is added as an attachment at the bottom of this page):

="codecaption">Toolchain-m68k-atari-mint.cmake
ass="codelisting_container"> class="icon_copy_code far fa-clipboard" tabindex="
" data-clipboard-target="#codebox25" >n class="copy_code_tooltiptext">Copy to clipboardspan>
"
" dir="ltr" id="codebox25" >
# the name of the target operating system
SET(CMAKE_SYSTEM_NAME AtariTOS)

# which compilers to use for C and C++
SET(CMAKE_C_COMPILER m68k-atari-mint-gcc)
SET(CMAKE_CXX_COMPILER m68k-atari-mint-g++)

# here is the target environment located
SET(CMAKE_FIND_ROOT_PATH /usr/m68k-atari-mint $HOME/gcc-atari)

# adjust the default behaviour of the FIND_XXX() commands:
# search headers and libraries in the target environment, search
# programs in the host environment
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

- which compilers to use for C and C++

SET(CMAKE_C_COMPILER m68k-atari-mint-gcc)

SET(CMAKE_CXX_COMPILER m68k-atari-mint-g++)

here is the target environment located

SET(CMAKE_FIND_ROOT_PATH /usr/m68k-atari-mint $HOME/gcc-atari)

adjust the default behaviour of the FIND_XXX() commands:
search headers and libraries in the target environment, search
programs in the host environment

set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)

set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)

set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY){CODE}

Save this file as Toolchain-m68k-atari-mint.cmake to some location where you will put all your toolchain files, e.g. $HOME. As you can see CMAKE_FIND_ROOT_PATH is set to /usr/m68k-atari-mint, which contains the headers and libraries installed with the toolchain. This second directory is intended to hold other libraries you will compile using m68k-atari-gcc, they should be installed under this install prefix ~~(note: under unix-like(Linux/Cygwin) environments only one path:'/usr/m68k-atari-mint' should be sufficient, the second can be treated as optional(?))~~. This way the FIND_XXX() commands in CMake will find both the headers and libraries coming with the toolchain as well as additional libraries you have built for this platform.
+ Save this file as Toolchain-m68k-atari-mint.cmake to some location where you will put all your toolchain files, e.g. $HOME. As you can see CMAKE_FIND_ROOT_PATH is set to /usr/m68k-atari-mint, which contains the headers and libraries installed with the toolchain. This second directory is intended to hold other libraries you will compile using m68k-atari-gcc, they should be installed under this install prefix. This way the FIND_XXX() commands in CMake will find both the headers and libraries coming with the toolchain as well as additional libraries you have built for this platform.
-
main.c
9" >Copy to clipboard
9" >
#include <stdio.h>
+

main.c
6" >Copy to clipboard
6" >
#include <stdio.h>
- printf("Hello world\n");
+ printf("Hello worldn");
-
CMakeLists.txt
3
" >Copy to clipboard
3
" >
ADD_EXECUTABLE(hello main.c)

+
CMakeLists.txt
27" >Copy to clipboard
27" >
ADD_EXECUTABLE(hello main.c)

-
31" >Copy to clipboard
31" >
~/src/helloworld/ $ mkdir build
+
28" >Copy to clipboard
28" >
~/src/helloworld/ $ mkdir build

U.L.S. (Universal Loading System)

admin — Sat, 23 Apr 2011 18:49:15 +0000

List List

ULSv3.12j Source Code(uls312j.s) Microprose F1GP Loader Source (ULS v3.0 - Requires modification for current ULS build)(ULS v3.12h+)(f1gp.s) Alcatraz Loader Source (ULS v3.12h+)(alcatraz.s) Elite Loader Source (ULS v3.11 - Requires modification for current ULS build)(Elite.s)

Source code
ULSv3.12j Source Code (uls312j.s)↵
Microprose F1GP Loader Source (ULS v3.0 - Requires modification for current ULS build)(ULS v3.12h+)(f1gp.s)↵
Alcatraz Loader Source (ULS v3.12h+) (alcatraz.s)↵
Elite Loader Source (ULS v3.11 - Requires modification for current ULS build) (Elite.s)↵

ICTARI list of magazine issues

admin — Wed, 19 Jan 2011 21:31:01 +0000

Atari development under Linux

admin — Tue, 26 Oct 2010 02:19:49 +0000

+ TODO

List		List
ULSv3.12j Source Code(uls312j.s) Microprose F1GP Loader Source (ULS v3.0 - Requires modification for current ULS build)(ULS v3.12h+)(f1gp.s) Alcatraz Loader Source (ULS v3.12h+)(alcatraz.s) Elite Loader Source (ULS v3.11 - Requires modification for current ULS build)(Elite.s)		Source code ULSv3.12j Source Code (uls312j.s)↵ Microprose F1GP Loader Source (ULS v3.0 - Requires modification for current ULS build)(ULS v3.12h+)(f1gp.s)↵ Alcatraz Loader Source (ULS v3.12h+) (alcatraz.s)↵ Elite Loader Source (ULS v3.11 - Requires modification for current ULS build) (Elite.s)↵