<#
.SYNOPSIS
    Wrapper-Skript für PeterPawns EVA-Tools PowerShell-Skripte

.DESCRIPTION
    PowerShell-Skript zum flashen von FRITZ!Boxen über den Bootloader
    mittels der im freetz erstellten *.image-Datei. Liegt bereits ein in-memory-Image
    vor, so muss der Paramter "-isbootable" zusätzlich angegeben werden.
    Dieses Skript benötigt die EVA-Tools aus PeterPawns GitHup-Repository.

    Wichtig: vor dem Ausführen des Skripts sollte sichergestellt sein, dass entweder am LAN-Interface
    eine feste IP-Adresse eingestellt ist oder wenn die IP-Zuweisung per DHCP statt findet, dass der
    DhcpMediasense (https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=&cad=rja&uact=8&ved=2ahUKEwjLw4jYgvvwAhUHmBQKHRulC8AQFjAAegQIAxAD&url=https%3A%2F%2Fdocs.microsoft.com%2Fde-de%2Ftroubleshoot%2Fwindows-server%2Fnetworking%2Fdisable-media-sensing-feature-for-tcpip&usg=AOvVaw0Gxeh5K_M2bfrhiHzUNnvO)
    deaktiviert wurde. 

    Bezüglich DhcpMediaSense öffnet man eine Powershell mit administrativen Rechten und führt "Set-NetIPv4Protocol -DhcpMediaSense Disabled" aus. Danach sollte
	überprüft werden, ob das LAN-Interface eine APIPA-Adresse bezogen hat. Wenn nicht, dann sollte ein "renew" des DHCP-Lease angestossen werden.

    Hat man eine APIPA-Adresse zugeteilt bekommen, führt man einfach dieses Skript aus (hierzu werden die administrativen Rechte nicht (mehr) benötigt).

	Nach erfolgreichem flashen der FRITZ!Box setzt man die Einstellung mittels "Set-NetIPv4Protocol -DhcpMediaSense Enabled" wieder zurück.
    

.NOTES
    Filename: FreetzTheBox.ps1

.EXAMPLE
    .\FreetzTheBox.ps1 -BoxType 7590 -ImageFile .\example.image [-BoxIP 192.168.178.1] [-isbootableImage]

.PARAMETER BoxType
    Der Name der Fritz!Box

.PARAMETER ImageFile
    Die Image-Datei, welche in den Bootloader der FRITZ!Box geschrieben werden soll. Vgl. hierzu "EXAMPLE"
	
.PARAMETER BoxIP
	Steuert das ansprechen der FRITZ!Box wÃ¤hrend des Startvorgangs entweder Ã¼ber die vordefinierte IP oder Ã¼ber eine eigene, festgelegte.
    
.PARAMETER isbootableImage
    Der Schalter funktioniert nur bei NAND-Boxen. Wird der Schalter gesetzt, wird das Ã¼bergebene Image als 
    RAM-Image behandelt und nicht mehr mit der Funktion "getbootableImage" behandelt.

.LINK
    https://github.com/PeterPawn/YourFritz

#>

#####################################################################
##
## Parameter-Definitionen

Param([Parameter(Mandatory = $True, HelpMessage = 'Fritz!Box-Type e.g. 3490')][int]$BoxType,
      [Parameter(Mandatory = $True, HelpMessage = 'The imagefile to load in the bootloader')][string]$ImageFile,
      [Parameter(Mandatory = $False, HelpMessage = 'The IP for searching the box while booting')][string]$BoxIP='192.168.178.1',
      [Parameter(Mandatory = $False, HelpMessage = 'Is it an in-memory image?')][switch]$isbootableImage=$false
    )


## Variablen-Definitonen
$SupportedBoxesArray = @{3390="NAND";3490="NAND";4020="NOR";4040="NOR";6820="NAND";6890="NAND";7590="NAND"};


## Überprüfung, ob die Paramterübergabe passt.
## Ist die angegebene Box im Array enthalten? Wenn nein, dann Skript-Abbruch!
Write-Verbose -Message "INFO: Wird die FRITZ!Box $BoxType unterstützt?";
if ( -not $SupportedBoxesArray.ContainsKey($BoxType) )
    {
        Write-Error -Message "FEHLER: Der angegebene Fritz!Box-Typ wird derzeit nicht unterstÃ¼tzt" -Category InvalidData -ErrorAction Stop;
        }

Write-Verbose -message "ERFOLG: Die angegebene FRITZ!Box $BoxType wird unterstÃ¼tzt. `n";


## Ist die Image-Datei angegeben worden und gibt es sie tatsächlich?
Write-Verbose -Message "INFO: Ist das ImageFile vorhanden?";
if (-not $(Test-Path $ImageFile))
    {
    Write-Error -Message "Dateiname $ImageFile nicht gefunden!" -Category ObjectNotFound -ErrorAction Stop;
    }
    
Write-Verbose -message "ERFOLG: Die Image-Datei wurde korrekt angeben und ist vorhanden. `n";
$ImageFile = resolve-path $ImageFile;


## Überprüfung, ob Neztwerkkabel am LAN-Interface angeschlossen ist oder DhcpMediaSense deaktiviert wurde
Write-Verbose -Message "INFO: Überprüfung, ob Neztwerkkabel am LAN-Interface angeschlossen ist oder DhcpMediaSense deaktiviert wurde..";
if ( $(Get-NetIPv4Protocol).DhcpMediaSense )
    {
    Write-Verbose -Message "INFO: Der DHCPMediaSense ist auf den Netzwerkschittstellen aktiv. Dies kann je nach Verbindung zur FRITZ!Box zu Problemen führen. `
    `Sollte ein LAN-Kabel verwendet werden, sollte entweder bereits eine APIPA-Adresse zugeteilt oder eine feste Adresse am Interface vorhanden sein, bevor `
	`bevor der Flash-Vorgang gesgtartet wird. Alternativ kann auch ein Switch zwischen PC und FRITZ!Box verbunden werden. Für weitere Informationen bitte die readme.md `
    `lesen (https://github.com/WileC/FreetzTheBox/blob/master/README.md) `n"
    }

if ( -not $(Get-NetIPAddress -AddressFamily IPv4 -InterfaceAlias Ether*,WLAN*).IPv4Address )
    {
    Write-Error -Message "FEHLER: Keiner Netzwerkschnittstelle wurde eine gÃ¼ltige IP-Adresse vergeben!" -Category ConnectionError -ErrorAction Stop;
    }


########################################
## Image-Datei für's flashen vorbereiten
##
## Toolbox für die Image-Dateien von PeterPawn aufrufen
. $pwd\FirmwareImage.ps1


#########################################################
##
## Skript-Aufruf von .\EVA-Discover.ps1
##

Write-Output "Bitte die FRITZ!Box nun an den Strom anschließen...";

if (-not $(.\EVA-Discover.ps1 -maxWait 120 -requested_address $BoxIP -Verbose -Debug))
    {
    Write-Error -Message "Keine FRITZ!Box gefunden!" -Category DeviceError -ErrorAction Stop
    }

Write-Verbose -message "ERFOLG: die FRITZ!Box $BoxType wurde im Bootloader angehalten. `n";
Read-Host -Prompt "Um fortzufahren [ENTER] drÃ¼cken...";

########################################################
##
## Skript-Aufruf von .\EVA-FTP-Client.ps1, je nach Speicherart
## und Flash-Vorgang
##

switch ($SupportedBoxesArray[$BoxType]) 
    {
        "NOR" { Write-Verbose -message "Starte Flash-Vorgang fÃ¼r NOR-Boxen...";

                $NORBootImageFile = "$pwd\Images\$((Get-Item $ImageFile).BaseName).NOR_bootable.image";
                Write-Verbose -message "Variable NORBootImageFile: $NORBootImageFile";

                if ( $(Test-Path $NORBootImageFile) ) { Remove-Item $NORBootImageFile -Verbose; }
               
                [FirmwareImage]::new($ImageFile).extractMemberAndRemoveChecksum("./var/tmp/kernel.image", $NORBootImageFile);
             
                sleep -Seconds 2;
                Write-Verbose -Message "INFO: flashe Firmware ...";

                .\EVA-FTP-Client.ps1 -Address $BoxIP -ScriptBlock { UploadFlashFile $NORBootImageFile mtd1 } -Verbose -Debug;
                sleep -Seconds 2;
                .\EVA-FTP-Client.ps1 -Address $BoxIP -ScriptBlock { RebootTheDevice } -Verbose -Debug;

                break;
              }

        "NAND" { Write-Verbose -message "Starte Flash-Vorgang fÃ¼r NAND-Boxen...";
		
                 if ( -not $isbootableImage) {
					$NANDBootImageFile = "$pwd\Images\$((Get-Item $ImageFile).BaseName).NAND_bootable.image";
					if ( $(Test-Path $NANDBootImageFile) ) { 
						Remove-Item $NANDBootImageFile -Verbose;
					}
					[FirmwareImage]::new($ImageFile).getBootableImage($NANDBootImageFile);
				 }
				 else {
					$NANDBootImageFile = $ImageFile;
				 }
				 
				 Write-Verbose -message "Variable NANDBootImageFile: $NANDBootImageFile";
				 sleep -Seconds 2;
                 Write-Verbose -Message "INFO: Wechsle Firmware-Partition der FRITZ!Box $BoxType...";

                 .\EVA-FTP-Client.ps1 -Address $BoxIP -ScriptBlock { SwitchSystem } -Verbose -Debug;
                 sleep -Seconds 2;
                 .\EVA-FTP-Client.ps1 -Address $BoxIP -ScriptBlock { BootDeviceFromImage $NANDBootImageFile } -Verbose -Debug;

                 break;
                }
    }


# Skript beenden
Read-Host -Prompt "Um das Skript zu beenden [ENTER] drücken...";
Exit 0;