Category:Locomotive Basic

From Rosetta Code
Locomotive Basic
This programming language may be used to instruct a computer to perform a task.
Official website
Execution method: Interpreted
See Also:

Listed below are all of the tasks on Rosetta Code which have been solved using Locomotive Basic.
Locomotive Basic is an implementation of BASIC. Other implementations of BASIC.

Locomotive BASIC is a variant of BASIC that is built into the ROM of the Amstrad CPC series of Z80-based home computers introduced in 1984. In the 1980s, CPCs were a popular, slightly more expensive alternative to the Commodore C64/C128 and were not just suited for games but also office work because of their high resolution displays and CP/M support. They came with a built-in cassette deck (CPC 464 and 664) or 3" disk drive (CPC 6128) as storage devices and a "green screen" or color monitor which also housed the power supply. Sales were particularly strong in the UK, Germany, France, and Spain. Today, Locomotive BASIC can be used via CPC emulators such as WinAPE or JavaCPC—which is perfectly legal because Amstrad has given their permission for distributing CPC ROM images with emulators.


Locomotive BASIC was comparatively advanced for its time (with e.g. software interrupts and comprehensive graphics and audio commands) and is very cleanly implemented, just like the rest of the Amstrad CPC ROM. No doubt this was partly because the CPC debuted relatively late during the era of 8-bit machines, so Locomotive Software had more of an opportunity to consider the good and bad software design decisions in existing home computers. System calls are made with CALL via dedicated jump blocks in RAM, so they are unaffected by changes to the ROM between CPC models. This makes software very compatible between the original three CPC models and mostly compatible for the later, considerably less popular "Plus" models that came out in 1990. Together with AMSDOS, the Amstrad Disk Operating System, Locomotive BASIC is also used for disk and tape operations. (Some commands however, e.g. disckit3 for formatting disks, are only available under CP/M.)

Z80 Extensions

As on many other 8-bit machines of the era, BASIC programs are often extended with Z80 machine code which is READ from DATA statements, POKE-d to RAM, and then CALL-ed—an approach that was especially popular with type-in games in CPC magazines. The CPC also has a more convenient form of BASIC extensions, RSX[1] commands (resident system extensions). They are easily recognized by being prefixed with a pipe character and have the advantage of being freely relocatable in memory. Some RSX commands, such as "|ren" to rename files, are part of the AMSDOS ROM, but RSX routines can also reside in RAM, e.g. to provide new graphics primitives or other new capabilities to BASIC.

Memory management

Memory on the CPC 464 and 664 is subdivided into four 16 kB blocks (0 to 3), with block 3 at &c000 normally reserved for the screen. The CPC 6128 features a second 64 kB bank (blocks 4 to 7) which can be accessed from BASIC with bank switching in block 1 (&4000 and &7fff), e.g.

<lang locobasic>out &7fff,&x11000100</lang>

would make block 4 accessible in the address space of block 1.[2] This way, the entire 128 kB of memory can be used by BASIC. Alternatively, RSX commands for bank switching and copying between banks are included on the system discs and discussed in chapter 8 of the CPC user manual.[3] Even on the 64 kB models, it is possible to do double buffering in BASIC by reserving another RAM block for the screen, drawing into the hidden screen, and then setting the CRTC screen address to the currently hidden screen with the BASIC port I/O command OUT.

Language versions and user manual

Version 1.0 of Locomotive BASIC shipped with the CPC 464, later models included Locomotive Basic v1.1 which brought some important improvements. Despite the fact that all later BASIC versions call themselves v1.1, ROM headers show that e.g. the Amstrad Plus version is actually v1.40.[4] Amstrad CPC emulators usually default to a CPC 6128 with a color monitor and BASIC 1.1.

The extensive CPC user manual features a finely written introduction to BASIC that does not feel as rushed or dumbed-down as in some other manuals of the time. Obviously Amstrad expected many customers would want to program their CPCs themselves, not just use them with off-the-shelf software. There are even some pretty decent BASIC type-in games in appendix 3, such as clones of the arcade classics Breakout and Pong.

Getting started with Locomotive BASIC

Either use a browser-based CPC emulator ( or download a binary for your platform. A list of emulators is available at JavaCPC ( or WinAPE ( are particularly recommended. An advantage of native emulators is that they tend to have copy-and-paste functionality, so you can edit programs in external editors.

In the emulator, type

<lang locobasic>10 print "Goodbye, World!" run</lang>

to run your first Locomotive BASIC program.


See Also


This category has the following 3 subcategories, out of 3 total.

Pages in category "Locomotive Basic"

The following 70 pages are in this category, out of 70 total.