• R/O
  • SSH

homemicro: Repository summary

Recent Commits RSS

Rev. Time Author Message
2d36c6026477 2019-02-03 20:56:03 inglorion tip updated stylesheet
eea6531ce6c9 2019-02-03 20:39:42 inglorion documented how to use the emulator
68d2992bdaeb 2019-02-03 20:27:11 inglorion described PS/2 keyboard interface
be9593040a6f 2019-02-02 16:04:12 inglorion include sample program in programming guide
5346c5a13459 2019-02-02 15:24:01 inglorion some documentation fixes after proofreading
277a390f29f5 2019-01-28 16:27:55 inglorion added requirements and instructions for programming video...
2ab3c233ff48 2019-01-27 18:08:52 inglorion added ATmega programmer circuit
7645f90241d8 2019-01-24 20:18:29 inglorion show error message if emulator is started without a ROM i...
b67edc8d079b 2019-01-24 20:13:19 inglorion allow emulator to work without cartridge
824a35172ebe 2019-01-24 19:54:27 inglorion changed table format in programming guide

Recently edited Tags

Name Rev. Time Author
tip 2d36c6026477 2019-02-03 20:56:03 inglorion


Name Rev. Time Author Message
default 2d36c6026477 2019-02-03 20:56:03 inglorion updated stylesheet


The Home Micro project - build your own microcomputer at home!

Home Micro provides a series of microcomputers that can be built by
hand using electronics parts that are currently in
production. Parts lists, assembly instructions, design notes, software
tools, an emulator, and full source code are provided, as well as a
number of sample applications.

This README file is intended to be a concise guide to what is
where. For a more elaborate introduction to the project, refer to

This repository contains the following directories:

 - apps :: source code for applications to run on the computer

 - docs :: documentation, such as assembly instructions and design

 - emulator :: an emulator that allows Home Micro software to be
   run and tested on more powerful computers

 - rom :: source code for the ROM image

 - tools :: programs to help develop the computer or its software,
   e.g. by writing a ROM image to the ROM chip

The project is made available under the terms of the MIT license. The
text of this license can be found in the file LICENSE.

To build the code, you will need the following software:

 - make :: to use the Makefiles
 - C compiler :: for the tools and the emulator
 - avr-as :: to build the AVR code
 - xa :: to assemble the 6502 code
 - xcb :: to build the emulator

On Raspbian, you can install these by running:

 : aptitude install binutils-avr gcc make xa65 libxcb1-dev

In general, the code can be built by cd'ing into the directory that
contains the configure script or the Makefile. In case of a configure
script, you can then run ./configure to create the Makefile. When
the Makefile is present, you can run make to build the software. make
clean will remove generated files except the final targets, and make
distclean will remove all generated files.

Show on old repository browser