2

Home

appelbaum edited this page 2017-01-06 23:58:29 -08:00

Table of Contents

• Welcome to the BashBunny cherry-os wiki!
• How to recover:
• How to upgrade firmware:
• Special notes for upgrade:
• Important notes about USB and its driver:
• How to use BashBunny:

Welcome to the BashBunny cherry-os wiki!

How to recover:

• Plug BashBunny to USB host, after green led goes off, unplug BashBunny.
• Repeat above for 3 times to simulate 3-times booting fail and trigger recover process.
• Re-plug BashBunny to start recover, red LED blinks.
• Recover process takes roughly 3 minutes.

How to upgrade firmware:

• Put switch to position 3 (position close to USB connector), plug BashBunny to PC, BashBunny enters maintenance mode with USB serial + mass storage.
• Copy firmware upgrade package (e.g. ch_fw_1.2_95.tar.gz >180MB) to BashBunny via mass storage
• IMPORTANT: Eject BashBunny.
• Unplug and re-plug BashBunny to start firmware upgrade, red LED blinks.

Special notes for upgrade:

• Upgrade process does not update boot0, u-boot, sys_config, and partition tables

Important notes about USB and its driver:

• BashBunny is a USB composite device, it can support below modes:
  • HID only
  • HID + STORAGE
  • HID + ETHERNET
  • HID + ETHERNET + STORAGE
  • SERIAL + STORAGE (for maintenance mode)
• As for ETHERNET, BashBunny supports RNDIS for Windows USB host (specified in payload.txt by ATTACKMODE WIN ETHERNET), and supports CDC ECM for Mac/Linux USB host.
• VID/PID = 0xF000/0xFFF0 for maintenance mode (usb serial + mass storage):
• VID/PID = 0x0525/0xa4a2 for Windows RNDIS (this is donated by NetChip to Linux kernel)
  ** ATTACKMODE WIN HID ETHERNET
  ** ATTACKMODE WIN HID ETHERNET STORAGE
• VID/PID = 0x0525/0xa4a1 for the rest of working modes (this is donated by NetChip to Linux kernel)
  ** ATTACKMODE HID
  ** ATTACKMODE HID STORAGE
  ** ATTACKMODE HID ETHETNET
  ** ATTACKMODE HID ETHETNET STORAGE
• For the advanced attack mode (like HID ETHETNET STORAGE), as USB Host may take time to install composite device driver and respective USB class driver, payload.txt may not work the first time BashBunny is connected. Please unplug and replug BashBunny.
• Please check Windows Device Manager if BashBunny does not work as expected.

How to use BashBunny:

• There are 3 positions of the switch:
  ** Position 3: near end to USB connector, maintenance mode (usb serial + mass storage)
  ** Position 2: middle position, BashBunny runs payloads/switch2/payload.txt if it exists. If it does not exist, BashBunny enters maintenance mode.
  ** Position 1: far end to USB connector, similar to position 2, BashBunny runs payloads/switch1/payload.txt if it exists. If it does not exist, BashBunny enters maintenance mode.

• How to use maintenance mode (usb serial):
  ** On Windows 10, there is no need to install driver for usb serial.
  ** On Windows 8.1 and Windows 7, need to install driver for usb serial with INF file preloaded in BashBunny mass storage (linux-cdc-acm.inf). We still use this filename linux-cdc-acm.inf because BashBunny uses Debian Linux inside and it is CDC ACM for usb serial in its kernel.
  ** Use Tera Term or PuTTY on Windows to access usb serial.
  ** Use Windows Device Manager to check.

• How to install RNDIS driver on Windows:
  ** To be illustrated.
  ** This is needed for "ATTACKMODE WIN HID ETHERNET"

• USB Ethernet on Mac or Linux:
  ** BashBunny supports CDC ECM (USB Communication Device Class - Ethernet Control Model), it is natively supported by Mac and Linux. There is no need to install driver.

• About DHCP server inside BashBunny for USB Ethernet:
  ** To be illustrated.