Tacho Bridge Application is an open-source application for Windows, macOS, or Linux designed to provide remote authentication of a tracker and tachograph via the company card.
Application is installed on the computer and provides an interface between company cards and flespi. It works with cards inserted into smart card readers operating via the standard PC/SC interface, as well as with multi-slot card racks (card hotels) connected over a serial (COM) port. Whenever the tracker needs to authenticate the tachograph using a company card the application will provide such functionality.
Repository link: Tacho Bridge App. At the moment, the application is available for Windows (x64), Linux (x64) and macOS (universal: Intel and Apple Silicon) operating systems. Using Linux may require installing additional dependencies, our recommendations. Once installed, the application keeps itself up to date: it checks for a new version on startup (or on demand from the settings) and installs the update in one click with an automatic restart. Only stable versions are offered by default; pre-release (alpha/beta) builds can be enabled with the "Receive pre-release updates" toggle in the settings.
This article covers only Tacho Bridge Application usage specifics. Consider reading the Tacho Setup guide to enable tacho functionality in your flespi account.
Setting up the Tacho Bridge Application
- Download and install the application on your device. Currently, versions are available for Windows, Linux and macOS.
- After starting the application, you need to configure the company cards for further work. The application supports simultaneous work with several cards. There are no software restrictions on the number of cards that can be used simultaneously.
Cards can be configured in advance, even without physically connecting them: click the ADD CARD button in the Smart cards list, enter the company card number written on the card (16 characters, as defined by the Annex 1C regulation (EU) 2016/799) and, optionally, a convenient card name.
When you connect a card to the computer, the application screen will display information about the connected card: 'reader name + ICCID'. ICCID (Integrated Circuit Card Identification) is the unique identifier of the card. A card that is not linked to any configuration yet is shown as UNKNOWN CARD.
To link the physical card, click on the (🔗) icon next to it and select the previously configured card in the list, or click the Add card button and enter the company card number right away.
After this, the ICCID will disappear and only the company card number will remain visible.
After the first successful authentication, the application automatically reads the card details and displays them next to the card: card generation and type, expiry date, company name and address, and the time and status of the last authentication. - Next, you need to enter the server settings so that the application can connect to the server. The channel where you connect the app should be configured with the tacho-bridge protocol and you should register in flespi the device of type Tacho Bridge App with the same ident in order to see the application connection status in your flespi account remotely. Open the settings by clicking the gear icon in the application header and fill in the "App ident" and "Server address" fields. The "Server address" is the domain and port of your tacho-bridge channel. The "App ident" is generated automatically and has a strict format: the TBA prefix followed by 13 digits, which makes it unique by default; just ensure that you used the same value in the flespi device and installed the Tacho Bridge App instance. When the connection to the server is established, the server icon in the application header turns green.
- Next, you need to create devices with the Tacho Bridge Card type for each company card. The company card number used when configuring the card in the application must be used as the device identifier.
- In order for the tracker to know which company card to contact, the same company card number must be entered into the actual device. For example, as it is done in Ruptela FM-Tco4 HCV.
Configuration file and logs
The application stores data in the user directory Documents/tba. This folder contains the configuration file config.yaml and application logs. The configuration file stores all application settings, including added cards. The application writes a detailed log of its work to the log.txt file. When the log file reaches 50 MB, it is rotated: older logs are compressed and kept in the archive subfolder. If errors occur in the application, the logs will help to understand the cause of the error.
The logs can also be fetched remotely: send the Fetch application logs command to the Tacho Bridge App device in your flespi account, choose the period (last day, week, or month), and the application will upload the zipped log file to the command result.
Additionally, the application version, operating system, and CPU architecture are reported by the application on connection and are visible in the read-only "Application Information" section of the device settings.
Troubleshooting
In the Tacho Bridge App device in your flespi account, you may track the status of the application via logs and messages. Each connection and disconnection will be logged as well as each added or removed card will also be logged into the logs to simplify the remote application administration.
If a company card is correctly configured in the application but appears with a gray icon and shows the card number, it means the card setup on the client side is valid, but there is an issue on the server side. This could happen if the Tacho Bridge Card device object is disabled, not created, or has an incorrect identifier. If the icon is green, it indicates that everything is properly configured both on the client and server sides. During the remote authentication process, the green card icon blinks. If an inserted card is shown as UNKNOWN CARD with an orange icon, it is not linked to any configured card yet - link it as described in the setup section.
If the card is removed from the reader, the card icon will be crossed out and will be gray, this means that the card is not connected to the reader and cannot be used.
Note that closing the application window does not stop the application: it hides to the system tray and keeps bridging the cards in the background. Use Show Window in the tray menu to bring the window back and Quit to exit the application completely.
The reader is connected but not detected. What to do?
Sometimes, even if a smart card reader is physically connected, the operating system may not detect it properly. This issue can be caused either by missing or incorrect drivers, or by the absence of a system-level service responsible for smart card communication. First, ensure that the appropriate driver for your smart card reader is installed. Drivers are typically included with the device or can be downloaded from the manufacturer’s website. Even if the reader appears as a USB device, without a proper driver it will not function as a smart card interface.
If the driver is correctly installed but the reader still does not work, the problem may lie in the system’s smart card service. On Windows, this is handled by the built-in Smart Card service (service name: SCardSvr). You can enable it by opening services.msc, finding “Smart Card” in the list, and ensuring it is set to start automatically or manually and that its status is Running.
On Linux, smart card support requires the pcscd daemon. Make sure it is installed and running (packages: pcscd, libpcsclite1, libccid). After installation, it is recommended to restart the service.
It is important to understand that the application does not affect the reader detection in any way. The operating system is responsible for this. That is, if the reader is not detected, then something is configured incorrectly, there can be no other options. If the application does not see the running service, then in the log ~/Documents/tba/log.txt you can see an error similar to "The Smart card resource manager is not running".