LEADS: Lightweight Embedded Assisted Driving System
LEADS is a system designed for VeC.
LEADS only supports two drive-wheel configurations: single rear wheel (SRW) mode and dual rear wheel (DRW) mode.
Python is generally not the best choice for writing embedded systems. We made this decision for the following reasons.
- Data analysis
- Short development cycle
- Official support for Raspberry Pi
- Low difficulty in getting started for team members
This project aims to implement the following functions:
- A basic instrumentation system
- A basic communication system
- A basic control system
- A data recording system with the following components
- A speed recording system
- A G force recording system
- A GPS recording system
- A battery voltage recording system
- A control system with the following components
- DTCS (Dynamic Traction Control System)
- ABS (Anti-lock Braking System)
- EBI (Emergency Braking Intervention)
- ATBS (Automatic Trail Braking System)
Installation
Note that LEADS requires Python >= 3.11.
pip install pysimplegui keyboard pyserial leads
numpy will be automatically installed with leads.
pysimplegui, keyboard, and pyserial are optional.
If you need only the skeleton, run the following.
pip install leads
Quickstart
Main
python -m leads_vec
Optional Arguments
Configuration File
python -m leads_vec -c path/to/the/config/file
If not specified, all configurations will be default values.
To learn about the configuration file, read Configurations.
Configurations
| Type | Usage | Used By | Default | |
|---|---|---|---|---|
srw_mode |
bool |
True: single rear wheel; False: dual rear wheel |
Main, Remote | True |
analysis_rate |
float |
The interval between two analysis frames in seconds | Main | 0.01 |
update_rate |
float |
The interval between two render frames in seconds | Main | 0.25 |
comm_addr |
str |
The communication server address | Main | "127.0.0.1" |
comm_port |
int |
The communication system port | Main, Remote | 16900 |
data_dir |
str |
The directory for the data recording system | Remote | "./data" |
Periodic Report
See reports.
Collaborations
Community
Issues
Our team management completely relies on GitHub. Tasks are published and assigned as issues. You will be notified if you are assigned to certain tasks. However, you may also choose to join other discussions for which you are not responsible.
There are a few labels that classify the issues.
bugreports a bugcode reviewdiscusses a code review or commentdocumentationsuggests a documentation enhancementduplicatemarks that a similar issue has been raisedenhancementproposes a new feature or requesthelp wantedmeans that extra attention is needed to this issueinvalidmarks that the issue is in valid formatquestionrequests further informationreportstarts a periodic report discussiontodocreates a new taskwontfixmarks that the issue is ignored
Label your issue with at least one of the labels above before you submit.
Projects
You can have a look on the whole schedule of each project in timeline using the projects feature.
Code Contributions
Please fork the project into your own repository. Before your pull request, make sure that you have tested all possible impacts on other parts of the project. If no certainty is assured, please reach out to our core team members to have official supports.
Code Specifications
All code must be type-annotated and follow the Code Style Guide.
2 maintainers
Metadata
2 maintainers
Release files for leads 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| leads-0.1.5.tar.gz | 21.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| leads-0.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.5 kB
Release files / leads-0.1.5.tar.gz
| Download URL | leads-0.1.5.tar.gz |
|---|---|
| Size | 21.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d0898aa8bb1e6e7a2bcf00f476f0dbed8d5957ecf833c510617280151960c59
|
|
BLAKE2b-256 checksum How to use checksums |
e75a491b72ea166c0720beb8cdf0eed5561507acc0c258efec0f8eb38ab3394d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
Release files / leads-0.1.5-py3-none-any.whl
| Download URL | leads-0.1.5-py3-none-any.whl |
|---|---|
| Size | 27.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
01dc8c3ca0d779c6790d14fd5d7759fe14b13f2cba851ca9f55976f7333641cf
|
|
BLAKE2b-256 checksum How to use checksums |
16810d5c9c871d575012d33650cac79cd3564270e14445ed054cfc425c4862e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
