pcileechfwgenerator 2.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of pcileechfwgenerator might be problematic. Click here for more details.

@@ -0,0 +1,557 @@
1
+ Metadata-Version: 2.4
2
+ Name: pcileechfwgenerator
3
+ Version: 2.0.0
4
+ Summary: Generate spoofed PCIe DMA firmware from real donor hardware
5
+ Author-email: Ramsey McGrath <ramsey@voltcyclone.info>
6
+ Maintainer-email: Ramsey McGrath <ramsey@voltcyclone.info>
7
+ License-Expression: MIT
8
+ Project-URL: Homepage, https://github.com/ramseymcgrath/PCILeechFWGenerator
9
+ Project-URL: Repository, https://github.com/ramseymcgrath/PCILeechFWGenerator
10
+ Project-URL: Documentation, https://github.com/ramseymcgrath/PCILeechFWGenerator/blob/main/README.md
11
+ Project-URL: Bug Tracker, https://github.com/ramseymcgrath/PCILeechFWGenerator/issues
12
+ Project-URL: Changelog, https://github.com/ramseymcgrath/PCILeechFWGenerator/blob/main/CHANGELOG.md
13
+ Keywords: pcie,dma,firmware,fpga,hardware,security,penetration-testing,red-team,xilinx,vivado
14
+ Classifier: Development Status :: 4 - Beta
15
+ Classifier: Environment :: Console
16
+ Classifier: Environment :: Console :: Curses
17
+ Classifier: Intended Audience :: Developers
18
+ Classifier: Intended Audience :: Information Technology
19
+ Classifier: Intended Audience :: System Administrators
20
+ Classifier: Operating System :: POSIX :: Linux
21
+ Classifier: Programming Language :: Python :: 3
22
+ Classifier: Programming Language :: Python :: 3.9
23
+ Classifier: Programming Language :: Python :: 3.10
24
+ Classifier: Programming Language :: Python :: 3.11
25
+ Classifier: Programming Language :: Python :: 3.12
26
+ Classifier: Topic :: Security
27
+ Classifier: Topic :: System :: Hardware
28
+ Classifier: Topic :: Software Development :: Embedded Systems
29
+ Classifier: Topic :: System :: Systems Administration
30
+ Requires-Python: >=3.9
31
+ Description-Content-Type: text/markdown
32
+ License-File: LICENSE
33
+ Requires-Dist: psutil>=5.9.0
34
+ Requires-Dist: pydantic>=2.0.0
35
+ Provides-Extra: tui
36
+ Requires-Dist: textual>=0.45.0; extra == "tui"
37
+ Requires-Dist: rich>=13.0.0; extra == "tui"
38
+ Requires-Dist: watchdog>=3.0.0; extra == "tui"
39
+ Provides-Extra: dev
40
+ Requires-Dist: pytest>=7.0.0; extra == "dev"
41
+ Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
42
+ Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
43
+ Requires-Dist: black>=23.0.0; extra == "dev"
44
+ Requires-Dist: isort>=5.12.0; extra == "dev"
45
+ Requires-Dist: flake8>=6.0.0; extra == "dev"
46
+ Requires-Dist: mypy>=1.0.0; extra == "dev"
47
+ Requires-Dist: pre-commit>=3.0.0; extra == "dev"
48
+ Requires-Dist: build>=0.10.0; extra == "dev"
49
+ Requires-Dist: twine>=4.0.0; extra == "dev"
50
+ Provides-Extra: test
51
+ Requires-Dist: pytest>=7.0.0; extra == "test"
52
+ Requires-Dist: pytest-cov>=4.0.0; extra == "test"
53
+ Requires-Dist: pytest-mock>=3.10.0; extra == "test"
54
+ Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
55
+ Dynamic: license-file
56
+
57
+ # PCILeech Firmware Generator
58
+
59
+ [![PyPI version](https://badge.fury.io/py/pcileechfwgenerator.svg)](https://badge.fury.io/py/pcileechfwgenerator)
60
+ [![CI](https://github.com/ramseymcgrath/PCILeechFWGenerator/workflows/CI/badge.svg)](https://github.com/ramseymcgrath/PCILeechFWGenerator/actions)
61
+ [![codecov](https://codecov.io/gh/ramseymcgrath/PCILeechFWGenerator/branch/main/graph/badge.svg)](https://codecov.io/gh/ramseymcgrath/PCILeechFWGenerator)
62
+ ![](https://dcbadge.limes.pink/api/shield/429866199833247744)
63
+
64
+ Generate spoofed PCIe DMA firmware from real donor hardware with a single command. The workflow rips the donor's configuration space, builds a personalized FPGA bit‑stream in an isolated container, and (optionally) flashes your DMA card over USB‑JTAG.
65
+
66
+ ---
67
+
68
+ ## 📑 Table of Contents
69
+
70
+ - [✨ Features](#-features)
71
+ - [🚀 Quick Start](#-quick-start)
72
+ - [Installation](#installation)
73
+ - [Usage](#usage)
74
+ - [📋 Requirements](#-requirements)
75
+ - [Software](#software)
76
+ - [Hardware](#hardware)
77
+ - [🛠️ Installation & Setup](#️-installation--setup)
78
+ - [🎮 Usage](#-usage-1)
79
+ - [Interactive TUI Mode](#interactive-tui-mode-recommended)
80
+ - [Command Line Mode](#command-line-mode)
81
+ - [Legacy Mode](#legacy-mode-source-installation)
82
+ - [🔌 Flashing the DMA Board](#-flashing-the-dma-board)
83
+ - [🚀 Advanced Features](#-advanced-features)
84
+ - [Manufacturing Variance Simulation](#manufacturing-variance-simulation)
85
+ - [Advanced SystemVerilog Generation](#advanced-systemverilog-generation)
86
+ - [Behavioral Profiling](#behavioral-profiling)
87
+ - [Command-Line Options](#command-line-options)
88
+ - [🧹 Cleanup & Safety](#-cleanup--safety)
89
+ - [⚠️ Disclaimer](#️-disclaimer)
90
+ - [📦 Development & Contributing](#-development--contributing)
91
+ - [Building from Source](#building-from-source)
92
+ - [Contributing](#contributing)
93
+ - [Release Process](#release-process)
94
+ - [📚 Documentation](#-documentation)
95
+ - [🔧 Troubleshooting](#-troubleshooting)
96
+ - [🏆 Acknowledgments](#-acknowledgments)
97
+ - [📄 License](#-license)
98
+ - [⚠️ Legal Notice](#️-legal-notice)
99
+
100
+ ---
101
+
102
+ ## ✨ Features
103
+
104
+ - **🎯 Donor Hardware Analysis**: Extract real PCIe device configurations and register maps
105
+ - **📊 Behavioral Profiling**: Capture dynamic device behavior patterns for enhanced realism
106
+ - **🔧 Manufacturing Variance Simulation**: Add realistic timing jitter and parameter variations
107
+ - **⚡ Advanced SystemVerilog Generation**: Comprehensive PCIe device controller with modular architecture
108
+ - **🐳 Automated Build Pipeline**: Containerized synthesis and bit-stream generation
109
+ - **🔌 USB-JTAG Flashing**: Direct firmware deployment to DMA boards
110
+ - **🖥️ Interactive TUI**: Modern text-based interface with real-time monitoring and guided workflows
111
+ - **📦 Professional Packaging**: Easy installation via pip with proper dependency management
112
+
113
+ ## 🚀 Quick Start
114
+
115
+ ### Installation
116
+
117
+ ```bash
118
+ # Basic installation
119
+ pip install pcileechfwgenerator
120
+
121
+ # With TUI support (recommended)
122
+ pip install pcileechfwgenerator[tui]
123
+
124
+ # Development installation
125
+ pip install pcileechfwgenerator[dev]
126
+ ```
127
+
128
+ ### Usage
129
+
130
+ ```bash
131
+ # Interactive TUI interface (recommended)
132
+ pcileech-tui
133
+
134
+ # Command line interface
135
+ pcileech-generate
136
+
137
+ # Direct build command
138
+ pcileech-build --bdf 0000:03:00.0 --board 75t
139
+ ```
140
+
141
+ ## 📋 Requirements
142
+
143
+ ### Software
144
+
145
+ This is primarily tested in Linux, with some fiddling you could probably get it to work on Windows too.
146
+
147
+ | Tool | Why you need it | Install |
148
+ |------|----------------|---------|
149
+ | Vivado Studio | Synthesis & bit‑stream generation | Download from Xilinx (any 2022.2+ release) |
150
+ | Podman | Rootless container runtime for the build sandbox | See installation instructions below |
151
+ | Python ≥ 3.9 | Host‑side orchestrator ([`generate.py`](generate.py)) | Distro package (python3) |
152
+ | λConcept usbloader | USB flashing utility for Screamer‑class boards | See installation instructions below |
153
+ | pciutils, usbutils | lspci / lsusb helpers | Available in most Linux distributions |
154
+
155
+ > **⚠️ Security Notice**
156
+ > Never build firmware on the same operating system you plan to run the attack from. Use a separate Linux box or VM.
157
+
158
+ ### Hardware
159
+
160
+ | Component | Notes |
161
+ |-----------|-------|
162
+ | Donor PCIe card | Any inexpensive NIC, sound, or capture card works. One donor → one firmware. Destroy or quarantine the donor after extraction. |
163
+ | DMA board | Supported Artix‑7 DMA boards (35T, 75T, 100T). Must expose the Screamer USB‑JTAG port. |
164
+
165
+ ## 🛠️ Installation & Setup
166
+
167
+ ### Method 1: pip Installation (Recommended)
168
+
169
+ ```bash
170
+ # Install with TUI support
171
+ pip install pcileechfwgenerator[tui]
172
+
173
+ # Basic installation (CLI only)
174
+ pip install pcileechfwgenerator
175
+
176
+ # Development installation
177
+ git clone https://github.com/ramseymcgrath/PCILeechFWGenerator
178
+ cd PCILeechFWGenerator
179
+ pip install -e .[dev]
180
+ ```
181
+
182
+ ### Method 2: Manual Installation
183
+
184
+ ```bash
185
+ # Clone repository
186
+ git clone https://github.com/ramseymcgrath/PCILeechFWGenerator
187
+ cd PCILeechFWGenerator
188
+
189
+ # Install system dependencies
190
+ sudo ./install.sh
191
+
192
+ # Install Python dependencies
193
+ pip install -r requirements-tui.txt # For TUI support
194
+ # OR
195
+ pip install -r requirements.txt # Basic installation
196
+ ```
197
+
198
+ Re‑login or run `newgrp` afterwards so rootless Podman picks up subuid/subgid mappings.
199
+
200
+ ## 🎮 Usage
201
+
202
+ ### Interactive TUI Mode (Recommended)
203
+
204
+ The modern text-based interface provides guided workflows and real-time monitoring:
205
+
206
+ ```bash
207
+ # Launch TUI (after pip installation)
208
+ sudo pcileech-tui
209
+
210
+ # Or from source
211
+ sudo python3 tui_generate.py
212
+ ```
213
+
214
+ **TUI Features:**
215
+ - 🖥️ **Visual device browser** with enhanced PCIe device information
216
+ - ⚙️ **Guided configuration** with validation and profile management
217
+ - 📊 **Real-time build monitoring** with progress tracking and resource usage
218
+ - 🔍 **Intelligent error guidance** with suggested fixes
219
+ - 📡 **System status monitoring** for Podman, Vivado, USB devices, and more
220
+
221
+ See [`docs/TUI_README.md`](docs/TUI_README.md) for detailed TUI documentation.
222
+
223
+ ### Command Line Mode
224
+
225
+ For automated workflows or scripting:
226
+
227
+ ```bash
228
+ # Basic generation (interactive device selection)
229
+ sudo pcileech-generate
230
+
231
+ # Direct build with specific device (uses donor_dump kernel module by default)
232
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t
233
+
234
+ # Build without using donor_dump kernel module (using synthetic data)
235
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t --skip-donor-dump
236
+
237
+ # Build using a previously saved donor information file
238
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t --donor-info-file /path/to/donor_info.json
239
+
240
+ # Advanced generation with enhanced features
241
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t --advanced-sv
242
+
243
+ # Device-specific generation with behavior profiling
244
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t --advanced-sv \
245
+ --device-type network --enable-behavior-profiling
246
+
247
+ # Selective feature control
248
+ sudo pcileech-build --bdf 0000:03:00.0 --board 75t --advanced-sv \
249
+ --disable-power-management --disable-performance-counters
250
+ ```
251
+
252
+ **Note:** The system will automatically build the required container image (`dma-fw`) if it doesn't exist. This happens during the first run and requires an internet connection to download base images.
253
+
254
+ **Output:** `output/firmware.bin` (FPGA bit‑stream ready for flashing).
255
+
256
+ ### Legacy Mode (Source Installation)
257
+
258
+ ```bash
259
+ # Traditional workflow (still supported)
260
+ sudo python3 generate.py
261
+ ```
262
+
263
+ ## 🔌 Flashing the DMA Board
264
+
265
+ > **Note:** These steps can run on the same machine or a different PC.
266
+
267
+ 1. Power down, install the DMA card, and remove the donor.
268
+
269
+ 2. Connect the USB‑JTAG port.
270
+
271
+ 3. Flash:
272
+
273
+ ```bash
274
+ usbloader -f output/firmware.bin # auto‑detects Screamer VID:PID 1d50:6130
275
+ ```
276
+
277
+ If multiple λConcept boards are attached, add `--vidpid <vid:pid>`.
278
+
279
+ ## 🚀 Advanced Features
280
+
281
+ ### Manufacturing Variance Simulation
282
+
283
+ The Manufacturing Variance Simulation feature adds realistic hardware variations to make generated firmware more authentic and harder to detect. This feature models real-world manufacturing tolerances and environmental conditions.
284
+
285
+ **Key Capabilities:**
286
+ - **Device Class Support**: Consumer, Enterprise, Industrial, and Automotive grade components with appropriate variance characteristics
287
+ - **Timing Variations**: Clock jitter, register access timing, and propagation delays
288
+ - **Environmental Modeling**: Temperature drift, power supply noise, and process variations
289
+ - **Integration**: Seamlessly integrates with behavior profiling for enhanced realism
290
+
291
+ **Device Classes:**
292
+ - `CONSUMER`: Standard consumer-grade tolerances (2-5% clock jitter)
293
+ - `ENTERPRISE`: Tighter enterprise-grade specifications (1-3% variations)
294
+ - `INDUSTRIAL`: Extended temperature and reliability ranges
295
+ - `AUTOMOTIVE`: Automotive-grade specifications with enhanced stability
296
+
297
+ **Usage:**
298
+ ```bash
299
+ # Enable manufacturing variance (automatically applied with --advanced-sv)
300
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv
301
+ ```
302
+
303
+ ### Advanced SystemVerilog Generation
304
+
305
+ The Advanced SystemVerilog Generation feature provides a comprehensive, modular PCIe device controller with enterprise-grade capabilities and optimizations.
306
+
307
+ **Architecture Components:**
308
+ - **Modular Design**: Specialized components for power, error handling, and performance monitoring
309
+ - **Multiple Clock Domains**: Proper clock domain crossing with variance-aware timing
310
+ - **Device-Specific Logic**: Optimizations for Network, Storage, Graphics, and Audio devices
311
+ - **Comprehensive Integration**: All components work together seamlessly
312
+
313
+ **Power Management Features:**
314
+ - **PCIe Power States**: Full D0, D1, D2, D3hot, D3cold state support
315
+ - **ASPM (Active State Power Management)**: L0s, L1, L1.1, L1.2 link states
316
+ - **Dynamic Power Scaling**: Frequency and voltage scaling based on workload
317
+ - **Wake-on-LAN/Event**: Configurable wake event handling
318
+
319
+ **Error Handling & Recovery:**
320
+ - **Comprehensive Error Detection**: Correctable and uncorrectable error handling
321
+ - **Advanced Error Reporting (AER)**: Full PCIe AER implementation
322
+ - **Recovery Mechanisms**: Automatic error recovery and link retraining
323
+ - **Error Logging**: Detailed error tracking and reporting
324
+
325
+ **Performance Monitoring:**
326
+ - **Hardware Counters**: Transaction, bandwidth, and latency monitoring
327
+ - **Device-Specific Metrics**: Tailored counters for different device types
328
+ - **Real-time Monitoring**: Live performance data collection
329
+ - **Threshold-based Alerts**: Configurable performance thresholds
330
+
331
+ **Device-Specific Optimizations:**
332
+ - **Network Devices**: Multi-queue support, interrupt coalescing, checksum offload
333
+ - **Storage Devices**: Command queuing, wear leveling, power loss protection
334
+ - **Graphics Devices**: Memory bandwidth optimization, display timing
335
+ - **Audio Devices**: Low-latency processing, sample rate conversion
336
+
337
+ **Usage Examples:**
338
+ ```bash
339
+ # Enable all advanced features
340
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv
341
+
342
+ # Network device with specific optimizations
343
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv --device-type network
344
+
345
+ # Disable specific features for minimal implementation
346
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv \
347
+ --disable-power-management --disable-error-handling
348
+
349
+ # Storage device with performance monitoring
350
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv \
351
+ --device-type storage --enable-behavior-profiling
352
+ ```
353
+
354
+ ### Behavioral Profiling
355
+
356
+ Dynamic behavior profiling captures real device operation patterns to enhance firmware realism by monitoring and analyzing how the donor device behaves during normal operation.
357
+
358
+ **Capabilities:**
359
+ - **Real-time Monitoring**: Captures live device register access patterns and timing
360
+ - **Pattern Analysis**: Identifies behavioral signatures, timing characteristics, and state transitions
361
+ - **Manufacturing Variance Integration**: Combines with variance simulation for enhanced realism
362
+ - **SystemVerilog Enhancement**: Automatically integrates behavioral data into generated code
363
+ - **Configurable Duration**: Adjustable profiling periods (default: 30 seconds)
364
+
365
+ **Key Benefits:**
366
+ - **Enhanced Realism**: Generated firmware mimics actual device behavior patterns
367
+ - **Improved Timing Accuracy**: Precise register access timing based on real-world measurements
368
+ - **Optimized Performance**: Device-specific optimizations based on observed behavior
369
+ - **Reduced Detection Risk**: More authentic behavioral signatures
370
+
371
+ **Usage:**
372
+ ```bash
373
+ # Enable behavior profiling with custom duration
374
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t \
375
+ --enable-behavior-profiling --profile-duration 30.0
376
+
377
+ # Enable profiling with device-specific optimizations
378
+ python3 src/build.py --bdf 0000:03:00.0 --board 75t --advanced-sv \
379
+ --device-type network --enable-behavior-profiling
380
+ ```
381
+
382
+ ### Command-Line Options
383
+
384
+ **Core Options:**
385
+ - `--bdf`: PCIe Bus:Device.Function identifier (required)
386
+ - `--board`: Target board type (35t, 75t, 100t) (required)
387
+
388
+ **Donor Device Options:**
389
+ - `--skip-donor-dump`: Skip using the donor_dump kernel module (opt-in, not default)
390
+ - `--donor-info-file`: Path to a JSON file containing donor information from a previous run
391
+
392
+ **Advanced Features:**
393
+ - `--advanced-sv`: Enable advanced SystemVerilog generation
394
+ - `--device-type`: Specify device type (generic, network, storage, graphics, audio)
395
+ - `--enable-behavior-profiling`: Enable dynamic behavior profiling
396
+ - `--profile-duration`: Profiling duration in seconds (default: 30.0)
397
+
398
+ **Feature Control:**
399
+ - `--disable-power-management`: Disable power management features
400
+ - `--disable-error-handling`: Disable error handling features
401
+ - `--disable-performance-counters`: Disable performance monitoring
402
+
403
+ **Analysis & Debugging:**
404
+ - `--save-analysis`: Save detailed analysis to specified file
405
+ - `--verbose`: Enable verbose output
406
+ - `--enhanced-timing`: Enable enhanced timing models (default: enabled)
407
+
408
+ ## 🧹 Cleanup & Safety
409
+
410
+ - Rebind the donor back to its original driver if you keep it around.
411
+ - Keep the generated firmware private; it contains identifiers from the donor.
412
+ - Advanced features require appropriate privileges for hardware access.
413
+
414
+ ## ⚠️ Disclaimer
415
+
416
+ This tool is intended for educational research and legitimate PCIe development purposes only. Users are responsible for ensuring compliance with all applicable laws and regulations. The authors assume no liability for misuse of this software.
417
+
418
+ ## 📦 Development & Contributing
419
+
420
+ For development setup instructions, please see [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md).
421
+
422
+ ### Building from Source
423
+
424
+ ```bash
425
+ # Build distributions
426
+ python -m build
427
+
428
+ # Install locally
429
+ pip install dist/*.whl
430
+
431
+ # Test installation
432
+ pcileech-generate --help
433
+ ```
434
+
435
+ ### Contributing
436
+
437
+ We welcome contributions! Please see [`CONTRIBUTING.md`](CONTRIBUTING.md) for detailed guidelines.
438
+
439
+ **Quick Start:**
440
+ 1. Fork the repository
441
+ 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
442
+ 3. Make your changes
443
+ 4. Add tests for new functionality
444
+ 5. Run the test suite (`pytest`)
445
+ 6. Commit your changes (`git commit -m 'feat: add amazing feature'`)
446
+ 7. Push to the branch (`git push origin feature/amazing-feature`)
447
+ 8. Open a Pull Request
448
+
449
+ ### Release Process
450
+
451
+ For maintainers releasing new versions:
452
+
453
+ ```bash
454
+ # Automated release (recommended)
455
+ python scripts/release.py minor --release-notes "Add new TUI features and improvements"
456
+
457
+ # Manual release
458
+ python -m build
459
+ twine upload dist/*
460
+ ```
461
+
462
+ ## 📚 Documentation
463
+
464
+ - **[TUI Documentation](docs/TUI_README.md)**: Detailed TUI interface guide
465
+ - **[TUI Design Document](docs/TUI_Design_Document.md)**: Technical architecture
466
+ - **[Contributing Guide](CONTRIBUTING.md)**: Development and contribution guidelines
467
+ - **[Changelog](CHANGELOG.md)**: Version history and release notes
468
+ - **[API Reference](https://pcileechfwgenerator.readthedocs.io/)**: Complete API documentation
469
+
470
+ ## 🔧 Troubleshooting
471
+
472
+ ### Common Issues
473
+
474
+ **Installation Problems:**
475
+ ```bash
476
+ # If pip installation fails
477
+ pip install --upgrade pip setuptools wheel
478
+ pip install pcileechfwgenerator[tui]
479
+
480
+ # For development installation issues
481
+ pip install -e .[dev]
482
+ ```
483
+
484
+ **TUI Not Starting:**
485
+ ```bash
486
+ # Check TUI dependencies
487
+ python -c "import textual; print('TUI dependencies OK')"
488
+
489
+ # Install TUI dependencies manually
490
+ pip install textual rich psutil watchdog
491
+ ```
492
+
493
+ **Permission Issues:**
494
+ ```bash
495
+ # Ensure proper permissions for PCIe operations
496
+ sudo usermod -a -G vfio $USER
497
+ sudo usermod -a -G dialout $USER # For USB-JTAG access
498
+ ```
499
+
500
+ **Container Issues:**
501
+ ```bash
502
+ # Check Podman installation
503
+ podman --version
504
+
505
+ # Verify rootless setup
506
+ podman info | grep rootless
507
+
508
+ # Test container build and dependencies
509
+ ./scripts/build_container.sh --test
510
+
511
+ # Manual container dependency check
512
+ podman run --rm pcileechfwgenerator:latest python3 -c "import psutil, pydantic; print('Dependencies OK')"
513
+
514
+ # Check container file structure
515
+ podman run --rm pcileechfwgenerator:latest ls -la /app/src/
516
+
517
+ # Test with specific capabilities (recommended)
518
+ podman run --rm --cap-add=SYS_RAWIO --cap-add=SYS_ADMIN pcileechfwgenerator:latest echo "Capability test passed"
519
+ ```
520
+
521
+ **Container Security Best Practices:**
522
+ - Use specific capabilities (`--cap-add=SYS_RAWIO --cap-add=SYS_ADMIN`) instead of `--privileged` when possible
523
+ - Always mount output directories to preserve generated files: `-v ./output:/app/output`
524
+ - The container runs as non-root user `appuser` by default for security
525
+ - Use the build script for automated testing: `./scripts/build_container.sh --test`
526
+
527
+ ### Getting Help
528
+
529
+ - **GitHub Issues**: [Report bugs or request features](https://github.com/ramseymcgrath/PCILeechFWGenerator/issues)
530
+ - **GitHub Discussions**: [Community support and questions](https://github.com/ramseymcgrath/PCILeechFWGenerator/discussions)
531
+ - **Documentation**: Check the docs/ directory for detailed guides
532
+
533
+ ## 🏆 Acknowledgments
534
+
535
+ - **λConcept**: For the excellent usbloader utility and Screamer hardware
536
+ - **Xilinx/AMD**: For Vivado synthesis tools
537
+ - **Textual**: For the modern TUI framework
538
+ - **PCILeech Community**: For feedback and contributions
539
+
540
+ ## 📄 License
541
+
542
+ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
543
+
544
+ ## ⚠️ Legal Notice
545
+
546
+ This tool is intended for educational research and legitimate PCIe development purposes only. Users are responsible for ensuring compliance with all applicable laws and regulations. The authors assume no liability for misuse of this software.
547
+
548
+ **Security Considerations:**
549
+ - Never build firmware on systems used for production or sensitive operations
550
+ - Use isolated build environments (VMs or dedicated hardware)
551
+ - Keep generated firmware private and secure
552
+ - Follow responsible disclosure practices for any security research
553
+
554
+ ---
555
+
556
+ **Version 0.1.6** - Major release with TUI interface and professional packaging
557
+ For educational research and legitimate PCIe development only. Misuse may violate laws and void warranties. The authors assume no liability.
@@ -0,0 +1,38 @@
1
+ pcileechfwgenerator-2.0.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
2
+ src/__init__.py,sha256=Xl4atqz_tYuMxGYDilhw3VKqDozNh4QKenFK1yF32zU,531
3
+ src/__version__.py,sha256=P_I9Zlrh-xLKGV-C_avWKMXiivyO06qrZnpXp2KfTA4,508
4
+ src/advanced_sv_error.py,sha256=rrcXF2025yLO16p19WJCpFdT3MPU7dYfqUqrQtFEg7Q,19618
5
+ src/advanced_sv_generator.py,sha256=RYGmPBTBKUKBq8GzLasrC6-i-0T0Kx-ZJUKFsilalBE,73584
6
+ src/advanced_sv_main.py,sha256=nAtIkhrc9z8Gev2qkT0AY1NA9SzbOyAUO0ULa8xenEs,27062
7
+ src/advanced_sv_perf.py,sha256=SKk0Ov0Xmr7HaoDO4aMh3TeNl3IDeGVKw8WLsUq-4Eg,27699
8
+ src/advanced_sv_power.py,sha256=cXd7_WQb3eNjeNX5y3WXN42LaLzFj08nvjRzaMYrJec,16491
9
+ src/behavior_profiler.py,sha256=TdQz2pmRTp5h0Bc7ytAsC8wdbL34OIQfeMP5P36k2bc,33107
10
+ src/build.py,sha256=M6ZQhsOJJDYsm-k3zOwIHNV3_sS7qScYsLoYDJC-ObM,55220
11
+ src/donor_dump_manager.py,sha256=LPTDp2f07sEQ7R8THRCBv69YvFIJHmCDwEHZlKQ8Uts,31235
12
+ src/flash_fpga.py,sha256=fli7N1vkRlQ5CL1PafQTXgImPqgRw0H7xDR3rUKctAs,1046
13
+ src/generate_cli.py,sha256=Ywfdwis3lbrb610kTErwtqsp2-IW7K-76DMXI_z5OlE,859
14
+ src/manufacturing_variance.py,sha256=qa0VfFdGCtNzLbsQZ83b7qCNP5liw22LbYsvSzrvpq4,17083
15
+ src/state_machine_extractor.py,sha256=81RczKuaHadOgMGInx9cnG5sB1XT1FBM6DbsMaRKqh8,32530
16
+ src/tui_cli.py,sha256=2dDAeWipkPS_rtano_vmmSehJOoKVBs64KlIBwd1YUo,1131
17
+ src/donor_dump/Makefile,sha256=aYylytszZUiK0M5ZZteUx02QbR99abQjU7Dj5Oyr_-U,2956
18
+ src/donor_dump/README.md,sha256=9XHPizyao8ovNE9bokbfD36bUybMcThNsF0KLWpSVTQ,7022
19
+ src/donor_dump/donor_dump.c,sha256=iPscPJ51tziveaERtkkZpasUh7lCPcAGIziQHmntKcI,15305
20
+ src/scripts/driver_scrape.py,sha256=0nFw9EXsUK4NZXfTzUQyqyRxj6hlTcRL4u-sGJsoCoc,24345
21
+ src/tui/__init__.py,sha256=8mgYm17-HAcGGqDDXs0k0go01qPAPUV0H1oXe1UyGVs,305
22
+ src/tui/main.py,sha256=i9-ANXNnvjovFIyOFejnLth2klsQ7t99X_BMe7vqyuE,32959
23
+ src/tui/core/__init__.py,sha256=oUTt4hDvbqrJqNrEstuPH6wTn-x0o_5jtRB4eJ3a57c,419
24
+ src/tui/core/build_orchestrator.py,sha256=ETE1EHh-6pLW0eIh3RfGD-TVxJ-78rx_Ov6AB7OuIUU,40728
25
+ src/tui/core/config_manager.py,sha256=2xc1IJtKX1Gi4OvCHchia-oah4DzGU6lcNOdGIT6BmM,9377
26
+ src/tui/core/device_manager.py,sha256=qYShE2swSzVTLhkEjZnodZl7EDK2rpIn5-SSFRcZNJs,10186
27
+ src/tui/core/status_monitor.py,sha256=7V2R3KgKK3HOXlw_fFoZnh6Fou5mGhc4ZXlXgC944xc,11200
28
+ src/tui/models/__init__.py,sha256=gR1LHu87d-QBU4F2dMNs1Rl7X_-rG1d1W2QyQRC5E4Q,355
29
+ src/tui/models/config.py,sha256=DlxkzG8A8IsjA_rVq5fBaAt1B45b_e6uL6PqRDb86PU,6250
30
+ src/tui/models/device.py,sha256=fT2kOaI-7ZpMSI4YPKFIMHHwFc4qkiukSyJr-qZxKTQ,2162
31
+ src/tui/models/error.py,sha256=tSg8UUrqU-8Sey0-Qh9IHlVhUQdUqg4tiTFor2oEYTg,5926
32
+ src/tui/models/progress.py,sha256=IY8A5_QwNx4RQMZPvXRg6fSuScozwEe5gH_XLc-Eg8o,4213
33
+ src/tui/styles/main.tcss,sha256=VVbRmlPFsSClTIIaHh7kVuBhxowu5WfNMmIoSTKDxU4,2429
34
+ pcileechfwgenerator-2.0.0.dist-info/METADATA,sha256=cVdeA8kKj0OdUEBbu4GVE7VLi9rHYtilm5IYIrVUe4U,21532
35
+ pcileechfwgenerator-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
36
+ pcileechfwgenerator-2.0.0.dist-info/entry_points.txt,sha256=PMd60yt9NOWZsKXsKJX9WxjQuWhUgPCIqUlTlHCMZJU,124
37
+ pcileechfwgenerator-2.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
38
+ pcileechfwgenerator-2.0.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.9.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,4 @@
1
+ [console_scripts]
2
+ pcileech-build = src.build:main
3
+ pcileech-generate = src.generate_cli:main
4
+ pcileech-tui = src.tui_cli:main