A beat a program sets for itself

The only regular thing on this machine was the screen finishing a frame,
sixty times a second and not negotiable - a clock a program BORROWS rather
than one it sets. Every duration became a multiple of 16,667 cycles, so a
sixteenth note at 120 beats a minute, which is 125,000, is seven and a half
frames and cannot be asked for at all. The way round it was to choose a
tempo whose subdivisions happen to land on whole frames, which is making
the music fit the machine. Examples/tune.asm says so in its own header.

  0x50  Status: a period went by, it is running, it will interrupt
  0x51  Control: run, repeat, interrupt
  0x52-0x54  The period, in cycles, most significant first

THE PERIOD IS IN CYCLES because that is what everything else here is
counted in - the cost model counts them and a frame is measured in them -
so a timer counting anything else would be a second unit to remember.
Twenty four bits reaches from one cycle to sixteen and a half seconds, with
120 beats a minute at 500,000 in the middle, and there is no range left for
a prescaler to buy.

Starting loads the period; asking it to run while it already is does not,
so turning interrupts on half way through a period does not silently move
the beat being kept. What is left over carries into the next period, so a
period of 1,000 ticks every 1,000 and not every 1,000 plus however late
anybody looked. Reading the status takes the tick down and the line with
it, which is the rule this machine settled two days ago about every status
port.

The timing check is in terminal.sh and not the manifest, and the reason is
worth keeping: settle() strips cycle counts from recordings, which is right
for every other program and useless for a clock. "It printed eight dots"
would pass on a timer that fired them all at once. terminal.sh measures
that eight periods of 125,000 come to a million within a couple of hundred
cycles, and that 99.97% of them were spent asleep.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E2JrLzFvuFX9fgi1LDRjrW

Programs/testPrograms/timerBeatTest.asm

@@ -0,0 +1,48 @@
+; The timer interrupting, which is what a music routine actually wants.
+;
+; 125,000 cycles is a sixteenth note at 120 beats a minute. THE SCREEN CANNOT EXPRESS IT: a
+; frame is 16,667 cycles, so that beat is seven and a half of them, and a program timing music
+; on frames has to pick a tempo whose subdivisions happen to land on whole ones.
+;
+; Eight of them is a second, and what is recorded is that it took one - and that the machine
+; slept through nearly all of it, which is the difference between waiting for a beat and
+; counting up to it.
+;
+; Written by Anachronaut
+
+#Program
+start:
+  ; 125,000 cycles: a sixteenth note at 120 beats a minute, which the screen's frame
+  ; cannot express at all.
+  INIA 0x01
+  OUTA 0x52
+  INIA 0xE8
+  OUTA 0x53
+  INIA 0x48
+  OUTA 0x54                 ; 0x01E848 = 125,000
+
+  INIA 0x07
+  OUTA 0x51                 ; Run, repeat, interrupt.
+  SIF
+
+  INIB 0d8
+everyBeat:
+  WAIT
+  INIA 0d46
+  OUTA 0x00
+  DECB
+  BNB everyBeat
+
+  CIF
+  RSTA
+  OUTA 0x51
+  INIA 0d10
+  OUTA 0x00
+  HALT
+
+beat:
+  RETI
+
+#Vectors
+  Boot start
+  Device 0x50  beat