{"id":21861520,"url":"https://github.com/raleighlittles/canedge_obd_tool_scripts","last_synced_at":"2025-06-30T09:34:45.525Z","repository":{"id":179628095,"uuid":"657940992","full_name":"raleighlittles/CanEdge_OBD_tool_scripts","owner":"raleighlittles","description":"Small Python scripts for working with the CanEdge OBD logger","archived":false,"fork":false,"pushed_at":"2024-12-03T06:21:47.000Z","size":36414,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T20:18:58.336Z","etag":null,"topics":["canedge","dbc","mf4","obd2","obd2-pid","uds"],"latest_commit_sha":null,"homepage":"https://www.csselectronics.com/products/can-bus-data-logger-wifi-canedge2","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raleighlittles.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"supported_pids_list/2017_Nissan-Frontier-PIDs.txt","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["raleighlittles"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["paypal.me/raleighlittles"]}},"created_at":"2023-06-24T09:21:29.000Z","updated_at":"2024-12-03T06:21:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"29278da3-a1a9-4c20-a1ff-986af8b06fb5","html_url":"https://github.com/raleighlittles/CanEdge_OBD_tool_scripts","commit_stats":null,"previous_names":["raleighlittles/canedge_obd_tool_scripts"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/raleighlittles/CanEdge_OBD_tool_scripts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FCanEdge_OBD_tool_scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FCanEdge_OBD_tool_scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FCanEdge_OBD_tool_scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FCanEdge_OBD_tool_scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raleighlittles","download_url":"https://codeload.github.com/raleighlittles/CanEdge_OBD_tool_scripts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FCanEdge_OBD_tool_scripts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262748200,"owners_count":23358135,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["canedge","dbc","mf4","obd2","obd2-pid","uds"],"created_at":"2024-11-28T03:11:52.935Z","updated_at":"2025-06-30T09:34:45.503Z","avatar_url":"https://github.com/raleighlittles.png","language":"Python","funding_links":["https://github.com/sponsors/raleighlittles","paypal.me/raleighlittles"],"categories":[],"sub_categories":[],"readme":"# Background / Context\n\nThis repository contains additional tools for working with the [CANEdge 2](https://www.csselectronics.com/products/can-bus-data-logger-wifi-canedge2) data logger.\n\n![device photo](./docs/canedge2-wifi-can-bus-data-logger-v3.jpg)\n\nThis device connects to your car's [OBD port](https://en.wikipedia.org/wiki/On-board_diagnostics) to log data.\n\n# Repository / Code\n\nThis repository consists of 2 tools:\n\n* A Python script for determining which PIDs your vehicle supports (`determine_supported_pids.py`)\n* A Python script for generating the appropriate config file, based on the supported PIDs (`canedge_config_generator.py`) -- last tested with version 01.07 [July 2023]\n\nBoth tools should work for your vehicle, as long as your car is newer than 2008. I used these scripts for my 2018 Nissan Versa.\n\n# Step 1: Determining supported PIDs\n\n\u003e Main article: https://en.wikipedia.org/wiki/OBD-II_PIDs\n\n\u003e Main section: https://en.wikipedia.org/wiki/OBD-II_PIDs#Service_01_PID_00_-_Show_PIDs_supported\n\n\nTo determine what OBD2 PIDs your vehicle supports, you'll first have to configure the CanEdge to send the PIDs with ID: 0x00, 0x20, 0x40, 0x60, 0x80, 0xA0, 0xC0. These PIDs return a 4-byte (32-bit) response bitmask that tells you which of next 32 PIDs are enabled.\n\nYou can copy the JSON from `transmit_block_for_decoding_pids.md` into your config file. Then, with the CANEdge connected, start your vehicle, and let it run for a few minutes.\n\nTurn the car off, and remove the SD card from the unit.\n\nNext, identify the MF4 file that was saved from this session.\n\nRun the Python script:\n\n```bash\n$ python3 determine_supported_pids.py -i \u003cPATH-TO-CANEDGE-MF4-FILE\u003e\n```\n\nYou should see some output that starts with this:\n\n```\nSupported pids\n--------------\nPID num (hex) | PID num (int) | PID Name\n\n```\n\nThis prints the list of supported Service 01 PID IDs. See: https://en.wikipedia.org/wiki/OBD-II_PIDs#Service_01_-_Show_current_data\n\nThe folder: `supported_pids_list` contains several text files, with the output of running this command for various vehicles.\n\n# Step 2: Generating config file\n\nNow that you have the list of supported PIDs, the next step is to tell your CanEdge to only send commands on those PIDs.\n\nThis step involves some manual processing on your end. I recommend making a spreadsheet with columns of: PID number, Message Name, Period, Delay, Response.\n\nI have an example of the spreadsheet in the `docs` folder.\n\nOnce you're finished with the spreadsheet, replace the contents of the txt files in the `config_generator` directory with your information.\n\nThen, run the Python script:\n\n```bash\n$ python3 canedge_config_generator.py\n```\n\nThis will output text that you can copy directly into your CanEdge config file, based on the contents of your text files.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Fcanedge_obd_tool_scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraleighlittles%2Fcanedge_obd_tool_scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Fcanedge_obd_tool_scripts/lists"}