CAN Bus Attack

September 3, 2025 · View on GitHub

This repository contains a custom Flipper Zero application for performing basic security testing on CAN Bus networks.
It was developed as part of a university cybersecurity research project and is intended for educational and ethical use only.

CAN-Bus Attack App (Flipper Zero)

🇪🇸 Español

Flipper Zero CAN-Bus Attack App

Manual de Instalación

Este manual describe dos procedimientos distintos: por un lado, la instalación directa de la aplicación en el dispositivo Flipper Zero para usuarios que solo deseen ejecutarla; por otro, la configuración del entorno de desarrollo para aquellos que deseen modificar el código fuente o extender sus funcionalidades.

Instalación directa de la aplicación

Para utilizar la herramienta desarrollada no es necesario compilar el proyecto desde cero. El archivo ejecutable de la aplicación se encuentra disponible en formato .fap, listo para ser instalado en el Flipper Zero.

Pasos para la instalación

Descargar el archivo .fap desde el repositorio del proyecto (ver sección Repositorio del proyecto).
Conectar el Flipper Zero por USB y abrir la herramienta oficial qFlipper.
Copiar el archivo descargado a la carpeta:
```
/SD card/apps/
```
Desconectar el dispositivo y acceder a la aplicación desde el menú principal.

Compilación y personalización del código

Los usuarios avanzados pueden modificar el comportamiento de la aplicación o extender su funcionalidad editando directamente el código fuente. Para ello es necesario clonar el firmware y configurar el entorno de desarrollo de Flipper Zero.

Requisitos previos

Entorno Linux con Python 3 y herramientas de desarrollo instaladas.
Proyecto descargado (ver sección Repositorio del proyecto).
Conexión a Internet para descargar dependencias.

Pasos para compilar

git clone https://github.com/DarkFlippers/unleashed-firmware
cd unleashed-firmware/applications_user

# Copiar aquí el código fuente/carpeta de la app

# Para compilar
cd .. # Volver a la carpeta unleashed-firmware
./fbt fap_canbus_attack_app

Una vez compilado, el archivo .fap se encuentra en la ruta:

/unleashed-firmware/build/f7-firmware-D/.extapps/canbus_attack_app.fap

Este archivo puede instalarse siguiendo los pasos descritos anteriormente.

Flipper Zero con firmware Unleashed v0.81 (unlshd-081) o compatible.
Módulo MCP2515 conectado al puerto GPIO.
Archivo .fap en apps/.
Red CAN activa (ICSim o física).

Acceso a la aplicación

Enciende el Flipper Zero.
Menú Aplicaciones → CAN Bus Attacks.
Se mostrará el menú principal.

Ataques disponibles

Sniffing

Captura de tramas CAN.
Visualización de IDs y valores.

Uso exclusivo educativo.
No en vehículos reales.

Solución de problemas

La app no aparece

El archivo `.fap` no está en la carpeta correcta.

Solución: Asegúrate de copiarla en apps/.

No se detecta tráfico

El módulo MCP2515 no está conectado o la red está inactiva.

Solución: Verifica las conexiones físicas y la velocidad del bus.

El ataque no tiene efecto

La red no responde al ID utilizado.

Solución: Prueba con otra trama o revisa el entorno simulado.

Repositorio del proyecto

https://github.com/jorgepnaranjo25/CAN-Bus-Attack

Incluye:

Código fuente
Archivos de configuración (CMakeLists.txt, application.fam)
Instrucciones de compilación e instalación
Capturas de pantalla y docs

🇬🇧 English

Flipper Zero CAN-Bus Attack App

Download the .fap from this repo.
Connect Flipper Zero via USB and open qFlipper.
Copy the file to:
```
/SD card/apps/
```
Disconnect and run the app from the main menu.

Build from source

Requirements

Linux environment with Python 3 and dev tools.
Project downloaded.
Internet connection.

Steps

git clone https://github.com/DarkFlippers/unleashed-firmware
cd unleashed-firmware/applications_user
cp -r /path/CAN-Bus-Attack ./canbus_attack_app
cd ..
./fbt fap_canbus_attack_app

Compiled file will be at:

/unleashed-firmware/build/f7-firmware-D/.extapps/canbus_attack_app.fap

Flipper Zero with Unleashed v0.81 (unlshd-081)
MCP2515 connected via GPIO
.fap in /apps/
Active CAN network (ICSim or physical)

Access

Power on device.
Applications → CAN Bus Attacks.
Main menu appears.

For educational purposes only.
Never on real vehicles.

Troubleshooting

App not showing

The `.fap` file is not in the correct folder.

Solution: Make sure to copy it into apps/.

No traffic detected

The MCP2515 module is not connected or the bus is inactive.

Solution: Check physical connections and bus speed.

Attack has no effect

The network is not responding to the used ID.

Solution: Try with another frame or review the simulated network.

Project Repository

https://github.com/jorgepnaranjo25/CAN-Bus-Attack

Includes:

Source code
Config files (CMakeLists.txt, application.fam)
Build/install instructions
Screenshots & docs