Mega-Micro's
Microcomputer projects new & old
Mega-Micros Home
12 Edgefield Close
Redditch B98 7WB
ENGLAND
 
+44 (0)7973 265572
info@mega-micros.co.uk
68000 68030 CPLD FPGA ARM
SHOP        
Systems
68000 CPU
68000 CPU-2
68000 CPU-2.1
Backplane
Backplane-2
Memory
Memory-2
Memory-3
Memory-3.1
Hex Display
Dual 6850
Dual 6850-2
68681
68230
68230-2
ACRTC
IDE
IDE-2
Protoboard
Other Boards
Software
  EASy68K
  WSL & Linux
  GCC
  Quartus II
  C-Kermit
  CP/M-68K
  OTHER
Programming
Documents
Datasheets
Quick Tips
Blog
 
ROSCO Toolchain

The ROSCO Toolchain is the work of Ross Bamford and others at The Really Old-School Company Limited. Ross and his team have a range of 680x0 computer boards and this toolchain is designed for use with those boards and NOT the Mega-680x0 boards.

 
Installing the toolchain
 
The following procedure installs:
 
Git for Windows (Version 2.47.0 64-bit)
Docker Desktop for Windows (Version 4.34.3 64-bit)
 
In addition to the above it installs and configures all the software necessary to write programs in 'C' and Assembly Language for the ROSCO range of 680x0 computer boards.
 
The toolchain uses VASM and GCC, both of which are free and open-source.
 
1. Download the following ZIP file:
  toolchain_utils
2. Extract the contents of the ZIP file to a temporary folder
3. Check it's contents - there should be 2 files:
 
Files:  
Git-2.47.0-64-bit.exe Installer - GIT for Windows
Docker Desktop Installer.exe Installer - Docker Desktop for Windows
   
  Installing Git for Windows
   
4. Launch the installer
  The following appears:
  'Git for Windows'
  'Do you want to allow this app to make changes to your device?'
5. Click the 'Yes' button
  'Information' screen appears
6. Click the 'Next' button
  'Select Destination Location' screen appears
7. Click the 'Next' button
  'Select Components' screen appears
8. Click the 'Next' button
  'Select Start Menu Folder' screen appears
9. Click the 'Next' button
  'Choosing the default editor used by Git' screen appears
10. Click the 'Next' button
  'Adjusting the name of the initial branch in new repositories' screen appears
11. Click the 'Next' button
  'Adjusting your PATH environment' screen appears
12. Click the 'Next' button
  'Choosing the SSH executable' screen appears
13. Click the 'Next' button
  'Choosing HTTPS transport backend' screen appears
14. Click the 'Next' button
  'Configuring the line ending conversions' screen appears
15. Click the 'Next' button
  'Configuring the terminal emulator to use with Git Bash' screen appears
16. Click the 'Next' button
  'Choose the default behaviour of 'git pull'' screen appears
17. Click the 'Next' button
  'Choose a credential helper' screen appears
18. Click the 'Next' button
  'Configuring extra options' screen appears
19. Click the 'Next' button
  'Configuring experimental options' screen appears
20. Click the 'Install' button
  'Installing' screen appears
  The install proceeds
  'Completing the Git Setup Wizard' screen appears
21. Unselect the option 'View Release Notes'
22. Click the 'Finish' button
   
  Installing Docker Desktop
   
23. Launch the installer
  The following appears:
  'Docker Desktop Installer'
  'Do you want to allow this app to make changes to your device?'
24. Click the 'Yes' button
  'Configuration' screen appears
25. Ensure 'Add shortcut to desktop' is selected
26. Click the 'OK' button
  The following appears:
  'Docker Desktop 4.34.3'
  'Unpacking files...'
  'Installation succeeded'
27. Click the 'Close' button
28. Launch Docker Desktop (shortcut on desktop)
  'Docker Subscription Service Agreement' screen appears
29. Click the 'Accept' button
  'Welcome to Docker' screen appears
30. Click 'Skip'
  'Welcome Survey' screen appears
31. Click 'Skip'
  'Sign in' screen appears
32. Click 'Skip'
  'Containers' screen appears
33. Minimise the Docker Desktop program window
   
  Getting the toolchain
   
34. Press the WINDOWS key
35. Type: CMD
36. Press the CTRL+SHIFT+ENTER keys
  The following appears:
  'Windows Command Processor'
  'Do you want to allow this app to make changes to your device?'
37. Click the 'Yes' button
  'Administrator: Command Prompt' window appears
38. Type at the command prompt: docker run -it roscopeco/rosco_m68k
  The following appears:
  'Unable to find image 'roscopeco/rosco_m68k:latest' locally'
  'latest: Pulling from roscopeco/rosco_m68k'
39. Wait for all the downloads to complete
  The menu appears
40. Select option (2)
   
  Verifying the GCC version
   
41. At the % prompt type: m68k-elf-rosco-gcc --version
42. Check the version displayed is (GCC) 13.2.0
   
43. In the Windows search box type: CMD and hit ENTER
  A new Windows Command Prompt appears
44. Type: md rosco_m68k
45. Type: cd rosco_m68k
46. * REMOVE Type: git clone https://github.com/rosco-m68k/rosco_m68k.git *
46. Type: git clone https://github.com/rosco-m68k/rosco_m68k.git --branch release/version-2.2
47. Type: start rosco_m68k
  A new Windows Explorer window appears
48. Check files and folders
49. Type: docker run -v ".\rosco_m68k:/rosco_m68k" -it roscopeco/rosco_m68k
  The menu appears
50. Select option (2)
   
  Verifying the container has all the code
   
51. Type: ls rosco_m68k
   
  Building the libraries
   
52. Type: cd /rosco_m68k/code/software/libs
53. Type: make clean install
   
  Building the adventure example
   
54. Type: cd /rosco_m68k/code/software/adventure
55. Type: make clean all
 
The toolchain is now installed and verified working.
 
Quiting the toolchain
 
Type: exit
 
Re-running the toolchain
 
1. Launch Docker Desktop
2. Minimise the Docker Desktop program window
3. In the Windows search box type: CMD and hit ENTER
  A new Windows Command Prompt appears
4. Type: cd rosco_m68k
5. Type: docker run -v ".\rosco_m68k:/rosco_m68k" -it roscopeco/rosco_m68k
  The menu appears
6. Select option (2)
7. Type: cd rosco_m68k
 
The toolchain is now available to use once again.
 
 
 
Disclaimer
All hardware designs, software, and information shared on this website is provided "as is"
without warranty of any kind and strictly for personal non-commercial use only.
 
 
Website V0.97 (C) 2021 Mega-Micros
Status: under construction
Mega-Micros Home
12 Edgefield Close
Redditch B98 7WB
ENGLAND
 
+44 (0)7973 265572
info@mega-micros.co.uk