Großprojekt: Schnittstellen

Zwei Chips, die miteinander reden, brauchen eine gemeinsame Sprache. Für Menschen ist das ein Protokoll auf Papier, für Chips eine Liste von Adressen mit fester Bedeutung. Fehlt diese Liste, schreibt irgendwann ein Chip die Temperatur dorthin, wo ein anderer den Akkustand erwartet.

Speicheradressen festlegen#

Für wenige Werte reicht ein Logic Memory je Wert. Werden es viele, lohnt sich ein Datenbus: der Stack eines eigenen Gehäuses, in den alle Chips über feste Adressen lesen und schreiben. get liest eine Adresse, put schreibt sie, die ReferenceId des Bus-Gehäuses holt der Chip über lbn:

define GEHAEUSE HASH("StructureCircuitHousing") # IC-Gehaeuse
lbn bus GEHAEUSE HASH("Datenbus") ReferenceId Average
get version bus 0          # Adresse 0: Version der Schnittstelle
get wert bus 3            # Adresse 3: Status der Energie
put bus 2 status           # Adresse 2: hier schreibt nur die Lebenserhaltung

Das Protokoll dokumentieren#

Jede Adresse bekommt eine Zeile in einer Tabelle, die in jedem beteiligten Chip als Kopfkommentar steht oder in der Bibliothek neben den Scripts liegt:

Drei Spalten sind Pflicht: wer schreibt, was es bedeutet und welche Werte erlaubt sind. Alles, was außerhalb des Bereichs liegt, behandelt der Leser als Fehler.

Versionen#

Irgendwann änderst du das Protokoll: Ein Feld kommt dazu, eine Bedeutung ändert sich. Dann laufen für eine Weile alte und neue Chips gemeinsam. Damit das nicht still schiefgeht, steht an einer festen Stelle die Version der Schnittstelle. Jeder Chip vergleicht sie mit der Version, die er selbst versteht, und führt nur dann Befehle aus, wenn beide passen:

seq ok version SCHNITTSTELLE     # NaN oder falsche Version: 0
select befehl ok befehl 0  # ohne passende Version kein Befehl

Passt die Version nicht, geht der Chip in den sicheren Zustand, meldet den Fehler und schreibt seine eigene Version in seinen Status. So sieht die Zentrale sofort, welcher Chip noch die alte Sprache spricht.