CLI Usage
The AtPack Parser provides a powerful command-line interface for working with AtPack files.
Basic Command Structure
Global Options
--help
- Show help message--version
- Show version information
atpack --help
Usage: atpack [OPTIONS] COMMAND [ARGS]...
๐ง AtPack Parser - Parse AtPack files
โญโ Options โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --version -v Show version โ
โ --install-completion Install completion for the current shell. โ
โ --show-completion Show completion for the current shell, to copy it or customize the installation. โ
โ --help Show this message and exit. โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Commands โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ scan ๐ Scan directory for AtPack files. โ
โ help-tree ๐ณ Show the complete command tree structure with examples. โ
โ help โ Get interactive help for commands. โ
โ tui ๐ฅ๏ธ Launch Terminal User Interface (TUI). โ
โ files ๐ AtPack file management โ
โ devices ๐ Device information โ
โ memory ๐พ Memory information โ
โ registers ๐ Register information โ
โ config โ๏ธ Configuration information โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Help tree command
atpack help-tree
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ ๐ณ Command Tree with Examples โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ ๐ง atpack - AtPack Parser CLI โ
โ โโโ ๐ files - AtPack file management โ
โ โ โโโ list - List files in an AtPack โ
โ โ โโโ info - Show AtPack file information โ
โ โ โโโ extract - Extract AtPack file โ
โ โโโ ๐ devices - Device information โ
โ โ โโโ list - List all devices โ
โ โ โโโ info - Show device details โ
โ โ โโโ search - Search devices by pattern โ
โ โ โโโ packages - List device packages/variants โ
โ โ โโโ pinout - Show device pinout information โ
โ โโโ ๐พ memory - Memory information โ
โ โ โโโ show - Show memory layout โ
โ โโโ ๐ registers - Register information โ
โ โ โโโ list - List registers โ
โ โ โโโ show - Show register details โ
โ โโโ โ๏ธ config - Configuration information โ
โ โ โโโ show - Show configuration information โ
โ โโโ ๐ scan - Scan directory for AtPack files โ
โ โโโ ๐ณ help-tree - Show command tree structure โ
โ โโโ ๐ฅ๏ธ tui - Launch Terminal User Interface โ
โ โ
โ ๐ Usage Examples: โ
โ atpack files list mypack.atpack โ
โ atpack files info mypack.atpack โ
โ atpack files extract mypack.atpack โ
โ โ
โ atpack devices list mypack.atpack โ
โ atpack devices info PIC16F877 mypack.atpack โ
โ atpack devices search '*877*' mypack.atpack โ
โ atpack devices packages ATmega16 mypack.atpack โ
โ atpack devices pinout PIC16F877 mypack.atpack โ
โ โ
โ atpack memory show PIC16F877 mypack.atpack โ
โ atpack memory show PIC16F877 mypack.atpack --flat โ
โ โ
โ atpack registers list PIC16F877 mypack.atpack โ
โ atpack registers list PIC16F877 mypack.atpack --module GPIO โ
โ atpack registers show PIC16F877 PORTB mypack.atpack โ
โ โ
โ atpack config show PIC16F877 mypack.atpack โ
โ atpack config show PIC16F877 mypack.atpack --type fuses โ
โ โ
โ atpack scan ./atpacks/ --format json โ
โ โ
โ atpack tui โ
โ atpack tui ./my_atpacks/ โ
โ โ
โ โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Commands Overview
Scan for AtPack Files in a Directory
atpack scan ./atpacks/
๐ AtPack Files in atpacks
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโณโโโโโโโโโโณโโโโโโโโโโณโโโโโโโโโโโณโโโโโโโโโโ
โ Path โ Name โ Vendor โ Family โ Devices โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ Atmel.ATmega_DFP.2.2.509.atpack โ Unknown โ Unknown โ ๐ต ATMEL โ 133 โ
โ Microchip.PIC16Fxxx_DFP.1.7.162.atpack โ Unknown โ Unknown โ ๐ด PIC โ 164 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโ
Found 2 AtPack files
Files Commands
Work with AtPack files and directories:
Show information about a specific AtPack file
Example:
atpack files info ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ ๐ฆ AtPack Information โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Name: Unknown โ
โ Vendor: Unknown โ
โ Version: 0.0.0 โ
โ Device Family: PIC โ
โ Description: Microchip PIC16Fxxx Series Device Support โ
โ URL: N/A โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
List all AtPack files in a directory
Example:atpack files list ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
Files in Microchip.PIC16Fxxx_DFP.1.7.162.atpack
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโโโโโ
โ File Path โ Size โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ edc/ โ 0 bytes โ
โ hwtools/ โ 0 bytes โ
โ hwtools/mplab/ โ 0 bytes โ
...
โ xc8/pic/include/proc/pic16lf877a.inc โ 90,175 bytes โ
โ xc8/pic/include/proc/pic16lf88.h โ 142,857 bytes โ
โ xc8/pic/include/proc/pic16lf88.inc โ 80,519 bytes โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
Extract files from an AtPack
This command extracts all files from an AtPack archive to a directory. By default, it extracts to a directory named {filename}_dir_atpack
where {filename}
is the AtPack filename without the .atpack
extension.
Example:
This would extract all files to ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162_dir_atpack/
directory.
You can specify a custom output directory:
Optional parameters:
- --outdir
or -o
: Specify output directory
- --overwrite
: Overwrite existing directory if it exists
Example with options:
atpack files extract ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack --outdir ./my_extraction/ --overwrite
Example output:
atpack files extract ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
Extracting Microchip.PIC16Fxxx_DFP.1.7.162.atpack to Microchip.PIC16Fxxx_DFP.1.7.162_dir_atpack
โ Successfully extracted 3,847 files to Microchip.PIC16Fxxx_DFP.1.7.162_dir_atpack
Total size: 45,892,437 bytes
Device Commands
Extract and display device information:
List all devices in an AtPack file
Example:
atpack devices list ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
๐ด PIC Devices in
Microchip.PIC16Fxxx_DFP.1.7.162.atp
ack
โโโโโโโโโโโโโโโโโโโโโโโโโโโณโโโโโโโโ
โ Device Name โ Index โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ AC162052_AS_PIC16F630 โ 1 โ
โ AC162052_AS_PIC16F676 โ 2 โ
โ AC162053_AS_PIC16F627A โ 3 โ
โ AC162053_AS_PIC16F628A โ 4 โ
...
โ PIC16LF876A โ 161 โ
โ PIC16LF877 โ 162 โ
โ PIC16LF877A โ 163 โ
โ PIC16LF88 โ 164 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโ
Total: 164 devices
List all devices in an AtPack file matching a pattern
Example:
atpack devices search "*877*" ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
๐ด PIC Devices matching
'*877*'
โโโโโโโโโโโโโโโณโโโโโโโโ
โ Device Name โ Index โ
โกโโโโโโโโโโโโโโโโโโโโโโฉ
โ PIC16F877 โ 1 โ
โ PIC16F877A โ 2 โ
โ PIC16LF877 โ 3 โ
โ PIC16LF877A โ 4 โ
โโโโโโโโโโโโโโโดโโโโโโโโ
# Get detailed information about a specific device
atpack devices info DEVICE_NAME /path/to/file.atpack
atpack devices info PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ ๐ Device: PIC16F877 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Family: ๐ด PIC โ
โ Architecture: PIC โ
โ Series: PIC16 โ
โ Memory Segments: 8 โ
โ Modules: 5 โ
โ Interrupts: 17 โ
โ Signatures: 1 โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
๐พ Memory Overview
โโโโโโโโโโโโโณโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโโโ
โ Segment โ Start Address โ End Address โ Size โ Type โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ PROG1 โ 0x0000 โ 0x07FF โ 2,048 bytes โ program โ
โ SFR_BANK0 โ 0x0000 โ 0x001F โ 32 bytes โ sfr โ
โ SFR_BANK1 โ 0x0080 โ 0x009F โ 32 bytes โ sfr โ
โ SFR_BANK2 โ 0x0100 โ 0x010F โ 16 bytes โ sfr โ
โ SFR_BANK3 โ 0x0180 โ 0x018F โ 16 bytes โ sfr โ
โ PROG2 โ 0x0800 โ 0x0FFF โ 2,048 bytes โ program โ
โ PROG3 โ 0x1000 โ 0x17FF โ 2,048 bytes โ program โ
โ PROG4 โ 0x1800 โ 0x1FFF โ 2,048 bytes โ program โ
โโโโโโโโโโโโโดโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโ
๐ง Modules Overview
โโโโโโโโโโณโโโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโโโโโ
โ Module โ Register Groups โ Total Registers โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ BANK0 โ 1 โ 32 โ
โ BANK1 โ 1 โ 17 โ
โ BANK2 โ 1 โ 4 โ
โ BANK3 โ 1 โ 2 โ
โ CORE โ 1 โ 1 โ
โโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
Typo in device name? No problem!
When typing the command, you can use the device name with a typo, it's not a problem. The command will help you to find the correct device name in the list of devices with nearest match.
atpack devices info PIC16f877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
Device not found: Device 'PIC16f877' not found or could not be parsed: Error parsing PIC file for 'PIC16f877': Device 'PIC16f877' not
found in PIC file
Did you mean one of these devices?
1. PIC16F877
2. PIC16F87
3. PIC16F877A
4. PIC16LF877
5. PIC16LF877A
6. PIC16F677
7. PIC16F687
8. PIC16F767
9. PIC16F777
10. PIC16F871
11. PIC16F876
12. PIC16F887
13. PIC16LF77
14. PIC16LF87
15. PIC16LF871
List all packages/variants for a device
This command lists all available packages/variants for a specific device, including package types, pin counts, temperature ranges, voltage ranges, and maximum operating frequencies.
Example:
Optional parameters:
- --format
or -f
: Output format (table, json, csv)
- --output
or -o
: Export results to file
- --no-color
: Disable colored output
Show device pinout information
This command displays pinout information for a device, showing pin positions, pad names, pin types, and optional alternative functions.
Example:
Optional parameters:
- --package
or -p
: Show specific package/pinout only
- --functions
: Include pin alternative functions in the output
- --format
or -f
: Output format (table, json, csv)
- --output
or -o
: Export results to file
- --no-color
: Disable colored output
Example with package filter:
atpack devices pinout ATmega16 ./atpacks/Atmel.ATmega_DFP.2.2.509.atpack --package TQFP44 --functions
Memory Commands
Analyze device memory layout:
# Show hierarchical memory map for a device (default)
atpack memory show DEVICE_NAME /path/to/file.atpack
atpack memory show PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
๐พ Memory Layout: PIC16F877 (Hierarchical)
โโโโโโโโโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโณโโโโโโโโโโโโโโโณโโโโโโโโโโโโณโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Memory Space/Segment โ Start Address โ End Address โ Size โ Type โ Page Size โ Description โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ ๐ ProgramSpace โ N/A โ N/A โ N/A โ ProgramSpace โ N/A โ Container with 10 segment(s) โ
โ โโโ PROG1 โ 0x0000 โ 0x07FF โ 2,048 โ program โ N/A โ ROM code space - page0 โ
โ โโโ PROG2 โ 0x0800 โ 0x0FFF โ 2,048 โ program โ N/A โ ROM code space - page1 โ
โ โโโ PROG3 โ 0x1000 โ 0x17FF โ 2,048 โ program โ N/A โ ROM code space - page2 โ
โ โโโ PROG4 โ 0x1800 โ 0x1FFF โ 2,048 โ program โ N/A โ ROM code space - page3 โ
โ โโโ IDLOCS โ 0x2000 โ 0x2003 โ 4 โ userid โ N/A โ ID locations โ
โ โโโ TEST โ 0x2000 โ 0x20FF โ 256 โ test โ N/A โ N/A โ
โ โโโ DEBUG โ 0x2004 โ 0x2004 โ 1 โ debug โ N/A โ N/A โ
โ โโโ DEVICEID โ 0x2006 โ 0x2006 โ 1 โ deviceid โ N/A โ N/A โ
โ โโโ CONFIG โ 0x2007 โ 0x2007 โ 1 โ config โ N/A โ N/A โ
โ โโโ DEEPROM โ 0x2100 โ 0x21FF โ 256 โ eeprom โ N/A โ Data EEPROM โ
โ ๐ DataSpace โ 0x0000 โ 0x01FF โ 512 โ DataSpace โ N/A โ Container with 4 segment(s) โ
โ โโโ SFR_BANK0 โ 0x0000 โ 0x001F โ 32 โ sfr โ N/A โ N/A โ
โ โโโ SFR_BANK1 โ 0x0080 โ 0x009F โ 32 โ sfr โ N/A โ N/A โ
โ โโโ SFR_BANK2 โ 0x0100 โ 0x010F โ 16 โ sfr โ N/A โ N/A โ
โ โโโ SFR_BANK3 โ 0x0180 โ 0x018F โ 16 โ sfr โ N/A โ N/A โ
โโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
atpack memory show PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack --flat
๐พ Memory Layout: PIC16F877 (Flat)
โโโโโโโโโโโโโณโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโณโโโโโโโโโโณโโโโโโโโโโโโณโโโโโโโโโโโโโโโโ
โ Segment โ Start Address โ End Address โ Size โ Type โ Page Size โ Address Space โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ PROG1 โ 0x0000 โ 0x07FF โ 2,048 โ program โ N/A โ program โ
โ SFR_BANK0 โ 0x0000 โ 0x001F โ 32 โ sfr โ N/A โ data โ
โ SFR_BANK1 โ 0x0080 โ 0x009F โ 32 โ sfr โ N/A โ data โ
โ SFR_BANK2 โ 0x0100 โ 0x010F โ 16 โ sfr โ N/A โ data โ
โ SFR_BANK3 โ 0x0180 โ 0x018F โ 16 โ sfr โ N/A โ data โ
โ PROG2 โ 0x0800 โ 0x0FFF โ 2,048 โ program โ N/A โ program โ
โ PROG3 โ 0x1000 โ 0x17FF โ 2,048 โ program โ N/A โ program โ
โ PROG4 โ 0x1800 โ 0x1FFF โ 2,048 โ program โ N/A โ program โ
โโโโโโโโโโโโโดโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโดโโโโโโโโโโโโโโโโ
Register Commands
Work with device registers and peripherals:
List all registers for a device
Example:
atpack registers list PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
๐ Registers: PIC16F877
โโโโโโโโโโณโโโโโโโโโโโโโณโโโโโโโโโณโโโโโโโณโโโโโโโโโณโโโโโโโโโโโโ
โ Module โ Register โ Offset โ Size โ Access โ Bitfields โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ BANK0 โ INDF โ 0x0000 โ 1 โ R โ 1 โ
โ CORE โ WREG โ 0x0000 โ 1 โ RW โ 0 โ
โ BANK0 โ TMR0 โ 0x0001 โ 1 โ RW โ 1 โ
...
โ BANK2 โ EEADRH โ 0x010F โ 1 โ R โ 1 โ
โ BANK3 โ EECON1 โ 0x018C โ 1 โ R โ 5 โ
โ BANK3 โ EECON2 โ 0x018D โ 1 โ W โ 1 โ
โโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโดโโโโโโโดโโโโโโโโโดโโโโโโโโโโโโ
Show details for a specific register
Example:
atpack registers show PIC16F877 OPTION_REG ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ ๐ Register: OPTION_REG โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Name: OPTION_REG โ
โ Caption: OPTION_REG โ
โ Offset: 0x0081 โ
โ Size: 1 bytes โ
โ Access: RW โ
โ Mask: N/A โ
โ Initial Value: N/A โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
๐ง Bitfields
โโโโโโโโโโณโโโโโโโณโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโโ
โ Name โ Bits โ Mask โ Description โ Values โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ PS โ 2:0 โ 0x07 โ PS โ N/A โ
โ โโ PS0 โ 0 โ 0x01 โ PS0 โ N/A โ
โ โโ PS1 โ 1 โ 0x02 โ PS1 โ N/A โ
โ โโ PS2 โ 2 โ 0x04 โ PS2 โ N/A โ
โ PSA โ 3 โ 0x08 โ PSA โ N/A โ
โ T0SE โ 4 โ 0x10 โ T0SE โ N/A โ
โ T0CS โ 5 โ 0x20 โ T0CS โ N/A โ
โ INTEDG โ 6 โ 0x40 โ INTEDG โ N/A โ
โ nRBPU โ 7 โ 0x80 โ nRBPU โ N/A โ
โโโโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโ
Filter registers by module
Example:
atpack registers list PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack --module CORE
๐ Registers: PIC16F877 (Module: CORE)
โโโโโโโโโโณโโโโโโโโโโโณโโโโโโโโโณโโโโโโโณโโโโโโโโโณโโโโโโโโโโโโ
โ Module โ Register โ Offset โ Size โ Access โ Bitfields โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ CORE โ WREG โ 0x0000 โ 1 โ RW โ 0 โ
โโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโดโโโโโโโดโโโโโโโโโดโโโโโโโโโโโโ
Configuration Commands
Extract device configuration information:
# Show all configuration information for a device
atpack config show DEVICE_NAME /path/to/file.atpack
Example:
atpack config show PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack
โก Interrupts
โโโโโโโโโณโโโโโโโโโโโณโโโโโโโโโโโโโโโโโ
โ Index โ Name โ Description โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ 0 โ AD_INT โ AD Interrupt โ
โ 1 โ BCL_INT โ BCL Interrupt โ
โ 2 โ CCP1_INT โ CCP1 Interrupt โ
โ 3 โ CCP2_INT โ CCP2 Interrupt โ
โ 4 โ EE_INT โ EE Interrupt โ
โ 5 โ G_INT โ G Interrupt โ
โ 6 โ INTE_INT โ INTE Interrupt โ
โ 7 โ PE_INT โ PE Interrupt โ
โ 8 โ PSP_INT โ PSP Interrupt โ
โ 9 โ RB_INT โ RB Interrupt โ
โ 10 โ RC_INT โ RC Interrupt โ
โ 11 โ SSP_INT โ SSP Interrupt โ
โ 12 โ T0_INT โ T0 Interrupt โ
โ 13 โ TMR0_INT โ TMR0 Interrupt โ
โ 14 โ TMR1_INT โ TMR1 Interrupt โ
โ 15 โ TMR2_INT โ TMR2 Interrupt โ
โ 16 โ TX_INT โ TX Interrupt โ
โโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโโโโโโโ
โ๏ธ Device Signatures
โโโโโโโโโโโโโโโณโโโโโโโโโโณโโโโโโโโ
โ Name โ Address โ Value โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ DEVID_DEVID โ 0x2006 โ 0x9A0 โ
โโโโโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโ
Show specific configuration type (fuses, config, interrupts, signatures)
Output Formatting
Most commands support JSON output format:
# JSON output
atpack devices info PIC16F877 file.atpack --format json
atpack devices list file.atpack --format json
atpack devices packages ATmega16 file.atpack --format json
atpack devices pinout PIC16F877 file.atpack --format json
atpack memory show PIC16F877 file.atpack --format json
atpack registers list PIC16F877 file.atpack --format json
atpack config show PIC16F877 file.atpack --format json
Filtering Options
Some commands provide filtering options:
# Filter registers by module
atpack registers list PIC16F877 file.atpack --module GPIO
# Show specific package pinout with functions
atpack devices pinout ATmega16 file.atpack --package TQFP44 --functions
# Show specific configuration types
atpack config show PIC16F877A file.atpack --type fuses
atpack config show PIC16F877A file.atpack --type interrupts
atpack config show PIC16F877A file.atpack --type signatures
Pipeline Integration
The CLI JSON output works well in scripts and pipelines:
# Count devices in an AtPack
atpack devices list file.atpack --format json | jq length
# Extract device names only
atpack devices list file.atpack --format json | jq -r '.devices[]'
# Get basic device information
atpack scan ./atpacks/ --format json | jq '.[] | {name, family, device_count}'
Getting Help
Use --help
with any command to get detailed usage information: