aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 0ef7710bc329f3dbb851c436791d76a7d67e5c82 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# Firmware for the Southern Star Mk II

This repository contains the firmware for the Southern Star Mk II. A wearable
computer built using a Z80 microprocessor.

The code here is *really* early in development. It consists mostly code of code
fragments from other prototypes held together by duct tape. Almost nothing of
the architecture and capabilities of the operating system has been decided.

The firmware includes a modified version of the
[zbootloader](https://git.thomaslabs.org/zbootloader/) for uploading programs
over the serial port. (see [zup](https://git.thomaslabs.org/zup/), the upload
utility)

## What is missing?

The question should be, what is not missing? Nonetheless:
- Documentation on the hardware and software architecture
- Tests for the bootloader
- Update ROM contents over USB
- scheme interpreter and compiler
- multitasking (if doable in such a restricted environment)
- Filesystem support

## File structure
- asm: Assembly code
- doc: Documentation (not ready yet)
- include: header files for both C and Assembly
- src: C source code
- manifest.scm: Guix packages for compiling the firmware image

## Related repositories
[Computer schematics](https://git.thomaslabs.org/southern-star-mk2/hardware/)
[3D Model of the enclosure](https://git.thomaslabs.org/southern-star-mk2/3d/)

## Acknowledgements
- SDCC developers; Big part of asm/crt0.asm is taken from the defualt crt0 file