https://github.com/qalle2/nes-clock

Qalle's Clock (NES)
https://github.com/qalle2/nes-clock

6502 asm6 assembly homebrew nes

Last synced: 2 months ago
JSON representation

Qalle's Clock (NES)

• Host: GitHub
• URL: https://github.com/qalle2/nes-clock
• Owner: qalle2
• License: gpl-3.0
• Created: 2022-05-25T20:05:24.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-10-05T01:37:37.000Z (over 2 years ago)
• Last Synced: 2025-03-08T06:42:09.577Z (over 1 year ago)
• Topics: 6502, asm6, assembly, homebrew, nes
• Language: Assembly
• Homepage:
• Size: 142 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Qalle's Clock

A 24-hour 7-segment clock for the [NES](https://en.wikipedia.org/wiki/Nintendo_Entertainment_System).

Table of contents:

* [List of files](#list-of-files)

* [Technical info](#technical-info)

* [How to use](#how-to-use)

  * [Adjust mode](#adjust-mode)

  * [Run mode](#run-mode)

## List of files

### Text

* `assemble.sh`: a Linux script that assembles the program (warning: deletes files)

* `clock.asm`: source code (assembles with [ASM6](https://www.romhacking.net/utilities/674/))

### Image

* `chr.png`: CHR data as an image (can be encoded with `nes_chr_encode.py` from [my NES utilities](https://github.com/qalle2/nes-util))

* `snap*.png`: screenshots

### Binary

* `chr.bin.gz`: CHR data in NES format (gzip compressed)

* `clock.nes.gz`: assembled program in iNES format (gzip compressed)

## Technical info

* mapper: NROM

* PRG ROM: 8 KiB

* CHR ROM: 2 KiB

* name table mirroring: vertical

* compatibility: NTSC & PAL

## How to use

There are two modes.

### Adjust mode

![adjust mode](snap1.png)

* The program starts in this mode.

* Time does not advance.

* The clock is at the center of the screen.

* The cursor (up arrow) is visible.

Buttons:

* left/right: move cursor

* up/down: change digit at cursor

* select: toggle between NTSC and PAL timing

* start: switch to run mode (hour must be 23 or less)

### Run mode

![run mode](snap2.png)

* If using NTSC timing, time advances by one second every 60.1 frames.

* If using PAL timing, time advances by one second every 50.008333… frames.

* The clock moves around the screen to prevent burn-in.

* The cursor is hidden.

Buttons:

* start: return to adjust mode