akrocansim


Nameakrocansim JSON
Version 0.6.1 PyPI version JSON
download
home_pageNone
Summaryakrocansim is a CAN bus J1939 controller simulator
upload_time2024-02-04 13:18:34
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords j1939 can bus
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # akrocansim
A CAN bus J1939 controller simulator.

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akrocansim)](https://github.com/cfsok/akrocansim)
[![PyPI - Version](https://img.shields.io/pypi/v/akrocansim?color=blue)](https://pypi.org/project/akrocansim/)
![PyPI - License](https://img.shields.io/pypi/l/akrocansim)


## Built with
- [python-can](https://github.com/hardbyte/python-can)
- [DearPyGUI](https://github.com/hoffstadt/DearPyGui)
- [openpyxl](https://openpyxl.readthedocs.io/)

## Features
- Integrates with all hardware CAN interfaces supported by python-can.
- Transmits configured J1939 PGNs to the CAN bus with the following methods:
  - continuous tx of all PGNs
  - all PGNs transmitted once on button press
  - per PGN transmission, either continuous or on button press
- GUI for setting SPN values:
  - sliders for changing continuous values
  - label selection for discrete values
  - direct entry of raw decimal values
  - direct entry of decoded decimal values

![Akrocansim demo screenshot](https://raw.githubusercontent.com/cfsok/akrocansim/main/docs/images/demo_2_Akrocansim.png)

![PCAN-View demo screenshot](https://raw.githubusercontent.com/cfsok/akrocansim/main/docs/images/demo_1_PCAN-View.png)

## Installation
Python 3.11 (64-bit) or higher is required.

```
pip install akrocansim
```

## Prerequisites
- A hardware CAN interface supported by python-can,
see https://python-can.readthedocs.io/en/v4.3.1/interfaces.html.
- A version of J1939 Digital Annex (J1939DA) from SAE International, see https://www.sae.org/standards/?search=j1939DA.
- A way to convert `.xls` to `.xlsx` if your copy of the J1939DA is in `.xls` format.

## Usage
```
python -m akrocansim
```

Upon initial run, a folder named `akrocansim` is created in your home folder hosting a starting configuration file.

Follow the instructions on the application and in the configuration file for next steps.

Upon successful parsing of the J1939DA, a series of json files are created in the `J1939` sub-folder inside the main configuration folder.
These can be inspected to evaluate parsing correctness.

The J1939DA PGN and SPN definition format is very irregular and parsing errors still exist.
You can raise a GitHub issue or a pull request if you think that an SPN has not been parsed correctly.

## Issues
[GitHub issue tracker](https://github.com/cfsok/akrocansim/issues)

## Discussions
[GitHub discussions](https://github.com/cfsok/akrocansim/discussions)
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "akrocansim",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "J1939,CAN bus",
    "author": null,
    "author_email": "Socrates Vlassis <socrates.vlassis@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/27/ca/ef78109633bfefe592a9a7291c9d095ee9861bf3eaf33fd631d6f6d1769e/akrocansim-0.6.1.tar.gz",
    "platform": null,
    "description": "# akrocansim\nA CAN bus J1939 controller simulator.\n\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akrocansim)](https://github.com/cfsok/akrocansim)\n[![PyPI - Version](https://img.shields.io/pypi/v/akrocansim?color=blue)](https://pypi.org/project/akrocansim/)\n![PyPI - License](https://img.shields.io/pypi/l/akrocansim)\n\n\n## Built with\n- [python-can](https://github.com/hardbyte/python-can)\n- [DearPyGUI](https://github.com/hoffstadt/DearPyGui)\n- [openpyxl](https://openpyxl.readthedocs.io/)\n\n## Features\n- Integrates with all hardware CAN interfaces supported by python-can.\n- Transmits configured J1939 PGNs to the CAN bus with the following methods:\n  - continuous tx of all PGNs\n  - all PGNs transmitted once on button press\n  - per PGN transmission, either continuous or on button press\n- GUI for setting SPN values:\n  - sliders for changing continuous values\n  - label selection for discrete values\n  - direct entry of raw decimal values\n  - direct entry of decoded decimal values\n\n![Akrocansim demo screenshot](https://raw.githubusercontent.com/cfsok/akrocansim/main/docs/images/demo_2_Akrocansim.png)\n\n![PCAN-View demo screenshot](https://raw.githubusercontent.com/cfsok/akrocansim/main/docs/images/demo_1_PCAN-View.png)\n\n## Installation\nPython 3.11 (64-bit) or higher is required.\n\n```\npip install akrocansim\n```\n\n## Prerequisites\n- A hardware CAN interface supported by python-can,\nsee https://python-can.readthedocs.io/en/v4.3.1/interfaces.html.\n- A version of J1939 Digital Annex (J1939DA) from SAE International, see https://www.sae.org/standards/?search=j1939DA.\n- A way to convert `.xls` to `.xlsx` if your copy of the J1939DA is in `.xls` format.\n\n## Usage\n```\npython -m akrocansim\n```\n\nUpon initial run, a folder named `akrocansim` is created in your home folder hosting a starting configuration file.\n\nFollow the instructions on the application and in the configuration file for next steps.\n\nUpon successful parsing of the J1939DA, a series of json files are created in the `J1939` sub-folder inside the main configuration folder.\nThese can be inspected to evaluate parsing correctness.\n\nThe J1939DA PGN and SPN definition format is very irregular and parsing errors still exist.\nYou can raise a GitHub issue or a pull request if you think that an SPN has not been parsed correctly.\n\n## Issues\n[GitHub issue tracker](https://github.com/cfsok/akrocansim/issues)\n\n## Discussions\n[GitHub discussions](https://github.com/cfsok/akrocansim/discussions)",
    "bugtrack_url": null,
    "license": null,
    "summary": "akrocansim is a CAN bus J1939 controller simulator",
    "version": "0.6.1",
    "project_urls": {
        "Home": "https://github.com/cfsok/akrocansim"
    },
    "split_keywords": [
        "j1939",
        "can bus"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c75f3cea62831ef5cca9980c3c3292906314d692c6d2211a1e1541271ffd863a",
                "md5": "b6ed5b7f1058121080993714b3dc531e",
                "sha256": "e728162fb61538ee53e4ca380509a1329fc3049642780f136ec2365cb5f0f0e0"
            },
            "downloads": -1,
            "filename": "akrocansim-0.6.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b6ed5b7f1058121080993714b3dc531e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 85015,
            "upload_time": "2024-02-04T13:18:31",
            "upload_time_iso_8601": "2024-02-04T13:18:31.347908Z",
            "url": "https://files.pythonhosted.org/packages/c7/5f/3cea62831ef5cca9980c3c3292906314d692c6d2211a1e1541271ffd863a/akrocansim-0.6.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "27caef78109633bfefe592a9a7291c9d095ee9861bf3eaf33fd631d6f6d1769e",
                "md5": "b29f94a0667ad26e1d9a69c02617d608",
                "sha256": "1aa127abe4a22b4c4d0414ee955489e4a4a929c314179189e0727b39d20bb1a7"
            },
            "downloads": -1,
            "filename": "akrocansim-0.6.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b29f94a0667ad26e1d9a69c02617d608",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 171656,
            "upload_time": "2024-02-04T13:18:34",
            "upload_time_iso_8601": "2024-02-04T13:18:34.934339Z",
            "url": "https://files.pythonhosted.org/packages/27/ca/ef78109633bfefe592a9a7291c9d095ee9861bf3eaf33fd631d6f6d1769e/akrocansim-0.6.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-04 13:18:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cfsok",
    "github_project": "akrocansim",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "akrocansim"
}
        
Elapsed time: 0.20872s