Joulescope Driver
Welcome to the Joulescope™ Driver project. Joulescope is an affordable, precision DC energy analyzer that enables you to build better products.
This user-space C library communicates with Joulescope products to configure
operation and receive data. It supports the JS110, JS220, and JS320
Joulescope models. The first-generation driver introduced in 2019 was
written in Python. While Python proved to be a very flexible language enabling
many user scripts, it was difficult to support other languages.
This second-generation driver launched in 2022 addresses several issues
with the first-generation python driver including:
- Improved event-driven API based upon PubSub for easier integration with user interfaces and other complicated software packages.
- Improved portability for easier language bindings.
- Improved performance.
For more information, see:
- getting started (Python and C lifecycle)
- streaming topics (statistics and sample payloads)
- source code
- documentation
- pypi
- Joulescope (Joulescope web store)
- jls (Joulescope file format)
- forum
Python Installation
The python bindings work with Python 3.12 and later. To use the python bindings, ensure that you have a compatible version of python installed on your host computer. Then:
python -m pip install pyjoulescope_driver
For Ubuntu, you will also need to install the udev rules.
You can then run the pyjoulescope_driver python entry points:
python -m pyjoulescope_driver --help
python -m pyjoulescope_driver scan
python -m pyjoulescope_driver info
python -m pyjoulescope_driver values --device js320
Note that you may need to change "python" to "python3" or the full path.
You can also use a python
virtual environment.
Building
Ensure that your computer has a development environment including CMake.
Windows
Install cmake and your favorite build toolchain such as Visual Studio, mingw64, wsl, ninja.
macOS
For macOS, install homebrew, then:
brew install pkgconfig python3
Ubuntu 26.04 LTS
For Ubuntu:
sudo apt install cmake build-essential ninja-build libudev-dev
You will also need to install the udev rules. If you are using a modern Linux distribution managed by systemd, using tag-based rules is most likely the right choice:
$ wget https://raw.githubusercontent.com/jetperch/joulescope_driver/main/72-joulescope.rules
$ sudo cp 72-joulescope.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules
If your system is not managed by systemd or your user is not assigned a proper login seat (as may be the case when logging in via SSH), using group-based rules is necessery (note that the plugdev group must exist/be created and your user must belong to it):
$ wget https://raw.githubusercontent.com/jetperch/joulescope_driver/main/99-joulescope.rules
$ sudo cp 99-joulescope.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules
Common
cd {your/repos/joulescope_driver}
mkdir build && cd build
cmake ..
cmake --build . && ctest .
This package includes a command-line tool, jsdrv:
jsdrv --help
jsdrv scan
The build also produces jsdrv_quickstart from
example/quickstart.c, the minimal C program
described in doc/getting_started.md.
Build python bindings
Install a compatible version of Python 3.12 or later. To install the pyjoulescope_driver dependencies:
cd {your/repos/joulescope_driver}
python -m pip install -U -r requirements.txt
You should then be able to build the native bindings:
python setup.py build_ext --inplace
You can build the package using isolation:
python -m build
Depending upon your system configuration, you may need to replace "python" with "python3" or the full path to your desired python installation.
On Windows, you may be prompted to install the Microsoft C++ Build Tools.
License
The Joulescope driver source code is licensed under the Apache-2.0 license. The project is free for commercial and non-commercial use. The bundled third-party libraries are provided under their respective licenses, as recorded in REUSE.toml.
The project is compliant with Reuse Software.
python -m pip install reuse[charset-normalizer]
python -m reuse lint
The reuse tool can generate a software bill of materials (SBOM) in SPDX format.
python -m reuse spdx
Each GitHub release includes this SPDX SBOM as the
joulescope_driver-vX.Y.Z.spdx asset.
1 maintainer
Metadata
1 maintainer
Release files for pyjoulescope-driver 2.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyjoulescope_driver-2.5.2.tar.gz | 4.8 MB | Details |
Built distributions (wheels)
Total release size: 87.3 MB
Release files / pyjoulescope_driver-2.5.2.tar.gz
| Download URL | pyjoulescope_driver-2.5.2.tar.gz |
|---|---|
| Size | 4.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f5a19a954de7493f49778fc4aa5d9608dc333494e96f8ab0bbee82ece08da610
|
|
BLAKE2b-256 checksum How to use checksums |
abe7a88c10bcd2136431a54c4edc2b4ae5ffd573120d7a69f985fe774d9f4b8c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp314-cp314-win_arm64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp314-cp314-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.14 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
6875621424f9365534e05f96fc3e93481d4de4b9a034d963690d910e06fdd702
|
|
BLAKE2b-256 checksum How to use checksums |
e836c1776ff6208bfae3e26cdf5bd792bb8ee05b5b3f1816ef175cbe4472135d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp314-cp314-win_amd64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3d86dad7f7004f3071b8237fbf607ad2e9878d5331626f06f4ee9d67242446db
|
|
BLAKE2b-256 checksum How to use checksums |
4dea0055d15f44688fa36df1114762c38ce5fa2da192a40451df20ab77960c66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.2 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
3cafd20f48b8d70b687d8e111607919f2463fabe17d974aeea06243aa764d950
|
|
BLAKE2b-256 checksum How to use checksums |
0182d1afb64ab76a75104b02068155f43fb20e8988a6992c607bfededd5f94fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp314-cp314-manylinux_2_28_aarch64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp314-cp314-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 7.1 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
222354883509bb236ddcdae36a057efb7e6693e295f4343054ada06529715b35
|
|
BLAKE2b-256 checksum How to use checksums |
f3b913e9710cc9d3264a9f1378f3f9103e4c3cb9081604c19633ae4b1a6ab368
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp314-cp314-macosx_10_15_universal2.whl
| Download URL | pyjoulescope_driver-2.5.2-cp314-cp314-macosx_10_15_universal2.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.14 macOS 10.15+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
c53af3fcce996a07cce3748b13f16e4727d73c71727db10912faf2a0db0248a2
|
|
BLAKE2b-256 checksum How to use checksums |
cdf8ca09d6fe62f87a9d4c82fe5f064f2816e963422214172a59dc97cd073bb4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp313-cp313-win_arm64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp313-cp313-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.13 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
b994c1c791b2001afa3e9f8b6586af838f27718614d9aa9dd985d48ef96ef80b
|
|
BLAKE2b-256 checksum How to use checksums |
815cdf48295f3fec75ec2496fbe395104c4b1b0eef0716fd828788d6346167ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp313-cp313-win_amd64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8454db10ac7e629ae9018a60215abb247836c9900839445371233e5136d517a8
|
|
BLAKE2b-256 checksum How to use checksums |
e7402f21ef04492adf0f76284d3df4dbc1996a74c27c6c0def393afac511e1f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.2 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e2f399357f10911676ed8937d00d56f7f12a27b716c53f22fe7466c4d8d8fa5c
|
|
BLAKE2b-256 checksum How to use checksums |
4d801c26084c00f55fc40bf5f2d71ffdb03fbc21eb2aa1e72ca5b671472727e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp313-cp313-manylinux_2_28_aarch64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp313-cp313-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 7.1 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
06b6200b58248bf79902a97bde5acade9477ee9041198bae7166cb4e028cc4b4
|
|
BLAKE2b-256 checksum How to use checksums |
0d4c9992a8370246474ccd143345accf0d9c7374e24ebcffa05918846093c122
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp313-cp313-macosx_10_13_universal2.whl
| Download URL | pyjoulescope_driver-2.5.2-cp313-cp313-macosx_10_13_universal2.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.13 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
124cb3ade5fcdf76c58cacbaaba508cd4d878ddbfd190a2e04158d3db884bb41
|
|
BLAKE2b-256 checksum How to use checksums |
9f73da81583404bbd74948ab158e5441df7a973e7fc3764ea5d684bf3840b215
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp312-cp312-win_arm64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp312-cp312-win_arm64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.12 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
559bafaae51fa16562a3b76b861195eea340eebdf126e00b93b39d1807755211
|
|
BLAKE2b-256 checksum How to use checksums |
48d1136f83347aafe1b8c047674b9ff75ac0741505a22de68beb69f89ba24d3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp312-cp312-win_amd64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d5cca8b2275ba0a9dd118391b316c022772d3a2183096d77822279b231d4ae57
|
|
BLAKE2b-256 checksum How to use checksums |
b2353a7406bf6fe2f3e4ec449316b27c00af50b34281e6414874667ff14b91a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.2 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
84dbcb593e8335b44c56c50ce55e6a9690f44e30397fea0679f923533eaa4c78
|
|
BLAKE2b-256 checksum How to use checksums |
101741fba3591991215ad3c21aef3fa2e2b2cdd0dec887514a56f58cd1c746b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp312-cp312-manylinux_2_28_aarch64.whl
| Download URL | pyjoulescope_driver-2.5.2-cp312-cp312-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 7.1 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
b2e830bdb5cd8eaf0866ad92c3a5affff53a479de8e45e365a4cc7b4cff81ff4
|
|
BLAKE2b-256 checksum How to use checksums |
d54536034fbfdce7f7b174b0e5a45e212911ee55d4fdd9a0a187e90108e35dc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / pyjoulescope_driver-2.5.2-cp312-cp312-macosx_10_13_universal2.whl
| Download URL | pyjoulescope_driver-2.5.2-cp312-cp312-macosx_10_13_universal2.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
8ba11f75846b1a67034c7956daf6167373abcd04f7827c693ad8ba8fde2fb89d
|
|
BLAKE2b-256 checksum How to use checksums |
dbbf5efbadee5e9b418d8f494ea4d77da4c1ce877d7e31f46c690649188bb688
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency log
