-----------------------------------------------------------------------
HMR Project - 6Bit Adder, UE5 new development line

-----------------------------------------------------------------------

Copyright (c) 2024-2026 HMR Project, G.A. Cignoni 

This program is distributed WITHOUT ANY WARRANTY; 
without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

In no event shall the authors be liable to any party for direct,
indirect, special, incidental, or consequential damages,
arising out of the use of this software and its documentation.

Further information about HMR Project: https://progettoHMR.it/MR-VR

-----------------------------------------------------------------------
UE5 pipeline cache issue

On few graphics cards/drivers, on game exit UE5 does not clear
a cache file and subsequent runs fail.
Just edit the batch file RunThis.bat with the correct path where
your .upipelinecache file is, then run the game using the batch file.

-----------------------------------------------------------------------
Current in game interactions

WASD         move
Left ctrl    crouch
Space        jump
Esc          open the in game menu

Left mouse   interact, suggested by crosshair change
Right mouse  zoom

Key I        toggle detailed simulation information overlay
Key R        change fuses, cycles on different Ampere sizes
Key C        cycles on different crosshairs (default none)

Temporary, added for testing purposes

Key F        cycles on different daylight time speeds (default real time)
Key H        advances daylight time by 1 hour

Key V        cycles active window in the room (default none)
Key B        cycles stages of active window opening

-----------------------------------------------------------------------
Historical notes

In 2011, HMR Project built a physical replica of the 6-bit adder made
and successfully tested by the University of Pisa in late spring 1956.
The 6-bit adder was one of the early built components of the first 
Calcolatrice Elettronica Pisana (Electronic Computer of Pisa), actually
the first third of the computer's 18-bit parallel adder.
The machine was completed in July 1957 and then used for computing 
services; in 1959 it was dismantled to reuse the electronic components
to build a second, bigger, CEP which was inaugurated in 1961.
The replica is now part of the exhibitions of the Museo degli Strumenti
per il Calcolo (Museum of Computing Devices) in Pisa.

In 2018, by studying old photos, documents and floor plans, HMR Project
identified the precise location of the laboratory where the two CEPs 
were built in Palazzo Matteucci, then home of the Institute of Physics.

HMR 6-bit Adder is a second replica of the adder, simulated and placed
in the virtual reconstruction of the laboratory in Palazzo Matteucci
when the first CEP was in its early stages of construction.

We highly recommend a visit to the Museum, but not everyone can afford 
a trip to Pisa: the simulator is freely distributed on the HMR website.
Furthermore, it allows activities not permitted on the physical replica,
such as experiments with it, even misusing or abusing it, allowing for 
a deeper understanding of binary arithmetic and 1950s electronics.

The room has been reconstructed to the best of the knowledge given by 
historical sources. It is enriched with many details useful to explore 
the history of the CEPs as well as the scientific, technological and
social context of those years.

-----------------------------------------------------------------------
Sim Info overlay legend

General info
Status of the main switch and of the two fuses.
Power status of the adder and number of mounted chassis.
Current power consumption, increases with temperature.
Marelli fan status and current RPM and propeller position.
Temperatures: in the room, average temp of whole adder,
upper limit of whole adder.

User i/o section
A and B are first and second addend; the status of the telephone keys
used as switches is shows as binary digits.
C and S are carry and sum calculated by the adder; the status
of the Z50T used as light indicators is shown as binary digits.
Note that the rightmost bit of the carry is a telephone key.
The two Z50T rows display the ionization level (from 0 to 9) of the 
cold cathode tubes actually used as lights.

For all slots on the rack or on the workbench, a non empty slot 
represents the chassis as:
|T S| chassis Type and Serial number;
|W R| chassis Working temperature level and Resistor lighting level;
|D N| chassis Damage level and number of mounted Neighbours chassis;
|tmp| actual chassis temperature in Celsius degrees.
Where:
- T (type) is 0 for a carry circuit, 1 for a sum circuit;
- S (serial) ranges from 0 to 6; it's the serial number of the chassis, 
  it doesn't correspond to the positional value of the mounted chassis,
  although it does in the default assembly;
- W (working temp) may be
  - V very low temperature, don't working,
  - L low temperature, transient state and unpredictable results,
  - G good operating temperature, correct results (if not damaged),
  - O overheating, transient state and unpredictable results,
  - C critical, temperature is damaging the circuit;
- R (resistor lighting level) ranges from 0 to 5, 0 is off;
- D (damage) may be
  - G good, no damage,
  - D damaged, unpredictable results,
  - S severely damaged, no results;
- N (neighbours) ranges from 0 to 2;
- tmp goes from room temperature to, approximately, avg max temperature.
