This is README.txt for Subaru FreeSSM software github
FreeSSM is a free and easy to use diagnostic and adjustment tool for SUBARU®
vehicles. It currently supports the models LEGACY®, LIBERTY®, OUTBACK®, BAJA®,
IMPREZA®, FORESTER® and TRIBECA® starting with model year 1999 and provides
access to the engine and transmission control units.
This program is NOT A PRODUCT OF FUJI HEAVY INDUSTRIES LTD. OR ANY SUBARU®-
ASSOCIATED COMPANY. It is a free reengineering project which is not contributed,
provided or supported by any company in any way.
If you are not good at computers and want FreeSSM program for a good price, it’s okay to have a decent cracked version like http://www.obdii365.com/wholesale/subaru-freessm-diagnostic-cable.html – saying sw is tested and it does have a good rank in Google
All trademarks are property of Fuji Heavy Industries Ltd. or their respective
Good to know: FreeSSM vs. SSM 3 vs. SSM 4
TABLE OF CONTENTS:
- Supported Platforms
- Starting FreeSSM
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
You should have received a copy of the GNU General Public License along with
this program (see file LICENCE.txt). If not, see <http://www.gnu.org/licenses/>.
The use of this program is AT YOUR OWN RISK. The author is NOT LIABLE FOR ANY
EFFECTS caused by usage, including UNEXPECTED VEHICLE BEHAVIOR or DAMAGES.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of FUNCTIONALITY ON YOUR VEHICLE,
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
TinyXML is released under the zlib license, see src/tinyxml/readme.txt and
www.sourceforge.net/projects/tinyxml for further informations.
- SUPPORTED PLATFORMS:
– Windows (XP and older are untested/unmaintained !)
With minor modifications, it should be possible to build FreeSSM on MacOS X
and other Unix systems, too, but there is currently no offical support.
Here’s the tip: FreeSSM setup on MacOS X
1.) FreeSSM source code (https://github.com/Comer352L/FreeSSM)
2.) Qt framework: Qt4 or Qt5
Development of Qt4 has been discontinued, the last release is v4.8.7.
Releases older than 4.8.7 are no longer tested !
There is no functional difference between Qt4 and Qt5 with regards to FreeSSM.
2.1.) Download sources:
Linux distributions usually provide ready packages in their
repositories, which should be preferred. Development packages are
2.2.) OS specifics:
Windows: The MinGW version of Qt is needed.
All other versions (e.g. for MS Visual Studio) are not
2.3.) General notes:
The sources of Qt are not required.
There is also no need to install tools such as Qt Creator etc.
3.) MinGW (only for MS Windows)
MinGW is usually shipped with Qt and just needs to be selected during
the installation process.
However, in the past the installation process changed very often.
There were times when it had to be downloaded and installed manually.
If the Qt-installer is not shipping MinGW, it usually provides at least a
direct link for downloading it. If that’s not the case, check
mingw.org and sourceforge.net/projects/mingw.
4.1 PRELIMINARY NOTE:
Only compilation from command line is maintained/tested (but compilation with
Qt Creator etc. might work as well).
4.2 COMPILATION STEPS (COMMAND LINE):
Open a console window and switch to the FreeSSM-directory.
NOTE (Windows only):
If MinGW is installed properly, there’s a start menu entry which opens a command
line window and sets up the environment for compilation:
e.g. “Start” > Qt 5.12.3 > 5.12.3 > MinGW 7.3.0 (64bit) > Qt 5.12.3 (MinGW 7.3.0 64bit)
or (if you have Qt4 AND Qt5 installed)
$ qmake-qt4 or $ qmake-qt5 (depending on your system environment)
If you want to build the version for small display resolutions, call qmake with
“CONFIG+=small-resolution” appended or uncomment the corresponding line in the
project file ‘FreeSSM.pro’ before calling qmake.
$ make release
$ make debug
$ make translation
NOTE (Windows only): depending on the used Qt-version and system configuration,
‘mingw32-make’ must be called instead of ‘make’.
$ make release-install
$ make debug-install
=> the application will be installed to
– Linux: the users home-directory (/home/userXYZ/FreeSSM)
– Windows: C:\FreeSSM (can be moved after installation)
$ make release-uninstall
$ make debug-uninstall
- STARTING FreeSSM from command line:
First, switch to the installation folder (see 5.).
You can append additional command line options if useful.
To get a full list of supported options and corresponding descriptions, start
FreeSSM with option “-h” (or “–help”).
$ ./FreeSSM -h
=> prints help text (list of supported command line options)
$ ./FreeSSM -c transmission -f mbssws -p selectionfile=”/home/users/myMBSWselection_4.list” autostart
=> starts directly into the transmission control unit dialog, selects reading of
measuring blocks and switches, loads the MB/SW selection file
“/home/users/myMBSWselection_4.list” and starts reading immediately