MEGA65 Wiki

https://mega65.atlassian.net
Admin
MEGA65 is a modern reimplementation of the legendary Commodore 65 computer, featuring collaborative...
Tokens:59,493
Snippets:924
Trust Score:9.6
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install and test the package

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Installs the generated .deb package and then attempts to build a mega65-tools mingw target to verify the installation.

```bash
sudo dpkg -i libusb-mingw-w64_1.0.24-1_amd64.deb
make bin/mega65_ftp.exe
```

--------------------------------

### Hyppotest Example Output

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5373953/hyppotest

Example output from running a hyppotest script, showing the status of various tests.

```text
[PASS] assemble with acme [PASS] poke directive [PASS] check mem [PASS] ignore reg directives [PASS] clear breakpoint directives [PASS] step and run directives [PASS] let directive [    ] flag directivesAborted (core dumped)
```

--------------------------------

### Install debian package building scripts

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Installs the necessary tools for building Debian packages. Ensure you have sudo privileges.

```bash
sudo apt install devscripts
```

--------------------------------

### Install mingw compilers

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Installs the MinGW-w64 cross-compilers for both 64-bit and 32-bit targets. These are essential for building Windows binaries on Linux.

```bash
sudo apt install gcc-mingw-w64-x86-64 g++-mingw-w64-x86-64 gcc-mingw-w64 g++-mingw-w64
```

--------------------------------

### Create and navigate to deb packaging directory

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Sets up a directory structure for building .deb packages. It's recommended to start from your home directory.

```bash
cd ~
mkdir debs
cd debs
```

--------------------------------

### Upload multiple memory segments and start program

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Load multiple data files into specific memory locations before starting the main program. Use `--halt` for intermediate loads to prevent etherload from jumping until the last invocation.

```bash
etherload -b 20000 --halt gfx.dat
etherload -b 8000 --halt music.dat
etherload -j 2016 game.prg
```

--------------------------------

### Load custom ROM and start program

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Execute a program file after loading a custom ROM. The specified ROM will be active during the execution of the program.

```bash
etherload -R 920384.ROM -r <file.prg>
```

--------------------------------

### Mega65_ftp with Direct Interface

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Start mega65_ftp by directly providing the IPv6 address and interface identifier for faster startup. This bypasses the auto-discovery process.

```bash
mega65_ftp -i fe80::d5ff:fe16:0%eth0
```

--------------------------------

### Rust Example: Eleven IDE Parser

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/31948801

This Rust code snippet is an example of parsing the Eleven IDE, demonstrating Rust programming efforts on the MEGA65. It requires the mos-hardware library.

```rust
mos-hardware/examples/11-parse.rs at helloworld · mlund/mos-hardware
```

--------------------------------

### Physical Address Breakdown Example

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/33259521/Memory%2BMapping

An example illustrating how the 'Megabyte selection' and 'Bank' components contribute to a physical address in the MEGA65.

```assembly
$FFDE800  Bank = $D  Megabyte-selection = $FF
```

--------------------------------

### MEGA65 MAP Calls Example

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/33259521/Memory%2BMapping

A walkthrough demonstrating the three MAP calls used in the MEGA65 appendix: disabling mapping, megabyte selection, and offset + 8KB block selection.

```assembly
1. disabling of mapping,
2. megabyte selection,
3. offset + 8KB block selection
```

--------------------------------

### Start machine language program

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Launch a machine language program by providing its hexadecimal starting address. Etherload performs a JMP to this address without resetting the machine. The program must handle I/O configuration and be located in BANK 0.

```bash
etherload -j 8000 <file.prg>
```

--------------------------------

### Copy libz directory for libusb

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Creates a copy of the libz packaging directory to be adapted for libusb. This avoids starting from scratch.

```bash
cd ..
cp -r libz libusb
cd libusb
```

--------------------------------

### Example Style Commit

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/history/219185209

Shows a commit message for style changes, indicating the type and a brief description of the changes.

```text
style: fixed whitespace and indent

```

--------------------------------

### Define HYPPO mode start address

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/34111489/HYPPO%2Bmode%2Bprograms

Sets the default start address for programs in C64 mode. This is a fundamental setting for cc65 configurations.

```config
FEATURES {
    STARTADDRESS: default = $0801;
}
```

--------------------------------

### Start Typing Mode in m65dbg

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/26902533/remote%2Btyping%2Bon%2Bthe%2BMEGA65

Enter typing mode in `m65dbg` by typing `ty` and pressing Enter. Text entered at the console will be sent to the MEGA65.

```bash
ty
```

--------------------------------

### Example Feature Commit

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/history/219185209

Demonstrates a commit message for adding a new feature, specifying the type, scope, and issue number.

```text
feat(megaflash): add subslot core support #912

```

--------------------------------

### Start machine language program with jump address

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361/Ethernet%2Btools%2Bmega65_ftp%2Band%2Betherload

Execute machine language programs by providing the starting address. The system is not reset, and etherload performs a JMP to the specified address. Interrupts are disabled, and memory mapping is cleared, requiring the start address to be in BANK 0.

```bash
etherload -j 8000 <file.prg>
```

```bash
etherload -b 8000 -j 8000 <file.prg>
```

--------------------------------

### Full package build and test cycle

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

A loop of tweaking debian files, building the package, assessing build output, removing old versions, installing the new version, and testing the executable build.

```bash
# <tweak stuff in debian/*>
debuild -us -uc
# <assess warnings/errors in .deb build output>
sudo dkpg -r libusb-mingw-w64
sudo dpkg -i libusb-mingw-w64_1.0.24-1_amd64.deb
make bin/mega65_ftp.exe
# <assess warnings/errors in .exe build output>
# go back to step 1
```

--------------------------------

### UART Monitor Register Output Example

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/32899174/Deciphering%2BUart%2BMonitor%2Bs%2Bregister%2Bdetails

This is an example of the output format from the UART monitor when displaying CPU register details. It shows the current state of various CPU components and system flags.

```text
PC   A  X  Y  Z  B  SP   MAPH MAPL LAST-OP In     P  P-FLAGS   RGP uS IO ws h RECA8LHC E1B2 00 01 18 00 00 01F0 B300 E300 F0FA    00     22 ..E...Z. ...P 18 -  00 - ..c..lhc
```

--------------------------------

### Example Style Commit Message

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/219185209/Commit%2Bmessage%2Bformat

Shows a commit message for style changes, indicating the type and a brief description.

```git
style: fixed whitespace and indent
```

--------------------------------

### Output of BIT file push

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/8716289/Release%2Bverification%2B0.95%2Bbatch%2B2%2Binstructions%2Band%2Btips

Example output from the m65 tool when pushing a BIT file via JTAG. Note the device selection line, which is important for subsequent steps.

```text
ograf@vlad$ m65 --bitonly mega65-reltest/mega65r3-2022XXYY.ZZ-abcdefg-89fdecb.bit 2022-09-23T08:35:35.074Z NOTE MEGA65 Cross-Development Tool 20220919.23-refact-bf8ded4~ 2022-09-23T08:35:35.112Z NOTE selecting device /dev/ttyUSB1 (Digilent; 0403:6010; 251633006E10; 03636093) 2022-09-23T08:35:35.228Z NOTE fpgajtag: Starting to send file 2022-09-23T08:35:38.759Z NOTE fpgajtag: Done sending file 2022-09-23T08:35:38.776Z NOTE Bitstream loaded
```

--------------------------------

### Start PRG file with automatic reset

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Use this command to run a PRG file. Etherload automatically detects the mode (C64 or MEGA65) and performs a reset before execution.

```bash
etherload -r <file.prg>
```

--------------------------------

### Start PRG file with D81 mount

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Execute a PRG file after mounting a D81 image from an SD card. Ensure the D81 image is already on the SD card.

```bash
etherload -m MYIMAGE.D81 -r <file.prg>
```

--------------------------------

### Start Remote Typing Session with m65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/26902533/remote%2Btyping%2Bon%2Bthe%2BMEGA65

Initiate an interactive remote typing session with the MEGA65 using `m65 -t -`. Commands entered will be sent sequentially.

```bash
m65 -l /dev/ttyS6 -t -
```

--------------------------------

### Example Fix Commit

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/history/219185209

Illustrates a commit message for fixing a bug, including the type, scope, description with issue number, and a brief explanation.

```text
fix(viciv.vhdl): some pixel did not show #123
The render pipeline did skip some pixels. Fixed it.

```

--------------------------------

### Connect to UART Monitor in XEMU

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/28344336/FCM%2BInsights%2Band%2BExperimentation

Connect to the UART monitor started in XEMU via telnet. This is used for debugging and interacting with the emulated system's serial port.

```bash
telnet localhost 4510
```

--------------------------------

### Example Feature Commit Message

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/219185209/Commit%2Bmessage%2Bformat

Illustrates a commit message for adding a new feature, specifying the type, scope, and issue number.

```git
feat(megaflash): add subslot core support #912
```

--------------------------------

### CC65 MEMORY Section Example

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/34111489

Defines memory regions such as ZP, LOADADDR, HEADER, CODE, and BSS. This configuration avoids a MAIN area to utilize custom symbols and allocates space for code and variables relative to defined symbols.

```cfg
MEMORY {
    ZP:       file = "", define = yes,               start = $0002,  size = $001A;
    LOADADDR: file = %O,               start = %S - 2,          size = $0002;
    HEADER:   file = %O, define = yes,               start = %S,              size = $000D;
    CODE:     file = %O,               start = __HEADER_LAST__, size = __HYPPO__ - __HEADER_LAST__;
    BSS:      file = "",               start = __HYPPOEND__,
              size = __HIMEM__ - __HYPPOEND__ - __STACKSIZE__ - 1;
}
```

--------------------------------

### m65dbg Mapping Command Output

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/33259521/Memory%2BMapping

Example output from the 'mapping' command in the m65dbg tool, showing the active memory mappings for $D030, MAP, and $01 registers. This helps in understanding the current memory configuration.

```plaintext
<dbg>mapping  $D030 register (highest priority) ============== - $C000 <-- $2,C000 (C65 DOS chunk 3 + C65 KERNAL chunk 1 + CHARSET-C) - Selected C65 charset(?)
"MAP" mechanism (lower priority) =============== MAPL ---- - $2000 <-- $3,2000 (C65 BASIC chunk 1) - $4000 <-- $3,4000 (C65 BASIC chunk 2) - $6000 <-- $3,6000 (C65 BASIC chunk 3)
MAPH ---- - $8000 <-- $3,8000 (C65 BASIC chunk 4) - $A000 <-- $3,A000 (C65 BASIC chunk 5) - $E000 <-- $3,E000 (C65 EDITOR + C65 KERNAL chunk 3)
$01 register (lowest priority) =========== - $A000 <-- $2,A000 (C64 BASIC) - $E000 <-- $2,E000 (C64 KERNAL)
```

--------------------------------

### Use mega65_ftp for File Transfer

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Use the -e parameter to enable Ethernet mode for mega65_ftp. Commands like 'put', 'get', and 'help' can be used interactively or directly on the command line for scripting.

```shell
mega65_ftp -e
```

```shell
mega65_ftp -e -c "put myimage.d81" -c "quit"
```

--------------------------------

### Example Fix Commit Message

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/219185209/Commit%2Bmessage%2Bformat

Demonstrates a commit message for fixing a bug, including the type, scope, issue number, and a brief explanation.

```git
fix(viciv.vhdl): some pixel did not show #123 The render pipeline did skip some pixels. Fixed it.
```

--------------------------------

### Start machine language program with specified load address

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Execute a machine language program where the loading address differs from the jump address. The `-b` parameter specifies where the file is loaded, and `-j` specifies where execution begins.

```bash
etherload -b 8000 -j 8000 <file.prg>
```

--------------------------------

### BASIC Get Screen and Color Memory Base Address

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5603329/Transitioning%2Bprograms%2Bto%2Buse%2BROM%2B920373

This BASIC code retrieves the base addresses for screen memory and color memory. This method is compatible with both old and new ROM versions.

```BASIC
10 TR=WPEEK($D060) + WPEEK($D062) *65536  : REM SCREEN MEMORY BASE 20 CR=$FF80000 + WPEEK($D064) : REM COLOUR MEMORY BASE
```

--------------------------------

### MEGA65 Cartridge Identification and Vectors

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/36962324/MEGA65%2BStyle%2BCartridge%2BWork%2Bin%2BProgress

Defines the memory layout for cartridge identification and startup vectors in MEGA65 systems. The 'm65' magic string and jump vectors for cold and warm starts are specified.

```assembly
        * = $8000
cartVectors:
        jmp coldStart       // cold-start vector
        jmp warmStart       // warm-start vector
cartFlags:
        .byte %00000001     // flags, bit 0 = 1 to auto-start
cartMagic:
        .byte $4D,$36,$35   // "m65" string
```

--------------------------------

### Assembly for MEGA65 MAP Instruction

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/33259521/Memory%2BMapping

Example assembly code to set the MAPH and MAPL registers for specific memory mapping. Ensure registers X, A, Y, and Z are loaded with the desired values before executing the MAP instruction.

```assembly
; prepare MAPL
LDX #$00
LDA #$E3
; prepare MAPH
LDY #$00
LDZ #$B3
; perform the mapping
MAP
NOP
```

--------------------------------

### Define memory segments for HYPPO mode

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/34111489/HYPPO%2Bmode%2Bprograms

Defines memory segments, including ZP, LOADADDR, HEADER, CODE, and BSS, with specific start addresses and sizes relative to HYPPO and HIMEM. Avoids a MAIN area to use custom symbols.

```config
MEMORY {
    ZP:       file = "", define = yes,               start = $0002,  size = $001A;
    LOADADDR: file = %O,               start = %S - 2,          size = $0002;
    HEADER:   file = %O, define = yes,               start = %S,              size = $000D;
    CODE:     file = %O,               start = __HEADER_LAST__, size = __HYPPO__ - __HEADER_LAST__;
    BSS:      file = "",               start = __HYPPOEND__,
               size = __HIMEM__ - __HYPPOEND__ - __STACKSIZE__ - 1;
}
```

--------------------------------

### Define cc65 symbols for memory management

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/34111489/HYPPO%2Bmode%2Bprograms

Defines symbols for memory areas, including program start, stack size, HYPPO region, and high memory. Ensures stack symbols add up to $CFFF for C64 mode.

```config
SYMBOLS {
    __LOADADDR__:   type = import;
    __EXEHDR__:     type = import;
    __PRGSTART__:   type = weak, value = $0801;
    __STACKSIZE__:  type = weak, value = $400;
    __HYPPO__:      type = weak, value = $8000; # HYPPO uses $8000-$BFFF
    __HYPPOEND__:   type = weak, value = $C000;
    __HIMEM__:      type = weak, value = $D000;
    __MAIN_START__: type = weak, value = $0801;
    __MAIN_SIZE__:  type = weak, value = $c7fe;
}
```

--------------------------------

### Create initial changelog

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Initializes a changelog file for the new package. Ensure to use a valid email address for the maintainer.

```bash
dch --create -v1.0.24-1 --package libusb-mingw-w64
```

--------------------------------

### Running Hyppotest

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5373953/hyppotest

To run the Hyppotest tool, provide the name of a test script as a command-line argument. An optional second argument can specify a single test within the script to execute.

```bash
./hyppotest hyppotest-self.test
```

```bash
./hyppotest hyppotest-opcodes.test "test name"
```

--------------------------------

### Hyppotest Build Command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5373953/hyppotest

Build the hyppotest tool from the base of the mega65-core repository using the make command.

```bash
make src/tools/hyppotest
```

--------------------------------

### Initialize mega65_ftp for Ethernet

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/edit-v2/29327361

Use the `-e` parameter to enable Ethernet communication with the MEGA65 for file transfers.

```bash
mega65_ftp -e
```

--------------------------------

### Etherload with Direct Interface

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Launch etherload by directly providing the IPv6 address and interface identifier to bypass auto-discovery and speed up startup. Replace <file.prg> with your program file.

```bash
etherload -i fe80::d5ff:fe16:0%eth0 -r <file.prg>
```

--------------------------------

### Push upgrade0.prg via m65 (Path 1)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/30932993/Old%2BSlot%2B0%2BFlashing%2Bprocess%2Bpre%2BRelease%2B0.96

Use this command to push the upgrade0.prg file for upgrading Slot 0 only. Ensure the .cor file is renamed and copied to the SD card.

```bash
m65 --device COM7 --c64mode --run upgrade0.prg
```

--------------------------------

### Download and Upload Freeze Slots with mega65_ftp

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/166985770/System%2BPartition%2Bdetails

Demonstrates the workflow for downloading a freeze slot to a local file and then uploading it to a different slot. This can be used for backup or transferring states between slots.

```bash
getslot 1 slot1.bin
```

```bash
putslot 10 slot1.bin
```

--------------------------------

### Load Slides File in MegaWAT!?

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/35979266/MegaWAT

Steps to load a slides file into MegaWAT!? after it has been run.

```bash
MEGA+O
```

--------------------------------

### Mount and Run MegaWAT!? on MEGA65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/35979266/MegaWAT

Instructions for mounting the MegaWAT disk image and running the presentation tool on a real MEGA65.

```bash
MOUNT "MEGAWAT.D81" GO64 LOAD "PART2" RUN
```

--------------------------------

### Run Xemu with UART Monitor and Disk Mounted

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/35979266/MegaWAT

Command to launch Xemu with the UART monitor enabled and the MegaWAT.D81 disk image mounted. This is recommended for debugging and development.

```bash
./xmega65.native -uartmon :4510 -8 /path/to/MEGAWAT.D81
```

--------------------------------

### Display and Move Sprite in BASIC 65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11763713/Dabbling%2Bwith%2Bsprites%2Bin%2BBASIC%2Band%2Bthe%2BSprite%2BEditor

Commands to turn a sprite on and position it on the screen using BASIC 65.

```BASIC
SPRITE 0,1
MOVSPR 0,100,100
```

--------------------------------

### Copy debian/source/format file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Copies the debian/source/format file from an existing source to the new package's debian directory.

```bash
mkdir debian/source
cp ../libz-mingw-w64-1.2.11+dfsg/debian/source/format debian/source/
```

--------------------------------

### Push mflash200.prg via m65 (Path 2)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/30932993/Old%2BSlot%2B0%2BFlashing%2Bprocess%2Bpre%2BRelease%2B0.96

Use this command to push the mflash200.prg file for upgrading any slot. This is part of Path 2 in the flashing process.

```bash
m65 --device COM7 --c64mode --run mflash200.prg
```

--------------------------------

### Load and run custom ROM file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Upload a custom ROM file to the MEGA65's memory and reset into it. This allows for quick testing of different ROM revisions without SD card uploads.

```bash
etherload -R 920384.ROM
```

--------------------------------

### Send mflash.prg via etherload command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/177209351/MEGAFLASH%2BTesting

Use the etherload command-line tool to send the mflash.prg file to your MEGA65 system. Ensure QSPI access is enabled via DIP switch #3.

```bash
etherload -r -t mega65r6-782mfl-24-fb7e8f0/flasher/mflash.prg
```

--------------------------------

### Retrieve libz source package

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Fetches the source code and packaging information for the libz-mingw-w64 package. This serves as a template for other packages.

```bash
mkdir libz
cd libz
apt source libz-mingw-w64
```

--------------------------------

### Low-level format with HEADER command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/21233665/Tips%2Bon%2Bformatting%2Bfloppy%2Bdisks

Use this command for low-level formatting of non-CBM disks, especially when encountering read errors. Append ',I42' to the HEADER command.

```BASIC
HEADER "name",I42
```

--------------------------------

### Save and Load Sprites in BASIC 65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11763713/Dabbling%2Bwith%2Bsprites%2Bin%2BBASIC%2Band%2Bthe%2BSprite%2BEditor

BASIC 65 commands for saving created sprites to a file and loading them back.

```BASIC
SPRITE SAVE "MYSPRITES"
SPRITE LOAD "MYSPRITES"
```

--------------------------------

### Inspect System Partition Sector with mega65_ftp

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/166985770/System%2BPartition%2Bdetails

Use the `sector` command in `mega65_ftp` to view the contents of a specific sector. This is useful for examining header information or identifying signatures.

```bash
sector 26921982
```

--------------------------------

### Run PRG file in C64 or MEGA65 mode

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361/Ethernet%2Btools%2Bmega65_ftp%2Band%2Betherload

Use this command to run a PRG file. etherload automatically detects the mode and resets the system before execution. Requires the D81 image to be on the SD card if specified.

```bash
etherload -r <file.prg>
```

```bash
etherload -m MYIMAGE.D81 -r <file.prg>
```

--------------------------------

### Build the package

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Command to build the Debian package using debuild. Use the -us and -uc flags to skip signing the source and changes files.

```bash
debuild -us -uc
```

--------------------------------

### Copy Fontpack to Xemu's SD Card using mega65_ftp

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/35979266/MegaWAT

Command to transfer the DEFAULTP.FPK fontpack file to Xemu's SD card image using the mega65_ftp utility.

```bash
mega65_ftp -l tcp -c "put DEFAULTP.FPK" -c "quit"
```

--------------------------------

### Enter Slides Filename in MegaWAT!?

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/35979266/MegaWAT

How to specify the slides filename (e.g., SLIDES1 or SLIDES2) when prompted by MegaWAT!?. Pressing the return key confirms the input.

```bash
SLIDES1
```

```bash
SLIDES2
```

--------------------------------

### Send mflash.prg via m65 command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/177209351/MEGAFLASH%2BTesting

Use the m65 command-line tool to send the mflash.prg file to your MEGA65 system. Ensure QSPI access is enabled via DIP switch #3.

```bash
m65 -4 -r mega65r6-782mfl-24-fb7e8f0/flasher/mflash.prg
```

--------------------------------

### Configure Sprite Bank and Pointers in BASIC

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/21889040/How%2Bto%2Bretrieve%2Bsprite%2Bdata%2Bfrom%2BBANK4

Use these BASIC commands to enforce sprites into BANK4 and enable the SPRPTR16 bit. The `+128` value specifically turns on bit7 (SPRPTR16).

```BASIC
#declare SPRPTRBNK = $d06e
#declare SPRPTRADR = $d06c

' enforce sprites into BANK4 and SPRPTR16 bit turned on
poke SPRPTRBNK, 4+128
wpoke SPRPTRADR, 0
```

--------------------------------

### MEGA65 Config Sector Poke Commands

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/22380545/Magic%2Bpokes%2Binto%2Bthe%2Bconfig%2Bsector%2Bvia%2Bmega65_ftp

Use these commands with `mega65_ftp` to directly alter configuration settings stored in sector 1. The format is `poke <sector> <offset> <value>`.

```bash
poke 1 33 0
```

```bash
poke 1 33 32
```

```bash
poke 1 2 128
```

```bash
poke 1 2 0
```

```bash
poke 1 $0f $80
```

```bash
poke 1 $0f $00
```

--------------------------------

### Dump Full SD Card Partition with dd

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/6258696/Dumping%2Band%2Brestoring%2Bsd-card%2Bcontents

Use this command to create a full backup image of the first partition of an SD card. Ensure the target file has enough space.

```bash
dd if=/dev/sdb1 of=sdcard_partition1.bin bs=1M
```

--------------------------------

### Use etherload for Direct Program Execution

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Ensure Ethernet remote control is active (Shift-£, LED blinking green/yellow) before using etherload to upload and execute programs directly into MEGA65 RAM.

```shell
Shift-£
```

--------------------------------

### Enable Joystick Expander on MEGA65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/7012353/Super%2Bsimple%2BProtovision-compatible%2BJoystick%2BExpander%2Bfor%2BMEGA65

Use this POKE command to enable the joystick expander if it is disabled by default in the current bitstream. This is necessary for the expander to function.

```BASIC
POKE $7010001, 14
```

--------------------------------

### Mount D81 disk image via Xemu command line

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/12648455/Curious%2Babout%2Bthe%2BMEGA65%2BWant%2Bto%2Btry%2Bthe%2Bemulator

Use this command to mount a D81 disk image when using the HDOS virtualisation option in Xemu. After mounting, you can use DIR to view contents, SHIFT+RUN-STOP to load the first file, BOOT to run AUTOBOOT.C65, or navigate and load PRG files.

```bash
MOUNT "MYDISK.D81"
```

--------------------------------

### Map cc65 generated sections to memory segments

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/34111489/HYPPO%2Bmode%2Bprograms

Maps cc65's generated sections like ZEROPAGE, LOADADDR, EXEHDR, STARTUP, CODE, RODATA, DATA, INIT, ONCE, and BSS to the defined MEMORY segments. Replaces MAIN with CODE for HYPPO mode.

```config
SEGMENTS {
    ZEROPAGE: load = ZP,       type = zp;
    LOADADDR: load = LOADADDR, type = ro;
    EXEHDR:   load = HEADER,   type = ro;
    STARTUP:  load = CODE,     type = ro;
    LOWCODE:  load = CODE,     type = ro,  optional = yes;
    CODE:     load = CODE,     type = ro;
    RODATA:   load = CODE,     type = ro;
    DATA:     load = CODE,     type = rw;
    INIT:     load = CODE,     type = rw;
    ONCE:     load = CODE,     type = ro,  define   = yes;
    BSS:      load = BSS,      type = bss, define   = yes;
}
```

--------------------------------

### Upload Multiple Memory Segments with etherload

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/edit-v2/29327361

Use the `--halt` parameter for consecutive `etherload` calls to load multiple data files into memory before executing the main program. The last call should not use `--halt` if execution is intended.

```bash
etherload --halt gfx.dat
etherload --halt music.dat
etherload -j 2016 game.prg
```

--------------------------------

### Execute mega65_ftp Commands via Command Line

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/edit-v2/29327361

Provide commands directly on the command line using the `-c` option for scripting or automated tasks. The `quit` command is used to exit the tool.

```bash
mega65_ftp -e -c "put myimage.d81" -c "quit"
```

--------------------------------

### KiDra's Alternate HD disk formatting approach

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/21233665/Tips%2Bon%2Bformatting%2Bfloppy%2Bdisks

This method uses the Floppy tool in HD mode for wiping, then switches to DD mode for formatting and testing. It ensures the drive operates correctly for both modes.

```BASIC
3. Test formatting of DD disk
```

```BASIC
2. Test all sectors on DD disk
```

--------------------------------

### Copy debian compat file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Copies the debian/compat file from the libz package. This file specifies the debhelper compatibility level.

```bash
cp ../libz-mingw-w64-1.2.11+dfsg/debian/compat debian/
```

--------------------------------

### Push Bitstream with m65 (Soft-Brick Recovery)

Source: https://mega65.atlassian.net/l/cp/UsC119bL

Use this command with the m65 tool to push a bitstream to the MEGA65 during soft-brick recovery when using the 683-cartflash core. Ensure the `<NO SCROLL>` option is active.

```bash
m65 --bitonly mega65r3.bit
```

--------------------------------

### Set and Display Internal Signals with 'J' Command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/3178497/UART%2BMonitor%2BStudies

Use the 'J xx' command, where 'xx' is a hexadecimal byte value, to set the 'mon_trace' variable and then display the current values of 'mon_trace_step' and 'mon_trace'. This allows for direct manipulation of trace mode settings.

```assembly
J 00
```

```assembly
J 11
```

--------------------------------

### Dump Partial SD Card Partition with dd

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/6258696/Dumping%2Band%2Brestoring%2Bsd-card%2Bcontents

Use this command to create a backup image of a specific portion (e.g., 1GB) of the first partition. This is useful if the SD card is large and not full.

```bash
dd if=/dev/sdb1 of=sdcard_partition1.bin bs=1M size=1G
```

--------------------------------

### Display Internal Signals with 'J' Command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/3178497/UART%2BMonitor%2BStudies

Use the 'J' command without parameters to display the current values of 'mon_trace_step' and 'mon_trace' as two hexadecimal bytes. This is useful for checking the state of internal monitor signals.

```assembly
J
```

--------------------------------

### Include binaries in debian/source/include-binaries

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Specifies binary files to be included in the .deb package, particularly useful when files are not in standard library locations.

```text
debian/libusb-mingw-w64/usr/x86_64-w64-mingw32/bin/libusb-1.0.dll
debian/libusb-mingw-w64/usr/i686-w64-mingw32/bin/libusb-1.0.dll
```

--------------------------------

### Load program with offset

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Load a program file into memory, skipping a specified number of initial bytes. This is useful when the program file contains a header or metadata that should not be loaded into the target memory address.

```bash
etherload -j 2100 --offset ff game.prg
```

--------------------------------

### Run PRG file via Xemu command line

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/12648455/Curious%2Babout%2Bthe%2BMEGA65%2BWant%2Bto%2Btry%2Bthe%2Bemulator

Use this command to run a PRG file when using the HDOS virtualisation option in Xemu.

```bash
DLOAD "FILE.PRG",U12
```

--------------------------------

### Copy debian copyright file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Copies the debian/copyright file from the libz package. This file contains copyright and licensing information.

```bash
cp ../libz-mingw-w64-1.2.11+dfsg/debian/copyright debian/
```

--------------------------------

### Change BASIC Text Color

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use the COLOR command to set the palette entry for text output.

```basic
COLOR 3
```

--------------------------------

### Copy debian rules file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Copies the debian/rules file from the libz package into the libusb package directory. This file contains build instructions and may require significant modification.

```bash
cd libusb-mingw-w64-1.0.24
mkdir debian
cp ../libz-mingw-w64-1.2.11+dfsg/debian/rules debian/
```

--------------------------------

### Send PRG with m65 (Soft-Brick Recovery)

Source: https://mega65.atlassian.net/l/cp/UsC119bL

This command sends the 'upgrade0.prg' file to the MEGA65 using the m65 tool, as part of the soft-brick recovery procedure involving DIP switch #3. This can also be achieved using 'ethload'.

```bash
m65 -4 -r upgrade0.prg
```

--------------------------------

### Rust Implementation: Eleven Interpreter

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/31948801

This GitHub repository contains an implementation of the Eleven interpreter in Rust, showcasing Rust porting efforts for the MEGA65 environment.

```rust
GitHub - mlund/eleven: Eleven interpreter implemented in Rust
```

--------------------------------

### Reset MEGA65 via m65dbg

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/26902533/remote%2Btyping%2Bon%2Bthe%2BMEGA65

Remotely restart the MEGA65 by typing '!' at the `m65dbg` prompt.

```bash
!
```

--------------------------------

### Push BIT file via JTAG to MEGA65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/8716289/Release%2Bverification%2B0.95%2Bbatch%2B2%2Binstructions%2Band%2Btips

Use the m65 tool to push a BIT file to the MEGA65 via JTAG. This is a prerequisite for loading jtagflash.prg.

```bash
m65 --bitonly mega65-reltest/mega65r3-2022XXYY.ZZ-abcdefg-89fdecb.bit
```

--------------------------------

### Git Command for Diffing

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/2981895/Diff%2Bing%2B.D81%2Bfiles

Use this command to initiate a diff operation on a .d81 file using your configured difftool, which in this case is Beyond Compare.

```bash
git difftool MEGA65.D81
```

--------------------------------

### Discover MEGA65 Network Address

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Use etherload with the --discover flag to find the MEGA65's IP address and interface identifier. This is useful for manual configuration.

```bash
etherload --discover  MEGA65 found at fe80::d5ff:fe16:0%eth0
```

--------------------------------

### Send PRG with etherload (Ethernet Recovery)

Source: https://mega65.atlassian.net/l/cp/UsC119bL

Use this command to send a PRG file to the MEGA65 via Ethernet using the 'etherload' tool. Replace '192.168.1.255' with your network's broadcast address. Ensure DIP switch #2 is enabled and both devices are on the same LAN.

```bash
etherload -i 192.168.1.255 -4 -r upgrade0.prg
```

--------------------------------

### Restore SD Card Partition with dd

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/6258696/Dumping%2Band%2Brestoring%2Bsd-card%2Bcontents

Use this command to copy a previously created backup image onto the first partition of an SD card. It is recommended to back up the existing partition before performing this operation.

```bash
dd if=sdcard_partition1.bin of=/dev/sdb1 bs=1M
```

--------------------------------

### BASIC Array Access for Screen Memory

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5603329/Transitioning%2Bprograms%2Bto%2Buse%2BROM%2B920373

Use T@& for writing characters to the screen and C@& for setting character colors in BASIC. These arrays provide a safer alternative to direct PEEK/POKE operations.

```BASIC
T@&(5,0) = 1
```

```BASIC
C@&(5,0) = 2
```

```BASIC
PRINT T@&(0,0)
```

```BASIC
PRINT C@&(0,0)
```

--------------------------------

### Push BIT file via JTAG

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/346882049/Release%2Bverification%2B0.97%2B10th%2BAnniversary%2BEdition

Use this command to push a BIT file to your MEGA65 via JTAG. Ensure you replace 'mega65rX-XXX-YYY.bit' with the actual filename.

```bash
m65 -q mega65rX-XXX-YYY.bit
```

--------------------------------

### Convert ASCII to MEGA65 BASIC PRG

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/27492353/Using%2Bpetcat%2Bfor%2Bcross-developing%2BBASIC%2Bprograms

Use this command to convert an ASCII text file containing BASIC code into a MEGA65 PRG file. The -w65 flag specifies the target system, -o sets the output filename, and the final argument is the input ASCII file.

```bash
petcat -w65 -o tempconv.prg -- tempconv.bas
```

--------------------------------

### Copy debian control file

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Copies the debian/control file from the libz package. This file describes the package, its dependencies, and maintainer information. Update details to reflect libusb.

```bash
cp ../libz-mingw-w64-1.2.11+dfsg/debian/control debian/
```

--------------------------------

### MEGA65 UART Monitor Architecture

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/3178497/UART%2BMonitor%2BStudies

This ASCII diagram illustrates the main components of the MEGA65 UART monitor, showing the interaction between machine.vhdl, monitor_top.v (uart_monitor), monitor_ctrl, monitor_bus, monitor_mem, and various RAM components like historyram0/1 and cpustateram. It also depicts the connection to the cpu6502.

```text
+--------------------------------------------------------------------------------------------+
|                                         machine.vhdl                                             |
|                                                                                              |
|   +------------------------------------------------------------------------------------+   |
|   |                            monitor_top.v = uart_monitor                                |
|   |                                                                                    |
|   |       +--------------+                                                               |
|   |       | monitor_ctrl |                                                               |
|   |       +--------------+                                                               |
|   |                                                                                    |
|   |       +--------------+                                                               |
|   |       |  monitor_bus |                                                               |
|   |       +--------------+                                                               |
|   |                          1024 x 16 bytes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        1024 x 8 bytes      16 x 8 bytes       |   |       +--------------+  +---------------+  +---------------+  +--------------+     |   |       |  monitor_mem |  | asym_ram_sdp  |  | asym_ram_sdp  |  | asym_ram_sdp |     |   |       | (monitor.a65)|  | (historyram0) |  | (historyram1) |  | (cpustateram)|     |   |       +--------------+  +---------------+  +---------------+  +--------------+     |   |                                                                                    |   |       +--------------+                                                             |   |       |   cpu6502    |                                                             |   |       +--------------+                                                             |   |                                                                                    |   +------------------------------------------------------------------------------------+   |                                                                                              |
+--------------------------------------------------------------------------------------------+
```

--------------------------------

### Convert MEGA65 BASIC PRG to ASCII

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/27492353/Using%2Bpetcat%2Bfor%2Bcross-developing%2BBASIC%2Bprograms

Use this command to convert a MEGA65 BASIC PRG file back into an ASCII text file. The -65 flag indicates the source system, and -o specifies the output ASCII filename.

```bash
petcat -65 -o myprog.bas -- myprog.prg
```

--------------------------------

### Send Command with Carriage Return using m65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/26902533/remote%2Btyping%2Bon%2Bthe%2BMEGA65

Use the `-T` argument with `m65` to send a command followed by a carriage return. This is useful for scripting full commands.

```bash
m65 -l /dev/ttyS6 -T 'print "hello world"'
```

```bash
m65 -l COM7 -T "print \"hello world\""
```

--------------------------------

### UART Monitor 'Peek' Command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/28344336/FCM%2BInsights%2Band%2BExperimentation

Use the 'm' command in the UART monitor to read a byte from a specified memory address.

```bash
m<addr>
```

--------------------------------

### Run jtagflash.prg in C64 mode

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/8716289/Release%2Bverification%2B0.95%2Bbatch%2B2%2Binstructions%2Band%2Btips

Use the m65 tool to run jtagflash.prg in C64 mode. You must specify the device as autodiscovery will reset the JTAG. This program is used to flash the COR file from the SD card.

```bash
m65 --device <YOURDEV> --c64mode --run jtagflash.prg
```

--------------------------------

### Switch to Alternate Palette (PETSCII)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use PETSCII code \x01 (decimal 1) to switch to the alternate color palette.

```petscii
\x01
```

--------------------------------

### Select White Color (PETSCII)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use PETSCII code \x05 (decimal 5) to select white from the default palette.

```petscii
\x05
```

--------------------------------

### Call KERNAL key Routine

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/44204033/New%2Bkeyboard%2Bscanner%2Bv0.96%2Bfeature%2Bcandidate

If the KERNAL IRQ is disabled, this routine at $ffdf must be called to perform keyboard scanning. It ensures keys are processed even without the standard IRQ.

```assembly
jsr $ffdf
```

--------------------------------

### Change Bitmap Graphics Color

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use the PEN command to set the palette entry for bitmap graphics.

```basic
PEN 3
```

--------------------------------

### Hyppotest Test Directives

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/5373953/hyppotest

These are new directives for use within hyppotest test files to control test execution and assertions.

```plaintext
allow stack <overflow | underflow>
```

```plaintext
assemble [at <address|symbol>] with acme
```

```plaintext
check regs
```

```plaintext
check <mem | memory>
```

```plaintext
clear all breakpoints
```

```plaintext
clear breakpoint (address|symbol)
```

```plaintext
clear flag flag
```

```plaintext
define name as value
```

```plaintext
end assemble
```

```plaintext
end test
```

```plaintext
expect flag flag is <clear | set>
```

```plaintext
forbid stack <overflow | underflow>
```

```plaintext
let reg = value
```

```plaintext
poke <address|symbol>, value[, value… ]
```

```plaintext
ignore reg name
```

```plaintext
ignore all regs
```

```plaintext
run until <brk | jsr>
```

```plaintext
set flag flag
```

```plaintext
step [count]
```

--------------------------------

### Switch to Default Palette (PETSCII)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use PETSCII code \x04 (decimal 4) to switch back to the default color palette.

```petscii
\x04
```

--------------------------------

### Activate MEGA65 Ethernet Remote Control

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/29327361

Press SHIFT and £ to enable Ethernet remote control. The power LED blinking green/yellow indicates successful activation. This feature must be re-enabled after a reset or power-off.

```shell
SHIFT + £
```

--------------------------------

### Send Special Key Press (RUN-STOP) with m65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/26902533/remote%2Btyping%2Bon%2Bthe%2BMEGA65

Use the `-t` argument with `m65` and a tilde escape character for special key presses like RUN-STOP. The `~C` sequence sends RUN-STOP.

```bash
m65 -l COM7 -t ~C
```

--------------------------------

### UART Monitor 'Poke' Command

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/28344336/FCM%2BInsights%2Band%2BExperimentation

Use the 's' command in the UART monitor to write one or more bytes to successive memory addresses. Multiple values can be provided for sequential writes.

```bash
s<addr> <val1> [<val2> <val3> ...]
```

--------------------------------

### Push Bitstream via m65

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/30932993/Old%2BSlot%2B0%2BFlashing%2Bprocess%2Bpre%2BRelease%2B0.96

Temporarily upload a specific bitstream using the m65 tool. This command is necessary when using Lydon's 683-cartflash bitstream.

```bash
m65 --bitonly mega65r3-20230507.11-683-ca-cbe9bc9.bit
```

--------------------------------

### Call KERNAL getin Routine

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/44204033/New%2Bkeyboard%2Bscanner%2Bv0.96%2Bfeature%2Bcandidate

Call the KERNAL routine at $ffe4 to retrieve a character from the keyboard buffer. This is used by programs to detect key presses.

```assembly
jsr $ffe4
```

--------------------------------

### Download libusb upstream tarball

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/11304961/Creating%2Blibusb%2Blibpng%2B.deb%2Bpackages

Downloads the source code for libusb version 1.0.24 from its GitHub repository.

```bash
wget https://github.com/libusb/libusb/archive/refs/tags/v1.0.24.tar.gz
```

--------------------------------

### Select Blue Color (PETSCII)

Source: https://mega65.atlassian.net/wiki/spaces/MEGA65/pages/4685825/Default%2Bcolor%2Bpalette

Use PETSCII code \x1f (decimal 31) to select blue from the default palette.

```petscii
\x1f
```
Tokens:
Raw