Runs an overlay through the compilation and loading cycle, then proceeds to check if there really is the expected outcome on the header.

To run a diagnostic cycle, you should call run_diagnostic/1, passing a reader function as an argument. This is so that we do not directly depend on Circuits.GPIO as this is not strictly needed to use DtsBuddy.

Example use, succeeding :

iex> {:ok, gpio} = Circuits.GPIO.open("GPIO12", :input)
{:ok, %Circuits.GPIO.CDev{}}
iex> reader = fn () -> Circuits.GPIO.read(gpio)
#Function<>
iex> DtsBuddy.Diagnostic.run_diagnostic(reader)
[DtsBuddy.Diagnostic] Running system checks
[DtsBuddy.Diagnostic] All system checks passed
[DtsBuddy.Diagnostic] Loading a sample overlay
[DtsBuddy.Diagnostic] Sampling GPIO with the user-supplied reader function for ~5 seconds
[DtsBuddy.Diagnostic] Behavior of the activated GPIO looks correct with 5 LOW samples and 5 HIGH samples
[DtsBuddy.Diagnostic] Unloading overlay testled
[DtsBuddy.Diagnostic] Everything looks OK
:ok

Example use, failing :

iex> {:ok, gpio} = Circuits.GPIO.open("GPIO12", :input)
{:ok, %Circuits.GPIO.CDev{}}
iex> reader = fn () -> Circuits.GPIO.read(gpio)
#Function<>
iex> DtsBuddy.Diagnostic.run_diagnostic(reader)
[DtsBuddy.Diagnostic] Running system checks
[DtsBuddy.Diagnostic] Device tree compiler is missing on the system.
[DtsBuddy.Diagnostic] All tests did not pass. Please refer to the above logs for further details.
:error