Skip to content

CLI Usage

The AtPack Parser provides a powerful command-line interface for working with AtPack files.

Basic Command Structure

atpack [OPTIONS] COMMAND [ARGS]...

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

atpack files info /path/to/file.atpack

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

atpack files list /path/to/atpack/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

atpack files extract /path/to/file.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:

atpack files extract ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack

This would extract all files to ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162_dir_atpack/ directory.

You can specify a custom output directory:

atpack files extract ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack --outdir ./extracted_files/

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

atpack devices list /path/to/file.atpack

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

atpack search "*YourPattern*" /path/to/file.atpack

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
Example:

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

atpack devices packages DEVICE_NAME /path/to/file.atpack

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:

atpack devices packages ATmega16 ./atpacks/Atmel.ATmega_DFP.2.2.509.atpack

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

atpack devices pinout DEVICE_NAME /path/to/file.atpack

This command displays pinout information for a device, showing pin positions, pad names, pin types, and optional alternative functions.

Example:

atpack devices pinout PIC16F877 ./atpacks/Microchip.PIC16Fxxx_DFP.1.7.162.atpack

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
Example:
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                          โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

# Show flat memory map for a device
atpack memory show DEVICE_NAME /path/to/file.atpack --flat
Example:
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

atpack registers list DEVICE_NAME /path/to/file.atpack

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

atpack registers show DEVICE_NAME REGISTER_NAME /path/to/file.atpack

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

atpack registers list DEVICE_NAME /path/to/file.atpack --module MODULE_NAME

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)

atpack config show DEVICE_NAME /path/to/file.atpack --type fuses

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:

atpack --help
atpack help-tree          # Show complete command structure
atpack help               # Interactive help
atpack devices --help
atpack devices info --help