Skip to content

Arduino Scripts for our Digispark Attiny85 programmable USBs.

License

Notifications You must be signed in to change notification settings

byui-soc/bad-usb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BadUSB

Arduino Scripts for our Digispark Attiny85 programmable USBs.

Feel free to add your own and make the existing scripts better. You can download this repo as a zip or use git clone https://github.com/byui-csa/bad-usb.

Development Environment

This video by The Cyber Mentor does an excellent job detailing the setup. Follow his video and this guide and everything should work correctly.

Use and install Arduino IDE 1.8.19. To install on Linux follow the specific instructions below. Once installed, open Arduino IDE.

Set the Board Manager URL by going to File > Preferences > Additional Board Manager URLs. Use the the updated Board Manager URL below. The video's Board Manager URL provides 5 year old packages, which can causes issues (specifically on Linux).

https://raw.githubusercontent.com/ArminJo/DigistumpArduino/master/package_digistump_index.json

Add ATTiny support by going to Tools > Board > Boards Manager and searching for Digistump AVR Boards. Install the latest version. Once completed, close the popup.

Select board by going to Tools > Board > Digistump AVR > Digispark. Select Programmer by going to Tools > Programmer > micronucleus.2.5.

You should now be able to upload scripts. To upload scripts you must first press the upload button and then plug in the USB.

Windows

Sometimes the drivers are automatically installed and sometimes they are not. To manually install drivers on Windows download Digistump.Drivers.zip, extract all files, then run Install Drivers.exe.

Linux

To properly install Arduino IDE 1.8.19, download arduino-1.8.19-linux64.tar.xz (recommended to ~/.config), extract it, then run install.sh (creates desktop launcher) and arduino-linux-setup.sh (adds necessary groups and sets up Arduino udev rules). Feel free to use the commands below to do this automatically.

cd ~/.local/share/
wget https://downloads.arduino.cc/arduino-1.8.19-linux64.tar.xz
tar -xvf arduino-1.8.19-linux64.tar.xz
rm arduino-1.8.19-linux64.tar.xz
cd arduino-1.8.19
sudo ./install.sh
./arduino-linux-setup.sh $USER

Lasly, you need to add the micronuclus udev rules. Download 49-micronucleus.rules and place the file in /etc/udev/rules.d/. Feel free to use the command below to do this automatically.

sudo wget \
https://raw.githubusercontent.com/byui-csa/bad-usb/main/49-micronucleus.rules \
-O /etc/udev/rules.d/49-micronucleus.rules

You will need to restart your system at this point. If you see errors such as Unknown Device/Micronucleus Version when uploading scripts then make sure that you're using the updated Board Manager URL from above and the latest version of Digistump AVR Boards.

Repos

If you want to win, win. -Uplandwave

About

Arduino Scripts for our Digispark Attiny85 programmable USBs.

Resources

License

Stars

Watchers

Forks

Languages