{"id":21519820,"url":"https://github.com/electroniccats/faultycat","last_synced_at":"2025-04-09T14:06:25.179Z","repository":{"id":177392681,"uuid":"593328026","full_name":"ElectronicCats/faultycat","owner":"ElectronicCats","description":"Faulty Cat is a low-cost Electromagnetic Fault Injection (EMFI) tool, designed specifically for self-study and hobbiest research.","archived":false,"fork":false,"pushed_at":"2025-03-05T23:32:21.000Z","size":11226,"stargazers_count":68,"open_issues_count":0,"forks_count":7,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-02T10:39:21.625Z","etag":null,"topics":["electromagnetic-fault-injection","emfi","hardware","rp2040","security","security-tools"],"latest_commit_sha":null,"homepage":"","language":"C","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/ElectronicCats.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-25T18:53:08.000Z","updated_at":"2025-04-02T00:28:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"089fe0ca-837c-494f-aff6-32bcc79d1fbb","html_url":"https://github.com/ElectronicCats/faultycat","commit_stats":{"total_commits":48,"total_committers":9,"mean_commits":5.333333333333333,"dds":0.5416666666666667,"last_synced_commit":"e995db13920b763769efbcc673a18ea9475e5d04"},"previous_names":["electroniccats/faultycat"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElectronicCats%2Ffaultycat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElectronicCats%2Ffaultycat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElectronicCats%2Ffaultycat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElectronicCats%2Ffaultycat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ElectronicCats","download_url":"https://codeload.github.com/ElectronicCats/faultycat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248054228,"owners_count":21039952,"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":["electromagnetic-fault-injection","emfi","hardware","rp2040","security","security-tools"],"created_at":"2024-11-24T01:00:17.686Z","updated_at":"2025-04-09T14:06:25.150Z","avatar_url":"https://github.com/ElectronicCats.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Faulty Cat\n\nFaulty Cat is a low-cost Electromagnetic Fault Injection (EMFI) tool, designed specifically for self-study and hobbiest research.\n\n\u003ca href=\"https://github.com/ElectronicCats/FaultyCat/wiki\"\u003e\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/ElectronicCats/FaultyCat/assets/40640735/bd1966a8-1dd1-4355-b788-5885f66f081d\" height=\"400\" /\u003e\n    \u003c/p\u003e\n\u003c/a\u003e\n\n\u003cp align=center\u003e\n\u003ca href=\"https://electroniccats.com/store/faulty-cat/\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f6414773-c8fa-4c99-9c8b-05a1dc297fb3\" width=\"200\" height=\"104\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/ElectronicCats/faultycat/wiki\"\u003e\n  \u003cimg src=\"https://github.com/ElectronicCats/flipper-shields/assets/44976441/6aa7f319-3256-442e-a00d-33c8126833ec\" width=\"200\" height=\"104\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=center\u003e\n  Also available at distributors:\n\u003c/p\u003e\n\u003cp align=center\u003e\n  \u003ca href=\"https://labs.ksec.co.uk/product-category/electronic-cat/\"\u003e\n    \u003cimg src=\"https://cdn.ksec.co.uk/ksec-solutions/ksec-W-BW-MV-small-clipped.png\" width=\"200\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nFaulty Cat is a high-end Electromagnetic Fault Injection (EMFI) tool a remix of the project [ChipSHOUTER PicoEMP](https://github.com/newaetech/chipshouter-picoemp) design optimization focused in rough order on (1) safe operation, (2) high performance, (3) usability, and finally (4) cost. This results in a tool that covers many use-cases, but may be overkill (and expensive) for many. \n\nWe have created this project in KiCad and looking for alternatives to some components, we have left aside the Raspberry Pico board to use the RP2040 directly in the design. Tested in our laboratory before going on sale, even so, it is a product that must be handled with care, read the instructions for use.\n\nPlease **only** use Faulty Cat when you have purchased it from us and control it yourself, with full knowledge of the operation and risks. It is *not* designed for use in professional or educational environments, where tools are expected to meet safety certifications.\n\n\n**IMPORTANT**: The plastic shield is critical for safe operation. While the output itself is isolated from the input connections, you will still **easily shock yourself** on the exposed high-voltage capacitor and circuitry. **NEVER** operate the device without the shield.\n\nAs an open-source project and as a remix of the project [ChipSHOUTER PicoEMP](https://github.com/newaetech/chipshouter-picoemp), it also collects inputs from various community members, and welcomes your contributions! It also has various remixes of it, including:\n\n## Thanks / Contributors\n\nFaulty Cat based in PicoEMP is a community-focused project, with major contributions from:\n* Colin O'Flynn (original HW design, simple Python demo)\n* [stacksmashing](https://twitter.com/ghidraninja) (C firmware for full PIO feature set)\n* [Lennert Wouters](https://twitter.com/LennertWo) (C improvements, first real demo)\n* [@nilswiersma](https://github.com/nilswiersma) (Triggering/C improvements)\n\n\n### Programming the Faulty Cat\n\nFollow the [first steps section](https://github.com/ElectronicCats/FaultyCat/wiki/3.-First-Steps) of the Faulty Cat wiki in order to program it.  You can run other tasks on the microcontroller\nas well.\n\n\n### Useful References\n\nIf you don't know where to start with Electromagnetic Fault Injection (EMFI), you may find a couple of chapters of the [Hardware Hacking Handbook](https://nostarch.com/hardwarehacking) useful.\n\nYou can see a demo of PicoEMP being used on a real attack in this [TI CC SimpleLink attack demo](https://github.com/KULeuven-COSIC/SimpleLink-FI/blob/main/notebooks/5_ChipSHOUTER-PicoEMP.ipynb).\n\n**WARNING**: The high voltage will be applied across the SMA connector. If an injection tip (coil) is present, it will absorb most of the power. If you leave the SMA connector open, you will present a high voltage pulse across this SMA and could shock yourself. Do NOT touch the output SMA tip as a general \"best practice\", and treat the output as if it has a high voltage present.\n\n## How to contribute \u003cimg src=\"https://electroniccats.com/wp-content/uploads/2018/01/fav.png\" height=\"35\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/gist/ManulMax/2d20af60d709805c55fd784ca7cba4b9/raw/bcfeac7604f674ace63623106eb8bb8471d844a6/github.gif\" height=\"30\"\u003e\n Contributions are welcome! \n\nPlease read the document  [**Contribution Manual**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-contribution-manual.md)  which will show you how to contribute your changes to the project.\n\n✨ Thanks to all our [contributors](https://github.com/ElectronicCats/faultycat/graphs/contributors)! ✨\n\nSee [**_Electronic Cats CLA_**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-cla.md) for more information.\n\nSee the  [**community code of conduct**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-community-code-of-conduct.md) for a vision of the community we want to build and what we expect from it.\n\n## License\n\nThis project FaultyCat is adapted from [ChipSHOUTER PicoEMP](https://github.com/newaetech/chipshouter-picoemp) by [Colin O'Flynn](https://github.com/colinoflynn) is licensed under CC BY-SA 3.0, \"FaultyCat\" contains modifications such as: porting the project to Kicad, modifying BOM and dimensions is licensed under CC BY-SA 3.0 by ElectronicCats.\n\nElectronic Cats invests time and resources in providing this open-source design. Please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectroniccats%2Ffaultycat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectroniccats%2Ffaultycat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectroniccats%2Ffaultycat/lists"}