* BSL430.NET -fixed download bug, coercing int division

+ WPF - added message box for first upload
+ WPF - added close button into dialogs
* docs, screenshots, wiki update

Author: parezj

docs/wiki/BSL430.NET.Console-App.md

@@ -77,54 +77,70 @@ Params
 Examples
 --------
 ### BSL430.NET
+Run this app without any cmd or param to show welcome screen with all info, commands, params, examples and enums.
+```powershell
+BSL430.NET.Console.exe
+```
+![Scan](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_home.png)
+
 #### Scan Devices
 Scan for all available devices.
 ```powershell
-BSL430NET.exe -s all
+BSL430.NET.Console.exe -s all
 ```
 Scan for all available devices and save XML output file.
 ```powershell
-BSL430NET.exe --scan all -x scan.xml
+BSL430.NET.Console.exe --scan all -x scan.xml
 ```
 Scan for single device
 ```powershell
-BSL430NET.exe -s ftdi
-BSL430NET.exe -s serial
-BSL430NET.exe -s usb
-BSL430NET.exe -s libftdi
+BSL430.NET.Console.exe -s ftdi
+BSL430.NET.Console.exe -s serial
+BSL430.NET.Console.exe -s usb
+BSL430.NET.Console.exe -s libftdi
 ```
 ![Scan](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_scan2.png)
 
 #### Upload to MCU
 Upload fw.hex to MSP430_F5xx via FTDI1 with default baud rate (9600 bd/s), standard invoke mechanism (shared JTAG pins).
 ```powershell
-BSL430NET.exe -u FTDI1 -f fw.hex -m MSP430_F5xx -i SHARED_JTAG
+BSL430.NET.Console.exe -u FTDI1 -f fw.hex -m MSP430_F5xx -i SHARED_JTAG
 ```
+![Upload](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_upload.png)
+
 Same action, same settings, but now faster (115200 bd/s) and save XML log.
 ```powershell
-BSL430NET.exe --upload FTDI1 -f fw.hex -m MSP430_F5xx -i SHARED_JTAG -b 115200 -x log.xml
+BSL430.NET.Console.exe --upload FTDI1 -f fw.hex -m MSP430_F5xx -i SHARED_JTAG -b 115200 -x log.xml
 ```
-![Upload](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_upload.png)
+![Upload](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_upload2.png)
 
 #### Download from MCU
-Download fw.txt (TI-TXT format) from MSP430_F5xx via COM1 with default baud rate (9600 bd/s), standard invoke mechanism (shared JTAG pins), from start address 0x8000, 0x7FFF byte count, with BSL password 32x 0xFF.
+Download fw.txt (TI-TXT format) from MSP430_F5xx via COM14 with default baud rate (9600 bd/s), standard invoke mechanism (shared JTAG pins), from start address 0x8000, 0x7FFE byte count, with BSL password 32x 0xFF.
 ```powershell
-BSL430NET.exe -d COM1 -f fw.txt -o TI_TXT -m MSP430_F5xx -i SHARED_JTAG -a 0x8000 -z 0x7FFF -p FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+BSL430.NET.Console.exe -d COM14 -f fw.txt -o TI_TXT -m MSP430_F5xx -i SHARED_JTAG -a 8000 -z 7FFE -p FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
 ```
+![Download](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_download.png)
+
+When MCU is not connected or disconnected, this error is shown:
+![Download](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_download_fail.png)
+
+When incorrect password is provided, this error is shown:
+![Download](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_download_fail_pw.png)
+
 Same action, same settings, but now faster (115200 bd/s), set output firmware line length to 64 bytes and save XML log.
 ```powershell
-BSL430NET.exe --download COM1 -f fw.txt -o TI_TXT -m MSP430_F5xx -i SHARED_JTAG -a 0x8000 -z 0x7FFF -b 115200 -x log.xml -y 64 -p FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
+BSL430.NET.Console.exe --download COM14 -f fw.txt -o TI_TXT -m MSP430_F5xx -i SHARED_JTAG -a 8000 -z 7FFE -b 115200 -x log.xml -y 64 -p FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
 ```
-![Download](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_download.png)
+![Download](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_download2.png)
 
 #### Erase MCU
-Erase MSP430_F5xx via FTDI2 with standard invoke mechanism (shared JTAG pins).
+Erase MSP430_F5xx via FTDI1 with standard invoke mechanism (shared JTAG pins).
 ```powershell
-BSL430NET.exe -e FTDI2 -m MSP430_F5xx -i SHARED_JTAG
+BSL430.NET.Console.exe -e FTDI1 -m MSP430_F5xx -i SHARED_JTAG
 ```
 Same action, same settings, but now save also XML log.
 ```powershell
-BSL430NET.exe --erase FTDI2 -m MSP430_F5xx -i SHARED_JTAG -x log.xml
+BSL430.NET.Console.exe --erase FTDI1 -m MSP430_F5xx -i SHARED_JTAG -x log.xml
 ```
 ![Erase](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_erase.png)
 
@@ -133,48 +149,49 @@ BSL430NET.exe --erase FTDI2 -m MSP430_F5xx -i SHARED_JTAG -x log.xml
 #### Convert
 Convert firmware fw_ti.txt (auto-detected) to Intel-HEX format and save it as fw_intel.hex.
 ```powershell
-BSL430NET.exe -c fw_ti.txt -f fw_intel.hex -o INTEL_HEX
+BSL430.NET.Console.exe -c fw_ti.txt -f fw_intel.hex -o INTEL_HEX
 ```
 Same action, but now also fill data gaps with 0xFF and set custom output line length to 64 bytes.
 ```powershell
-BSL430NET.exe --convert fw_ti.txt -f fw_intel.hex -o INTEL_HEX -l true -y 64
+BSL430.NET.Console.exe --convert fw_ti.txt -f fw_intel.hex -o INTEL_HEX -l true -y 64
 ```
 ![Convert](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_convert.png)
 
 #### Combine
 Combine TI-TXT firmware fw_ti.txt (auto-detected) with INTEL-HEX firmware fw_intel.hex (auto-detected) and save it as SREC firmware fw_srec.s19.
 ```powershell
-BSL430NET.exe -n fw_ti.txt -j fw_intel.hex -f fw_srec.s19 -o SREC
+BSL430.NET.Console.exe -n fw_ti.txt -j fw_intel.hex -f fw_srec.s19 -o SREC
 ```
 Same action, but now also fill data gaps with 0xFF and set custom output line length to 24 bytes.
 ```powershell
-BSL430NET.exe --combine fw_ti.txt -j fw_intel.hex -f fw_srec.s19 -o SREC -l true -y 24
+BSL430.NET.Console.exe --combine fw_ti.txt -j fw_intel.hex -f fw_srec.s19 -o SREC -l true -y 24
 ```
 ![Combine](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_combine.png)
 
 #### Compare
 Compare ELF firmware fw_elf.out with TI-TXT firmware fw_ti.txt.
 ```powershell
-BSL430NET.exe -r fw_elf.out -j fw_ti.txt
+BSL430.NET.Console.exe -k fw_elf.out -j fw_ti.txt
 
-BSL430NET.exe --compare fw_elf.out -j fw_ti.txt
+BSL430.NET.Console.exe --compare fw_elf.out -j fw_ti.txt
 ```
 ![Compare](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_compare.png)
+![Compare](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_compare2.png)
 
 #### Validate
 Validate ELF firmware fw_elf.out and get basic info.
 ```powershell
-BSL430NET.exe -v fw_elf.out
+BSL430.NET.Console.exe -v fw_elf.out
 
-BSL430NET.exe --validate fw_ti.txt
+BSL430.NET.Console.exe --validate fw_ti.txt
 ```
 ![Validate](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_validate.png)
 
 #### Get BSL Password
-Get BSL password (16/20/32 bytes long) to use it for correct download/upload. Read docs for more info.
+Get BSL password (16/20/32 bytes long) to use it for correct download/upload of MSP430_F5xx MCU. Read docs for more info.
 ```powershell
-BSL430NET.exe -r fw_intel.hex
+BSL430.NET.Console.exe -r fw_intel.hex -m MSP430_F5xx
 
-BSL430NET.exe --get-password fw_intel.hex
+BSL430.NET.Console.exe --get-password fw_elf.out -m MSP430_F5xx
 ```
 ![Password](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/console_get_password.png)

docs/wiki/BSL430.NET.FirmwareTools.Library.md

@@ -38,7 +38,7 @@ public void ParseFirmware(string FwPath)
     Firmware fw1 = FwTools.Parse(FwPath);                // Fw.Format = AUTO
     Firmware fw2 = FwTools.Parse(FwPath, FillFF: true);  // gaps are filled with 0xFF
     Firmware fw3 = FwTools.Parse(FwPath, FwFormat.SREC); // Fw.Format = SREC
-    Firmware fw4 = FwTools.Parse(FwPath, Log: new StringWriter()) // save parse log
+    Firmware fw4 = FwTools.Parse(FwPath, Log: new StringWriter()); // save parse log
 }
 ```
 

docs/wiki/BSL430.NET.GUI-App.md

@@ -41,7 +41,7 @@ BSL430.NET.WPF is built using **.NET Framework 4.6.1**. NET Core 3 (WPF) support
 Views
 -----
 ### Scan
-Scan for available devices. It is important to have drivers installed for using FTDI devices (FTD2XX). If you dont want to or cant install them, please use libftdi. Other device types are USB or Serial (COM) port.
+Scan for available devices. It is important to have drivers installed for using FTDI devices (FTD2XX). If you dont want to or cant install them, please use libftdi. Other device types are USB or Serial (COM).
 
 ![Scan1](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_scan2.png)
 
@@ -92,37 +92,70 @@ This view implements all main functionality of sub-package **BSL430.NET.Firmware
 ![FwTools2](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_dark.png)
 
 #### Convert
-Convert firmware TI-TXT, Intel-HEX or ELF format (auto detected) to firmware in TI-TXT, Intel-HEX or SREC format. There needs to be set output firmware format by combo-box and after clicking *Convert* button dialog windows opens. There is set output file path and optional check-box FillFF can be set (fill missing addr nodes with 0xFF and return monolithic piece of code). LineLength can be set via Tray Icon settings and it defines amount of data bytes per one text row. When = 0, default values are set (TI-TXT = 16, Intel-HEX = 32, SREC = 32).
+Convert firmware TI-TXT, Intel-HEX or ELF format (auto detected) to firmware in TI-TXT, Intel-HEX or SREC format. There needs to be set **output firmware format** by combo-box and after clicking *Convert* button dialog windows opens. There is set **output file path** and optional check-box **FillFF** can be set (fill missing addr nodes with 0xFF and return monolithic piece of code). LineLength can be set via Tray Icon settings and it defines amount of data bytes per one text row. Default values are set (TI-TXT = 16, Intel-HEX = 32, SREC = 32).
 
 ![Convert](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_convert.png)
 
 #### Combine
+Combines two firmware files into single one with format specified. Usually, main firmware and EEPROM file is done this way, or main firmware and Info A flash content is merged. There needs to be set **output firmware format** by combo-box and after clicking *Convert* button dialog windows opens. There is set **second firmware path** and **output file path** and optional check-box **FillFF** can be set (fill missing addr nodes with 0xFF and return monolithic piece of code). LineLength can be set via Tray Icon settings and it defines amount of data bytes per one text row. Default values are set (TI-TXT = 16, Intel-HEX = 32, SREC = 32).
+
 ![Combine](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_combine_dark.png)
 
 #### Validate
+Validate firmware file and show dialog window with specific firmware information. **Reset Vector** is MSP430 specifics, other properties are universal. **Format**, **CRC16**, **First Addres** and **Last Address** are pretty straight forward. **Code Size** is real count of bytes from file, **Full Size** is size of all (even missing 0xFF nodes) data located in MCU memory. If parse log is availabe, there is button *Show Parse Log*. If firmware is Valid, also button *Compare* is shown, providing ability to quickly compare this firmware to another.
+
 ![Validate1](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_validate.png)
 ![Validate2](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_validate_dark.png)
 
 #### Hex Edit
+If firmware is valid, opens dedicated window with hex editor (WpfHexEdit). Intel-HEX, TI-TXT and SREC can also be edited and saved, ELF is read-only. Status bar shows important things like addresses, size or scale. For save click button *Save* or close window and answer Yes in Message Box. There is also zoom feature, hold CTRL with mouse wheel.
+
 ![HexEdit1](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_hex_edit.png)
 ![HexEdit2](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_hex_edit_dark.png)
 
 #### Get Password
+This is MSP430 specific property. Validate firmware file and display BSL password for Upload/Download. Password is last 16-byte (F543x-non-A only) or 32-byte (others) of IVT (FFE0-FFFF), if newer 5xx/6xx MCU is used. If MCU from older series is used (1xx/2xx/4xx), password is exactly 20-byte long. Mostly it is 32-byte. You need to specify **MCU** family first for displaying password with correct length.
+
 ![Password](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_fw_tools_password.png)
 
 ### About
+This is only informational window displaying build version, github site, author name and contact and also list of packages used in this assembly.
+
 ![About1](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_about.png)
 ![About2](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_about_dark.png)
 
 Features
 --------
 ### Tray Icon Settings
+Tray icon is located at standard Windows tray bar, usually on right sight of start bar. For making things simple, BSL430.NET user settings can be set only from there.
+
+| Main Menu      | Sub Menu                     | Description |
+|----------------|------------------------------|-------------|
+| **Upload**     |                              | Open Upload View.
+| **Download**   |                              | Open Download View.
+| **Erase**      |                              | Open Erase View.
+| **FW Tools**   |                              | Open FW Tools View.
+| **BSL430.NET** |                              | Open About View.
+| Settings       | **Download Size Range**      | Set slider maximum property for Download view. Tweak this according to your MCU Flash memory size. Default is 128K.
+| Settings       | **FW Write Line Length**     | Defines amount of data bytes per one text row when creating firmware file. Default is AUTO -> TI-TXT = 16, Intel-HEX = 32, SREC = 32.
+| Settings       | **Minimize To Tray Bar**     | If true, when app is minimized, it hides from task bar and resides only in tray bar. Useful for long running.
+| Settings       | **Shell Default Action**     | Default action when either double clicked or right clicked on firmware file in windows explorer. Default is Validate.
+| Settings       | **Shell File Association**   | If true, firmware file extensions -> .hex .out .elf .s .srec .s19 .eep are associated with windows explorer for double click.  Requires elevating Admin UAC rights.
+| Settings       | **Shell Explorer Extension** | If true, any file right click in windows explorer opens menu with extensions and menu -> Open with BSL430.NET. Requires elevating Admin UAC rights.
+| Settings       | **Reset User Settings**      | Reset user settings to factory defaults. Requires elevating Admin UAC rights.
+| **Dark Mode**  |                              | Switch to dark theme, useful when running app in night or dark environment.
+| **Exit**       |                              | Exit Application.
+
 ![Tray1](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_tray.png)
 ![Tray2](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_tray_dark.png)
 
 ### Shell Integration
 #### Shell Association
+This feature needs to be turned on in tray icon settings or at the first start by clicking Yes in Message Box. When turned on (requires UAC Admin elevation), double click in windows explorer opens BSL430.NET and perform default action, that is set also in tray icon settings, default is Validate firmware. Firmware file extensions involved are: **.hex .out .elf .s .srec .s19 .eep**. There is also unified logo for those files created by merging simple file and BSL430.NET logo.
+
 ![Association](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_shell_association.png)
 
 #### Shell Extension
+This feature needs to be turned on in tray icon settings or at the first start by clicking Yes in Message Box. When turned on (requires UAC Admin elevation), right click any file opens popup menu box with menu item called **Open with BSL430.NET**. After clicking this menu item default action is done. This action is set also in tray icon settings, default is Validate firmware. 
+
 ![Extension](https://raw.githubusercontent.com/parezj/BSL430.NET/master/img/screenshots/wpf_gui_shell_extensions.png)