Repository navigation
Installation
English · Italiano
| What | Notes |
|---|---|
| Windows 10 or 11, 32 or 64 bit | Also Windows 7 SP1 (see below) |
| Microsoft Visual C++ 2013 Redistributable (x86) | Needed by components inherited from BUSMASTER (database engine, XML library, PEAK driver). The installer adds it; with a portable zip, most PCs already have it, and BUSMASTER-NG tells you at start-up if it is missing. Install the x86 version also on 64-bit Windows |
| The driver of your CAN / LIN interface | From the interface vendor: PEAK, Vector, Kvaser, ETAS, IntrepidCS, IXXAT, ... Not needed for the Simulation driver |
| Node simulation only: MinGW (GCC for Windows, 32 bit) | See Node simulation |
The newer C++ and MFC runtimes are already inside the BUSMASTER-NG folder.
From version 3.4.2 the Releases page has three files, with the same program inside:
| File | For |
|---|---|
BUSMASTER-NG_<version>_setup.exe |
Installer, Windows 7 SP1, 10 and 11. The easiest choice |
BUSMASTER-NG_<version>_win32.zip |
Portable, no setup, Windows 10 and 11 |
BUSMASTER-NG_<version>_win32_win7.zip |
Portable, no setup, Windows 7 SP1 (it adds the Universal C runtime that Windows 7 lacks) |
Versions up to 3.4.1 have a single zip, which works on Windows 7 to 11.
The files of BUSMASTER-NG are not signed yet (a code signing certificate costs money that this free project does not have), so Windows does not know who made them:
-
"Windows protected your PC" (SmartScreen) when you start the installer or
BUSMASTER.exe: click More info, then Run anyway. - Some browsers say the file "is not commonly downloaded": choose Keep.
Download only from the Releases page. To check that a file
is exactly the published one, compare its SHA-256 with the sha256:... shown next to the file on that page:
Get-FileHash .\BUSMASTER-NG_3.5.0_setup.exe
(PowerShell; replace the name with your file.)
- Start
BUSMASTER-NG_<version>_setup.exeand choose Install for all users (administrator rights) or Install for me only. - If the Visual C++ 2013 runtime is missing, the installer adds it. It is installed for the whole PC, so Windows may ask for administrator permission. On Windows 7 the installer also copies the Universal C runtime.
- Start BUSMASTER-NG from the Start menu, which also has Format Converter and the read-me. A desktop icon is optional.
To update, choose Help → Check for Updates: when there is a newer version, Install now downloads the installer (checked against the SHA-256 that GitHub gives for it), closes BUSMASTER-NG and installs the update, then starts it again. Help → Check at Startup (off unless you turn it on) does the check every time BUSMASTER-NG starts and speaks up only when there is a new version. Windows asks for administrator permission when it is installed for all users. You can also run the installer of the new version by hand: it replaces the old one in the same folder. To uninstall, use Settings → Apps (or Control Panel → Programs) or Uninstall BUSMASTER-NG in the Start menu.
- Download the zip for your Windows version.
- Extract it to a folder you can write to, for example
C:\Tools\BUSMASTER-NG. - Start
BUSMASTER.exe. You can pin it to the taskbar or create a shortcut.
To update, extract the new version to a new folder (or over the old one); Check for Updates only opens the release page for a portable copy. To uninstall, delete the folder.
Window positions and the last configuration are stored per version: after an update, load your configuration once (File → Load).
BUSMASTER-NG can be used next to an installed BUSMASTER 3.2.2: they do not share the program folder.
In CAN → Driver Selection you find: Simulation, ETAS BOA, ETAS ES581.3, ES581.4, ES582.1, ETAS ISOLAR-EVE, i-VIEW, IntrepidCS neoVI, IXXAT VCI, Kvaser CAN, MHS Tiny-CAN, NSI CAN-API, PEAK PCAN-Basic, PEAK USB (Legacy), Vector XL and VScom CAN-API. LIN: ETAS BOA, ISOLAR-EVE, Kvaser, PEAK and Vector XL.
Each one needs the driver of its vendor installed on the PC. If a driver cannot be loaded, BUSMASTER-NG says which file is missing and why, and switches to the Simulation driver (see Troubleshooting).
Since 3.7.5 there are two PEAK drivers in CAN → Driver Selection:
-
PEAK PCAN-Basic (new, open source): for the PEAK-System interfaces (USB, PCI, PC Card, LAN). It needs the
PEAK device driver installed on the PC, which brings
PCANBasic.dll: BUSMASTER-NG does not contain it. Every PEAK channel of the PC is listed in the hardware selection with its firmware, and you choose the speed from the list (the PEAK special speeds 33.3, 47.6, 83.3 and 95.2 kbit/s are there too). Under Advanced a channel can be set to listen-only: it only receives, without acknowledge or error frames, so you can watch a bus without disturbing it. A channel that is open in PCAN-View can be connected as well. Received messages carry the time stamp of the interface. - PEAK USB (Legacy): the old driver of the original BUSMASTER, unchanged. A configuration saved with PEAK USB still opens with it.
The decoding of the error frames of the new driver (type of error and counters) is not tested yet.
Use the installer or the _win7 zip (up to 3.4.1: the only zip) on Windows 7 SP1. With the zip, install the Visual
C++ 2013 Redistributable x86 as above.
BUSMASTER-NG 3.4.1 was tested on a clean Windows 7 PC: it starts, and the Simulation driver connects and
sends messages. Use 3.4.1 or later: with the Simulation driver, 3.3.0 and 3.4.0 hang on the splash screen on a
PC where BUSMASTER was never installed.
The other functions and the interface drivers are not tested on Windows 7 yet. If you try them, please tell us how it went in an issue.
BUSMASTER-NG · community fork of BUSMASTER (ETAS / Bosch), LGPL v3 · not affiliated with ETAS GmbH or Robert Bosch GmbH · Something wrong or out of date on this page? / Qualcosa di sbagliato o non aggiornato? Open an issue