Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/traconiq/tachoparser/llms.txt

Use this file to discover all available pages before exploring further.

Tachoparser verifies the cryptographic signatures embedded in tachograph data files against a chain of EU certificates managed by the European Root Certification Authority (ERCA). Without these certificates, parsing still succeeds but all signature verification is skipped and the verified field on each data block will not be set to true. There are two certificate sets, one per tachograph generation:
  • pks1 — First-generation Digital Tachograph (DT) certificates
  • pks2 — Second-generation Smart Tachograph (ST) certificates
Once downloaded, place the certificate files in:
  • internal/pkg/certificates/pks1/
  • internal/pkg/certificates/pks2/
The repository includes Python download scripts that fetch and rename all available certificates automatically.
1

Install script dependencies

The scripts require the requests and lxml packages. If you do not already have them:
pip install requests lxml
2

Download first-generation certificates

cd scripts/pks1
./dl_all_pks1.py
The script downloads all DT public keys from ERCA and writes them to internal/pkg/certificates/pks1/.
3

Download second-generation certificates

cd ../pks2
./dl_all_pks2.py
The script downloads all ST public keys from ERCA and writes them to internal/pkg/certificates/pks2/.
Parsing works without any certificates installed. Only signature verification is affected — all other decoded fields are unaffected.

Build docs developers (and LLMs) love