GKFlasher Instructions: Difference between revisions
m (Changed text formatting) |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
<div style="float:right">__TOC__</div> | <div style="float:right">__TOC__</div> | ||
GKFlasher is an open source Python project supported by OpenGK, written by dante383 and dmg210. This project is a multi OBD2 tool for the Siemens ECUs found on the Hyundai and Kia vehicles. It can read & write tune data, correct EEPROM checksums and clear adaptive values from your ECU. The purpose of this article is to instruct you how to download, install and configure all the prerequisites for GKFlasher. | GKFlasher is an open source Python project supported by OpenGK, written by dante383 and dmg210. This project is a multi OBD2 tool for the Siemens ECUs found on the Hyundai and Kia vehicles. It can read & write tune data, correct EEPROM checksums and clear adaptive values from your ECU. The purpose of this article is to instruct you how to download, install and configure all the prerequisites for GKFlasher. If you are a GitHub user, please go star the following repository: | ||
https://github.com/Dante383/GKFlasher | https://github.com/Dante383/GKFlasher | ||
| Line 8: | Line 8: | ||
'''1)''' First you will need a FTDI USB-OBD2 interface cable. This is often the same cable used on German vehicles. The chipset on the board must be a real FTDI chip and cannot be one of the CH340C chips. Through extensive testing we found that the following cable is the least expensive and most reliable cable for GKFlasher: | '''1)''' First you will need a FTDI USB-OBD2 interface cable. This is often the same cable used on German vehicles. The chipset on the board must be a real FTDI chip and cannot be one of the CH340C chips. Through extensive testing we found that the following cable is the least expensive and most reliable cable for GKFlasher: | ||
[https://www.aliexpress.us/item/2251832612703671.html Galletto 1260 ECU Chip Tuning Tool EOBD Programmer FTDI] | [https://www.aliexpress.us/item/2251832612703671.html <s>Galletto 1260 ECU Chip Tuning Tool EOBD Programmer FTDI</s>] This adapter has a bug with the hardware flow control which prevents the fastInit wake-up sequence. | ||
Pictured here shows the good FTDI chipset and the bad CH340C chipset. Avoid the CH340C chipsets completely. | Pictured here shows the good FTDI chipset and the bad CH340C chipset. Avoid the CH340C chipsets completely. | ||
[[File:FTDI Example.png|269x269px]]:[[File:CH340C Example.png]] | [[File:FTDI Example.png|269x269px]]:[[File:CH340C Example.png]] | ||
From GKFlasher v1.0.5 we have added support for the CH340 chipset. | |||
'''2)''' Download the following files: | '''2)''' Download the following files: | ||
| Line 19: | Line 21: | ||
[https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe python-3.11.9-amd64.exe] | [https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe python-3.11.9-amd64.exe] | ||
''Optional download for npcap if you are using a CAN BUS interface for a specific purpose:'' | ''Optional download for npcap if you are using a CAN BUS interface for a specific purpose:'' | ||
| Line 39: | Line 39: | ||
[[File:Python Install 2.png]] | [[File:Python Install 2.png]] | ||
Select "Install Pyhon 3.11 for all users from the following screen: | Select "Install Pyhon 3.11 for all users" from the following screen: '''"Add Python to environment variables" has to be selected!''' | ||
[[File:Python Install 3.png]] | [[File:Python Install 3.png]] | ||
'''5)''' Once installation is complete you may need to logout of windows or restart your computer before the Powershell will recognize the new PATH entries for GIT and Python. To test if either program works, try the following commands after the '''>''' symbol in Windows Powershell and you should see the following responses if all is well. If you do not see these responses or receive a "ObjectNotFound" type of error, then try the above installations again. | '''5)''' Once installation is complete you may need to logout of windows or restart your computer before the Powershell will recognize the new PATH entries for GIT and Python. To test if either program works, try the following commands after the '''>''' symbol in Windows Powershell and you should see the following responses if all is well. If you do not see these responses or receive a "ObjectNotFound" type of error, then try the above installations again. | ||
PS C:\Users\cfham> ''' | PS C:\Users\cfham> '''python -V''' | ||
Python 3.11.9 | Python 3.11.9 | ||
PS C:\Users\cfham> '''git.exe -v''' | PS C:\Users\cfham> '''git.exe -v''' | ||
git version 2.44.0.windows.1 | git version 2.44.0.windows.1 | ||
=== NPCAP Install (Optional) === | === NPCAP Install (Optional) === | ||
| Line 84: | Line 77: | ||
PS C:\GIT Repos\GKFlasher> ''' | PS C:\GIT Repos\GKFlasher> '''python -m pip install -r requirements.txt''' | ||
Requirement already satisfied: alive_progress==3.1.5 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 1)) (3.1.5) | Requirement already satisfied: alive_progress==3.1.5 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 1)) (3.1.5) | ||
Requirement already satisfied: crcmod==1.7 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 2)) (1.7) | Requirement already satisfied: crcmod==1.7 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 2)) (1.7) | ||
| Line 99: | Line 92: | ||
Requirement already satisfied: PyQt5-Qt5>=5.15.2 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from pyqt5==5.15.9->-r requirements.txt (line 5)) (5.15.2) | Requirement already satisfied: PyQt5-Qt5>=5.15.2 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from pyqt5==5.15.9->-r requirements.txt (line 5)) (5.15.2) | ||
'''4)''' If everything went well you should now be able to start the GKFlasher GUI with the USB cable plugged in. Try the following command and you should see the GKFlasher window appear: | '''4)''' If everything went well you should now be able to start the GKFlasher GUI with the USB cable plugged in. Try the following command and you should see the GKFlasher window appear: | ||
PS C:\GIT Repos\GKFlasher> ''' | PS C:\GIT Repos\GKFlasher> '''python gui.py''' | ||
[[File:GKFlasher First Time.png|701x701px]] | [[File:GKFlasher First Time.png|701x701px]] | ||
'''5) Optional:''' Create a desktop shortcut to open GKFlasher easily. First we'll need to know the location of your python3.11.exe executable. Execute the following command from your Powershell or command prompt and enter the command after the '''>''' symbol. The following line you will use to copy/paste into your desktop shortcut. In this example it is located in my local user's directory within a subfolder. Yours will vary depending on your username. | '''5) Optional:''' Create a desktop shortcut to open GKFlasher easily. First we'll need to know the location of your python3.11.exe executable. Execute the following command from your Powershell or command prompt and enter the command after the '''>''' symbol. The following line you will use to copy/paste into your desktop shortcut. In this example it is located in my local user's directory within a subfolder. Yours will vary depending on your username. | ||
PS C:\GIT Repos\GKFlasher> '''(Get-Command | PS C:\GIT Repos\GKFlasher> '''(Get-Command python.exe).Path''' | ||
C:\Users\cfham\AppData\Local\Microsoft\WindowsApps\ | C:\Users\cfham\AppData\Local\Microsoft\WindowsApps\python.exe | ||
Right click on your desktop and go to "New" and "Shortcut", then paste the line you found from the last Powershell command and click next: | Right click on your desktop and go to "New" and "Shortcut", then paste the line you found from the last Powershell command and click next: | ||
| Line 115: | Line 108: | ||
[[File:GKFlasher Desktop Shortcut 3.png|border]] | [[File:GKFlasher Desktop Shortcut 3.png|border]] | ||
Now right click on that new shortcut and select properties. You will change a couple of settings in this new window so that it starts the GKFlasher app and change to the correct starting directory. First add " gui.py" (Contains a space) to the end of the | Now right click on that new shortcut and select properties. You will change a couple of settings in this new window so that it starts the GKFlasher app and change to the correct starting directory. First add " gui.py" (Contains a space) to the end of the target prompt and copy/paste the directory location you chose for your GIT Repos containing GKFlasher and press apply. The following is using my example directory. Yours may be unique. | ||
[[File:GKFlasher Desktop Shortcut 4.png|border]] | [[File:GKFlasher Desktop Shortcut 4.png|border]] | ||
If you would like to add an icon to your shortcut, you can download the OpenGK/GKFlasher logo from [https://opengk.org/files/Users/chase206/Siemens_T_Logo.ico Siemens_T_Logo.ico] and add it to your GKFLasher shortcut using the "Change Icon" button. | If you would like to add an icon to your shortcut, you can download the OpenGK/GKFlasher logo from [https://opengk.org/files/Users/chase206/Siemens_T_Logo.ico Siemens_T_Logo.ico] and add it to your GKFLasher shortcut using the "Change Icon" button. | ||
Latest revision as of 21:53, 23 November 2024
GKFlasher is an open source Python project supported by OpenGK, written by dante383 and dmg210. This project is a multi OBD2 tool for the Siemens ECUs found on the Hyundai and Kia vehicles. It can read & write tune data, correct EEPROM checksums and clear adaptive values from your ECU. The purpose of this article is to instruct you how to download, install and configure all the prerequisites for GKFlasher. If you are a GitHub user, please go star the following repository:
https://github.com/Dante383/GKFlasher
Windows 10 & 11 Installation
Prerequisites
1) First you will need a FTDI USB-OBD2 interface cable. This is often the same cable used on German vehicles. The chipset on the board must be a real FTDI chip and cannot be one of the CH340C chips. Through extensive testing we found that the following cable is the least expensive and most reliable cable for GKFlasher:
Galletto 1260 ECU Chip Tuning Tool EOBD Programmer FTDI This adapter has a bug with the hardware flow control which prevents the fastInit wake-up sequence.
Pictured here shows the good FTDI chipset and the bad CH340C chipset. Avoid the CH340C chipsets completely.
:
From GKFlasher v1.0.5 we have added support for the CH340 chipset.
2) Download the following files:
Optional download for npcap if you are using a CAN BUS interface for a specific purpose:
Install GIT & Python
3) Open the Git install file named Git-2.44.0-64-bit.exe selecting "Git from the command line" from the following screen, then continue with all the default options afterwards:
4) Open the Python installation file named python-3.11.9-amd64.exe and on the first dialogue select "Add python.exe to PATH"
Keep all the default values on the following screen:
Select "Install Pyhon 3.11 for all users" from the following screen: "Add Python to environment variables" has to be selected!
5) Once installation is complete you may need to logout of windows or restart your computer before the Powershell will recognize the new PATH entries for GIT and Python. To test if either program works, try the following commands after the > symbol in Windows Powershell and you should see the following responses if all is well. If you do not see these responses or receive a "ObjectNotFound" type of error, then try the above installations again.
PS C:\Users\cfham> python -V Python 3.11.9
PS C:\Users\cfham> git.exe -v git version 2.44.0.windows.1
NPCAP Install (Optional)
1) If you are using CANBUS for your read/write functions, open and install the file named npcap-1.79.exe using default options.
GKFlasher Setup
1) Open your Powershell or Command prompt and change to the desired directory where you will be installing the GKFlasher files. A typical example directory might be in C:\GIT Repos\ so create yourself a directory in the C:\ drive named "GIT Repos" for this example. Use the following commands after the > symbol:
PS C:\Users\cfham> mkdir "C:\GIT Repos"
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 4/6/2024 7:10 PM GIT Repos
2) Change to the "GIT Repos" directory and run the GIT command to download the GKFlasher files to your desired directory using the following command after the > symbol:
PS C:\Users\cfham> cd "C:\GIT Repos" PS C:\GIT Repos> git clone https://github.com/Dante383/GKFlasher Cloning into 'GKFlasher'... remote: Enumerating objects: 1071, done. remote: Counting objects: 100% (117/117), done. remote: Compressing objects: 100% (69/69), done. remote: Total 1071 (delta 58), reused 96 (delta 48), pack-reused 954 Receiving objects: 100% (1071/1071), 446.77 KiB | 7.45 MiB/s, done. Resolving deltas: 100% (672/672), done.
3) Change to the GKFlasher directory then install the required Python packages with the following commands after the > symbol:
PS C:\GIT Repos> cd GKFlasher
PS C:\GIT Repos\GKFlasher> python -m pip install -r requirements.txt Requirement already satisfied: alive_progress==3.1.5 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 1)) (3.1.5) Requirement already satisfied: crcmod==1.7 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 2)) (1.7) Requirement already satisfied: gkbus==0.1.8 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 3)) (0.1.8) Requirement already satisfied: pyftdi==0.55.0 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 4)) (0.55.0) Requirement already satisfied: pyqt5==5.15.9 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 5)) (5.15.9) Requirement already satisfied: PyYAML==6.0.1 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from -r requirements.txt (line 6)) (6.0.1) Requirement already satisfied: about-time==4.2.1 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from alive_progress==3.1.5->-r requirements.txt (line 1)) (4.2.1) Requirement already satisfied: grapheme==0.6.0 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from alive_progress==3.1.5->-r requirements.txt (line 1)) (0.6.0) Requirement already satisfied: pyserial==3.5 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from gkbus==0.1.8->-r requirements.txt (line 3)) (3.5) Requirement already satisfied: scapy==2.5.0 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from gkbus==0.1.8->-r requirements.txt (line 3)) (2.5.0) Requirement already satisfied: pyusb!=1.2.0,>=1.0.0 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from pyftdi==0.55.0->-r requirements.txt (line 4)) (1.2.1) Requirement already satisfied: PyQt5-sip<13,>=12.11 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from pyqt5==5.15.9->-r requirements.txt (line 5)) (12.13.0) Requirement already satisfied: PyQt5-Qt5>=5.15.2 in c:\users\cfham\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages (from pyqt5==5.15.9->-r requirements.txt (line 5)) (5.15.2)
4) If everything went well you should now be able to start the GKFlasher GUI with the USB cable plugged in. Try the following command and you should see the GKFlasher window appear:
PS C:\GIT Repos\GKFlasher> python gui.py
5) Optional: Create a desktop shortcut to open GKFlasher easily. First we'll need to know the location of your python3.11.exe executable. Execute the following command from your Powershell or command prompt and enter the command after the > symbol. The following line you will use to copy/paste into your desktop shortcut. In this example it is located in my local user's directory within a subfolder. Yours will vary depending on your username.
PS C:\GIT Repos\GKFlasher> (Get-Command python.exe).Path C:\Users\cfham\AppData\Local\Microsoft\WindowsApps\python.exe
Right click on your desktop and go to "New" and "Shortcut", then paste the line you found from the last Powershell command and click next:
Type in "GKFlasher" into the next window and press Finish:
Now right click on that new shortcut and select properties. You will change a couple of settings in this new window so that it starts the GKFlasher app and change to the correct starting directory. First add " gui.py" (Contains a space) to the end of the target prompt and copy/paste the directory location you chose for your GIT Repos containing GKFlasher and press apply. The following is using my example directory. Yours may be unique.
If you would like to add an icon to your shortcut, you can download the OpenGK/GKFlasher logo from Siemens_T_Logo.ico and add it to your GKFLasher shortcut using the "Change Icon" button.
