USB Serial Console

The PortaPack Mayhem firmware exposes a serial console via USB when connected to a computer.

Any serial terminal client can be used to connect like PuTTY, minicom, screen, HTerm. There are even web based ones (Chrome&Edge, no Firefox): https://www.serialterminal.com/ or https://hackrf.app/

The terminal exposes the ChibiOS/RT Shell:

Available Commands

• help: lists all available commands.

  

• info: shows the ChibiOS/RT system details.

• systime: shows the uptime in ms.

• reboot: reboots the PortaPack. This will also work on devices where the reset button is not working.

• dfu: reboots the PortaPack into DFU firmware upgrade mode.

• hackrf: Starts the original HackHF firmware to use the PortaPack as HackHF.

• sd_over_usb: Starts the SD Over USB mode.

• flash: This is the Flash Utility.

• screenshot: Takes a screenshot.

  

• write_memory: Writes arbitrary memory locations.

  

• read_memory: Reads arbitrary memory locations.

• button: Simulates a button press

  • button 1: Right
  • button 2: Left
  • button 3: Down
  • button 4: Up
  • button 5: Select/Enter
  • button 6: DFU
  • button 7: Rotary Left
  • button 8: Rotary Right

• ls: Lists files and directories.

• mkdir: Creates a directory.

• unlink: Deletes a file.

• fopen: Opens a file for reading and modification.

Note

The current position will be set to the end of the file. Use fseek 0 to move to the start of the file.

• fseek: Sets the current position inside the currently opened file.
• fclose: Closes the currently opened file.
• ftruncate: removes all content in the file behind the current position.
• ftell: shows the current position is the file.
• fread: Reads n bytes from the currently opened file.

Tip

there is a faster binary read option: frb

• fwrite: Writes bytes from the currently opened file.

Tip

there is a faster binary write option: frw