Metadata-Version: 2.4
Name: cortex-crash
Version: 1.3.0
Summary: All-in-one ARM Cortex-M HardFault triage suite with KB & LLM synthesis
Author-email: Trust & Thread <contact@trustandthread.com>
Project-URL: Homepage, https://www.trustandthread.com
Project-URL: Bug Tracker, https://github.com/GaneshMba4066/cortex-crash/issues
Project-URL: Documentation, https://www.trustandthread.com/firmware-checklist/
Project-URL: Commercial Toolkit, https://medidaflare.gumroad.com/l/nnchzo
Keywords: arm,cortex-m,stm32,hardfault,firmware,debugging,unwind,cfsr
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

﻿# cortex-crash

All-in-one ARM Cortex-M HardFault triage suite: decode CFSR status registers, unwind hardware-stacked frames with `addr2line`, and generate drop-in C/ASM fault capture stubs.

## Installation

pip install cortex-crash

## Usage

# Print drop-in naked C/ASM HardFault handler
cortex-crash init-c

# Decode fault registers
cortex-crash cfsr 0x00010200 0x20001FF7

# Unwind 8-word stack frame and resolve line from ELF
cortex-crash unwind 0x0 0x1 0x20000000 0x40021000 0x0 0x08001255 0x08001290 0x21000000 app.elf

# Unified triage
cortex-crash parse --cfsr 0x00010200 --bfar 0x20001FF7 --frame 0x0 0x1 0x20000000 0x40021000 0x0 0x08001255 0x08001290 0x21000000

## License

MIT — Trust & Thread
