From 852130fa063dad53efef13b41540af7bbe70c265 Mon Sep 17 00:00:00 2001 From: Adam Varga Date: Tue, 28 Mar 2023 23:44:45 +0200 Subject: [PATCH] readme extended with HW and FW related points --- README.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 2d3e4eb..d2ffe45 100644 --- a/README.md +++ b/README.md @@ -7,9 +7,11 @@ https://docs.google.com/spreadsheets/d/1eBKiTwEE6aPnfw2EfSHItLeMz00fJq0Y0L99Ym7f # Content - 01_canSniffer_Arduino: This code runs on your arduino sniffer device and creates an interface between the car and the GUI. -- 02_canSniffer_GUI: Powerful and easy-to-use graphical sniffer application used for reverse engineering CAN packets. +- 02_canSniffer_GUI: Powerful and easy-to-use graphical sniffer application used for reverse engineering CAN packets. Written in Python. +- 03_canSniffer_HW: Hardware projects for the custom OBD2 module. Made in Altium Designer. +- 04_canSniffer_FW: Embedded code running on the custom OBD2 module. # Description -##### 01_canSniffer_Arduino +### 01_canSniffer_Arduino This code creates the interface between the car and the canSniffer_GUI application. If the RANDOM_CAN define is set to 1, this code is generating random CAN packets in order to test the higher level code. The received packets will be echoed back. If the RANDOM_CAN define is set to 0, the CAN_SPEED define has to match the speed of the desired CAN channel in order to receive and transfer from and to the CAN bus. Required arduino packages: - CAN by Sandeep Mistry (https:github.com/sandeepmistry/arduino-CAN) @@ -18,12 +20,19 @@ Required modifications: - MCP2515.h: 16e6 clock frequency reduced to 8e6 (depending on MCP2515 clock) - MCP2515.cpp: extend CNF_MAPPER with your desired CAN speeds -##### 02_canSniffer_GUI -Python 3 is required for this project, 3.8 is preferred. This project contains my decoded packets in save/decodedPackets.csv. The required python packages can be installed with: +### 02_canSniffer_GUI +Python 3 is required for this project, 3.8 is preferred. The GUI is based on pyQt. This project contains my decoded packets in save/decodedPackets.csv. The required python packages can be installed with: ```sh $ pip install -r requirements.txt ``` + +### 03_canSniffer_HW +Altium Designer projects for the hardware projects. Currently version 2. The module consists of 2 PCBs (board1 & board2). The libraries of the used components can be found under the common folder. Schematics can also be found as PDF files. + +### 04_canSniffer_FW +(BETA) Only board1 beta firmware is uploaded yet. It is a STM32CubeIDE project for the STM32F413. To be uploaded: nRF project for board2. + # To be uploaded -- Hardware files for the custom OBD2 module. -- Firmware projects for the custom OBD2 module. -- Source code for the mobile application. +- Final version of the firmware. +- (at some point) Source code for the mobile application that is compatible with the v2 hardware. +- (potentially) New versions of the hardware module.