Adafruit - Arduino-IDE-setup Win 8 & 10

8/20/2019 Adafruit - Arduino-IDE-setup Win 8 & 10

1/41

Adafruit Arduino IDE SetupCreated by Tony DiCola

Last updated on 2015-08-25 02:00:25 PM EDT


2/41

2

3

4

48

9

12

12

1313

13

1416

18

20

20

21

2121

22

24

27

36

37

37

39

39

39

41

Guide Contents

Guide Contents

Overview

Arduino 1.6.x IDE

Super Easy Installation (Recommended)Easy Installation

Manual Installation

Arduino 1.0.x IDE

Easy Installation

Manual InstallationStep 0. Install Arduino IDE

Step 1. Add ATtiny85 Support

Step 2. Updating avrdude.confStep 3. Update 'ld' linker

Flora Setup for Arduino 1.0.x

Windows Driver Installation

Adafruit Trinket/Gemma Driver Installation

Arduino Gemma Driver Installation

Flora Driver InstallationWindows 8 & 10

Windows 7

Locating the Driver File (Win 7 & XP)

Windows 10 Driver Installation

Mac OSX Setup

Linux Setup

udev Rules

TroubleshootingIf you get the error message avrdude: Error: Could not find USBtiny device

(0x1781/0xc9f)

If you get a lot of red text, errors and also a warning about Verification Failed

On Linux if you get the error message "usbtiny_receive: error sending control message:

Protocol error (expected 4, got -71)"

© Adafruit Industries https:/ /learn.adafruit.com/adafruit-arduino-ide-setup Page 2 of 41


3/41

Overview

This guide will walk you through how to install the Arduino IDE to work with Adafruit's boards like

Trinket, Pro Trinket, Gemma, and Flora. It's easy to program these boards by downloading and

installing a preconfigured version of the Arduino IDE. You'll be up and running with your Adafruit

board in minutes!

For most users follow the Arduino 1.6.x IDE install page (http://adafru.it/eRO) to install a version of

the latest Arduino IDE.

For users who need an older version of the Arduino IDE follow the Arduino 1.0.x IDE install

page (http://adafru.it/eRP).

If you aren't sure what Arduino version you need stick with the latest 1.6.x

instructions (http://adafru.it/eRO)!

And if you're new to using Arduino be sure to check out this Arduino tips and tricksguide (http://adafru.it/eRQ), and the official Arduino documentation (http://adafru.it/aMH).


http://arduino.cc/en/Guide/HomePagehttp://localhost/var/www/arduino-tips-tricks-and-techniques/arduino-uno-faqhttp://localhost/var/www/adafruit-arduino-ide-setup/arduino-1-dot-6-x-idehttp://localhost/var/www/adafruit-arduino-ide-setup/arduino-1-dot-0-x-idehttp://localhost/var/www/adafruit-arduino-ide-setup/arduino-1-dot-6-x-ide


4/41

Arduino 1.6.x IDEThe Arduino IDE version 1.6.x is the latest version of Arduino and recommended for most users.

Follow the steps on this page to learn how to install a version of the Arduino 1.6.x IDE with support

for Adafruit's boards.

Super Easy Installation (Recommended)With the Arduino IDE version 1.6.4 and greater you can now add 3rd party boards directly from the

stock IDE! The first thing you will need to do is to download the latest release of the Arduino IDE.

You will need to be using version 1.6.4 or higher:

Latest Arduino IDE Download

http://adafru.it/f1P

After you have downloaded and installed the latest version (remember it must be 1.6.4 or higher),

you will need to start the IDE and navigate to the Preferences menu. You can access it from the

File menu in Windows or Linux , or the Arduino menu on OS X .


http://www.arduino.cc/en/Main/Software


5/41

A dialog will pop up just like the one shown below.

We will be adding a URL to the new Additional Boards Manager URLs option. The list of URLs is

comma separated, and you will only have to add each URL once. New Adafruit boards and updates

to existing boards will automatically be picked up by the Board Manager each time it is opened. The

URLs point to index files that the Board Manager uses to build the list of available & installed

boards.

To find the most up to date list of URLs you can add, you can visit the list of third party board URLs

on the Arduino IDE wiki (http://adafru.it/f7U). We will only need to add one URL to the IDE in this

example, but you can add multiple URLS by separating them with commas . Copy and paste

the link below into the Additional Boards Manager URLs option in the Arduino IDE preferences.


https://github.com/arduino/Arduino/wiki/Unofficial-list-of-3rd-party-boards-support-urls#list-of-3rd-party-boards-support-urls


6/41

Click OK to save the new preference settings. Next we will look at installing boards with the Board

Manager.

Now that you have added the appropriate URLs to the Arduino IDE preferences, you can open

the Boards Manager by navigating to the Tools->Board menu.

https: //adafruit.github.io/arduino-board-index/package_adafruit_index.json

Make sure you remove the apt.adafruit.com proxy setting from the Arduino preferences if you

have previously added it.



7/41

Once the Board Manager opens, click on the category drop down menu on the top left hand side of

the window and select Contributed. You will then be able to select and install the boards

supplied by the URLs added to the prefrences. In the example below, we are installing support

for Adafruit AVR Boards , but the same applies to all boards installed with the Board Manager.



8/41

Next, quit and reopen the Arduino IDE to ensure that all of the boards are properly installed. You

should now be able to see the new boards listed in the Tools->Board menu.

Finally follow the steps below for your platform to finish the installation:

Windows Setup (http://adafru.it/eTU)

Mac OSX Setup (http://adafru.it/eTV)

Linux Setup (http://adafru.it/eTW)

Also check out the troubleshooting section (http://adafru.it/eTX) for some advice on common errors.

Have fun using Adafruit's boards!

Easy Installation

If you have trouble using the super easy installation method above another way to install support for

Adafruit's boards is with the following preconfigured Arduino IDE downloads. Just grab the right file

for your platform and use it like the normal Arduino IDE. Adafruit's boards like Trinket, Pro Trinket,

Gemma, and Flora are configured to show up in the board list automatically!

Arduino 1.6.4 with Adafruit Boards for

Windows

http://adafru.it/f83



https://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-macosx.ziphttps://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-windows.ziphttp://localhost/var/www/adafruit-arduino-ide-setup/troubleshootinghttp://localhost/var/www/adafruit-arduino-ide-setup/linux-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup


9/41

Mac OSX (10.7+)



Linux (32-bit)



Linux (64-bit)


Once you've downloaded and installed the IDE follow the steps below for your platform to finish the

installation:






Manual Installation

If you have your own version of the Arduino IDE or would like to install the Adafruit boards yourself

then follow the steps below. However it is highly recommended that most users stick to the easy

install downloads above!

With the 1.6.x version of the Arduino IDE the process of adding support for new boards is much

simpler than previous versions. First start by downloading a version of the Arduino 1.6.x IDE and

installing it as normal. Note that these instructions are only tested to work against the

Arduino 1.6.4 IDE, earlier or later versions may or may not work!

Once you've installed the stock Arduino IDE download and unzip the following file which contains

Adafruit's board definitions (http://adafru.it/eTY):

Adafruit Board Definitions

http://adafru.it/eTZ

Unzip the file and navigate inside the Adafruit_Arduino_Boards folder to find a

hardware subfolder with a small hiearchy of files, and a drivers folder with Flora drivers specific to


https://github.com/adafruit/Adafruit_Arduino_Boards/archive/master.ziphttps://github.com/adafruit/Adafruit_Arduino_Boardshttp://localhost/var/www/adafruit-arduino-ide-setup/troubleshootinghttp://localhost/var/www/adafruit-arduino-ide-setup/linux-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setuphttps://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-linux64.tar.xzhttps://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-linux32.tar.xz


10/41

Windows.

Next find your installed Arduino IDE's hardware subfolder. For Windows and Linux the hardware

subfolder should be directly beneath the folder where Arduino's IDE was installed.

For Mac OSX the folder is hidden inside the application bundle. Right click on the Arduino

application and click 'Show Package Contents', then navigate to the Content -> Resources ->

Java folder to find the hardware subfolder.

Once you've found Arduino's hardware subfolder carefully merge in the contents of the hardware

folder from Adafruit's board definitions, being sure to overwrite any file that conflicts (only

avrdude.conf should conflict). When you're done the Arduino hardware folder should have the

following hiearchy:

hardware

adafruit

avr

The contents of the hardware/adafruit/avr folder from Adafruit's board

definitions. There will be a boards.txt, platform.txt and variants subfolder.

arduino

No changes to this hiearchy, it is exactly as provided by the Arduino IDE.

tools

avr

etc

avrdude.conf - This version of avrdude.conf should be from

Adafruit's board definitions and completely overwrites the version

provided by the Arduino IDE.

... all other files as provided by the Arduino IDE.

... all other files as provided by the Arduino IDE.

Finally on Windows only, copy the contents of the drivers folder from the board definitions download

into the Arduino IDE's drivers folder (it's a sibling of the hardware folder you found earlier).

That's all you need to do to manually install Adafruit's boards with the 1.6.x version of Arduino!

Now follow the steps below for your platform to finish the installation:




http://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup


11/41





http://localhost/var/www/adafruit-arduino-ide-setup/troubleshootinghttp://localhost/var/www/adafruit-arduino-ide-setup/linux-setup


12/41

Arduino 1.0.x IDEThe Arduino IDE version 1.0.x is an older version of the Arduino IDE and is provided for users who

might require the older IDE for compatibility or other reasons. For most users the newer 1.6.x

version is recommended!

Easy InstallationThe easiest way to install the Arduino 1.0.x version IDE with support for Adafruit's boards is with the

following preconfigured downloads. Just grab the right file for your platform and use it like the

normal Arduino IDE. Adafruit's boards like Trinket, Pro Trinket, Gemma, and Flora are configured

to show up in the board list automatically!


Windows

http://adafru.it/eYK


Mac OSX

http://adafru.it/eYJ


Linux (32-bit)

http://adafru.it/dXa


Linux (64-bit)

http://adafru.it/dXb

Once you've downloaded and installed the IDE follow the steps below for your platform to finish the

installation:

Windows Setup (http://adafru.it/eTU)Mac OSX Setup (http://adafru.it/eTV)





http://localhost/var/www/adafruit-arduino-ide-setup/troubleshootinghttp://localhost/var/www/adafruit-arduino-ide-setup/linux-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setuphttp://adafruit-download.s3.amazonaws.com/trinket-arduino-1.0.5-linux64.tgzhttp://adafruit-download.s3.amazonaws.com/trinket-arduino-1.0.5-linux32.tgzhttps://s3.amazonaws.com/adafruit-download/Adafruit+Arduino+1.0.5+-+Mac+4-17-2015.ziphttps://s3.amazonaws.com/adafruit-download/Adafruit+Arduino+1.0.5+-+Win+4-17-2015.zip


13/41

Manual Installation

If you have your own version of the Arduino IDE or would like to install the Adafruit boards yourself

then follow the steps below. However it is highly recommended that most users stick to the easy

install downloads above!

Step 0. Install Arduino IDEThis tutorial will base the IDE off of v1.0.5. You can try later versions but v1.0.5 is at least

guaranteed to work

Adding Adafruit board support does not affect any other boards that are installed so you can

continue to use the IDE with any Arduino board currently supported.

Linux note: You can find instructions for manually modifying the Arduino IDE to support

Trinket/Gemma/Flora in the README of the Trinket Arduino Linux github

repository (http://adafru.it/dXd).

Step 1. Add ATtiny85 Support

Download the following file by pressing the button.

Click to download Adafruit board

hardware support

http://adafru.it/dYP

Unzip it and move the hardware folder from the zip file and place it into to your Arduino sketchbook

folder. Your sketchbook folder is the folder where the Arduino IDE stores your sketches. This folder

is automatically created by the IDE when you install it. If this is your first time using the Arduino IDE,

it will be empty!

On Linux machines, the folder is named "Sketchbook" and it is typically located

in/home/[username]

On Windows and Macintosh machines, the default name of the folder is "Arduino" and is located

in your Documents folder.

Now you can start (or restart the the IDE) and check the Tools->Board menu, you should see the

This is a common source of confusion on Windows and Mac machines, your sketchbook

folder is not named "sketchbook" it is named "Arduino"!


http://www.adafruit.com/downloads/trinkethardwaresupport.ziphttps://github.com/adafruit/Trinket_Arduino_Linux


14/41

three new entries for Trinket and Gemma:

OK you are half done! Next is updating the avrdude configuration file.

Step 2. Updating avrdude.conf

The second step is to update the AVR chip program upload helper to be a little more patient with the

ATtiny85 bootloader we have on the Trinket. We will update the description of the chip's erase cycle

to be longer, to avoid timeouts and errors.

Windows users can download the new avrdude.conf by clicking this button:

avrdude.conf for Windows

http://adafru.it/eU0

Mac users should download this version and uncompress it

avrdude.conf for Mac


On Linux download this version of the file and rename it to just avrdude.conf:

avrdude.conf for Linux



https://s3.amazonaws.com/adafruit-download/avrdude_linux.confhttps://s3.amazonaws.com/adafruit-download/avrdudeconfmac.ziphttps://s3.amazonaws.com/adafruit-download/avrdude.conf


15/41

Now we will hunt for the original avrdude.conf file. If you are using a Mac, right-click on the Arduino

application icon and select “Show Package Contents” then navigate through the Contents & Java

folders. On Windows you will have to find the installation directory, which may be a folder on the

Desktop or possibly in C:\Program Files if you used the installer. Likewise in Linux it is where-ever

you uncompressed the folder.

Now find the hardware\tools\avr\etc folder, and inside you should see the avrdude.conf file. You

can also use your operating system's find tool to locate it.

Rename the old avrdude.conf to avrdude.bak and copy over the new avrdude.conf to the same

folder



16/41


17/41

Download the ld for your operating system and replace the one you have now (thanks to TCWorld

for this fix! (http://adafru.it/cGP))

Download the new ld for Windows


Download the new ld for Mac


Now restart the Arduino IDE. If using Trinket or Gemma you are done with setup! Now follow thesteps below for your platform to finish the installation:





http://localhost/var/www/adafruit-arduino-ide-setup/linux-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setuphttps://s3.amazonaws.com/adafruit-download/MAC_ld.ziphttps://s3.amazonaws.com/adafruit-download/WINDOWS_ld.ziphttps://github.com/TCWORLD/ATTinyCore/tree/master/PCREL%20Patch%20for%20GCC


18/41

However if you're using Flora, continue on to setup the IDE for Flora.

Flora Setup for Arduino 1.0.x

Find your boards.txt file its in the Arduino/hardware/arduino folder on Windows for version 1.0 IDE

On a Mac right click the application and select "Show Package Contents," then navigateto Contents/Resources/Java/hardware/Arduino) and add to the bottom:

Place in arduino-1.0.5\drivers (Windows only):

Adafruit_Flora.inf


Add to hardware/arduino/variants/flora (windows) or

hardware/arduino/avr/variants/flora (mac) (create folder):

pins_arduino.h


flora8.name=Adafruit Flora

flora8.upload.protocol=avr109

flora8.upload.maximum_size=28672

flora8.upload.speed=57600

flora8.upload.disable_flushing=true

flora8.bootloader.low_fuses= 0xff

flora8.bootloader.high_fuses= 0xd8

flora8.bootloader.extended_fuses= 0xcbflora8.bootloader.path=caterina

flora8.bootloader.file= Caterina-Flora8.hex

flora8.bootloader.unlock_bits=0x3F

flora8.bootloader.lock_bits=0x2F

flora8.build.mcu=atmega32u4

flora8.build.f_cpu=8000000L

flora8.build.vid=0x239A

flora8.build.pid=0x8004

flora8.build.core=arduino

flora8.build.variant=flora


https://s3.amazonaws.com/adafruit-download/pins_arduino.hhttps://s3.amazonaws.com/adafruit-download/Adafruit_Flora.inf


19/41

Add to hardware/arduino/bootloaders/caterina (windows)

or hardware/arduino/avr/bootloaders/caterina (mac)

Caterina-Flora.hex


Edit hardware/arduino/cores/arduino/USBCore.cpp (windows)

or hardware/arduino/avr/cores/arduino/USBCore.cpp (mac)

find:

Add right below it

Then find

Add right below it

That's it, you're ready to start using Flora with Arduino 1.0.x! One last thing is to follow the steps

here for your platform to finish the intall:






#elif USB_PID == 0x9208

'L','i','l','y','P','a','d','U','S','B',' ',' ',' ',' ',' ',' '

#elif USB_PID == 0x8004

'A','d','a','f','r','u','i','t',' ','F','l','o','r','a',' ',' '

#elif USB_VID == 0x1b4f

'S','p','a','r','k','F','u','n',' ',' ',' '

#elif USB_VID == 0x239A

'A','d','a','f','r','u','i','t',' ',' ',' '


http://localhost/var/www/adafruit-arduino-ide-setup/troubleshootinghttp://localhost/var/www/adafruit-arduino-ide-setup/linux-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/mac-osx-setuphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setuphttps://s3.amazonaws.com/adafruit-download/Caterina-Flora8.hex


20/41

Windows Driver InstallationTo use a Trinket, Gemma, or Flora on Windows you will need to install a driver for your board.

Follow the steps below depending on the board you're using:

Adafruit Trinket/Gemma (black board) Driver Installation (http://adafru.it/eTU)

Arduino Gemma (teal board) Driver Installation (http://adafru.it/eTU)

Flora Driver Installation (http://adafru.it/eTU)

Note on Mac OSX or Linux you don't need to install any driver to use Adafruit's boards.

Only follow these steps if you're using Windows.

Adafruit Trinket/Gemma Driver Installation

If you're using an Adafruit Trinket or Adafruit Gemma (the black circuit board Gemma, not the

teal or blue/green Arduino Gemma--for Arduino Gemma skip below to the next

section (http://adafru.it/eTU)) follow the steps below to install a custom driver for the board.

First download the signed Windows 10, 8, 7, Vista, XP driver below and unzip its contents to a folder

on your computer:

Download Signed Adafruit

Trinket/Gemma Driver

http://adafru.it/djr

If for some reason you need it there is also an older unsigned driver for Windows 7, Vista,

XP (http://adafru.it/eFa). Stick with using the signed driver above unless you know you need the

unsigned driver.

Then plug in the Trinket or Gemma to a known-good USB cable to start the process. You should

see the green power LED lit and the red bootloading LED pulse indicating that the Trinket is readyto start bootloading. If you've programmed the Trinket since getting it, you can always get it back to

the bootloader state by pressing the small onboard reset button.

Finally, follow the steps on this page to install the custom Trinket/Gemma

driver. (http://adafru.it/cDY)

Remember this driver is for the Adafruit Gemma board and not the Arduino Gemma board. If

your Gemma has a black circuit board use this driver, but if it has a teal or green/blue circuit

board skip down to the next section.


http://learn.adafruit.com/usbtinyisp/drivershttp://adafruit-download.s3.amazonaws.com/usbtinyisp_libusb-win32-64_1.2.1.0.ziphttp://www.adafruit.com/downloads/usbtiny_signed_8.ziphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#arduino-gemma-driver-installationhttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#flora-driver-installationhttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#arduino-gemma-driver-installationhttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#adafruit-trinket-slash-gemma-driver-installation


21/41

If you're using Windows 10 you might need to follow the steps at the bottom of the page to manually

install the driver (http://adafru.it/eTU).

Arduino Gemma Driver Installation

If you're using the Arduino Gemma (teal or blue/green circuit board, not the black circuit board

Adafruit Gemma--if you have a Adafruit Gemma skip back up to theprevious section (http://adafru.it/eTU)) follow the steps below to install a custom driver for the board.

First download the driver below and unzip it to a folder on your computer:

Download Arduino Gemma Driver

http://adafru.it/fSO

Then plug in the Gemma to a known-good USB cable to start the process. You should see the

green power LED lit and the red bootloading LED pulse indicating that the Gemma is ready to start

bootloading. If you've programmed the Gemma since getting it, you can always get it back to the

bootloader state by pressing the small onboard reset button.

Finally, follow the steps on this page to install the custom Gemma driver. (http://adafru.it/cDY)



Flora Driver Installation

If you're using the Flora board follow the steps below to install a custom driver for the board.

For Trinket or Gemma skip back up to the section at the top (http://adafru.it/eTU).

Begin by plugging in the Flora board. Look for a green power LED (left of the mini USB jack) and a

pulsing red LED (right of the mini USB jack).

WinXP users, skip down past these few photos, you should get a popup asking you for a driver

location, just browse to it as shown.

Windows 8 & 10

Remember this driver is for the Arduino Gemma board and not the Adafruit Gemma board. Ifyour Gemma has a teal or blue/green circuit board use this driver, but if it has a black circuit

board skip back up to the previous section.


http://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#adafruit-trinket-slash-gemma-driver-installationhttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#windows-10-driver-installationhttp://learn.adafruit.com/usbtinyisp/drivershttps://learn.adafruit.com/system/assets/assets/000/027/310/original/ArduinoGemmaDriver.zip?1440118644http://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#adafruit-trinket-slash-gemma-driver-installationhttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#windows-10-driver-installation


22/41

We now have signed Windows 8/10 drivers for flora. Download the driver by clicking here. You

should be able to right-click the inf file to install it directly, or point Windows to this uncompressed

folder when prompted!



Downloads the Windows XP/7/8

signed Flora Driver

http://adafru.it/dpT

Windows 7

You'll see this pop up in the bottom right corner:

Now go to the Start menu (bottom left corner, the round windows logo) and click on it and start

typing in Device Manager


http://www.adafruit.com/downloads/Flora_win8signed.ziphttp://localhost/var/www/adafruit-arduino-ide-setup/windows-setup#windows-10-driver-installation


23/41

Click on the Device Manager (top icon in the menu) to launch it, scroll down until you see Adafruit

Flora with a ! mark. Right click and select Update Driver Software



24/41

Locating the Driver File (Win 7 & XP)

OK if you have XP you'll basically start from here, click Browse my computer for driver software

Then browse to the uncompressed Flora IDE folder, and select the drivers folder (not any other

folder!) and click OK.



25/41



26/41

Make sure the folder next to the Browse... button is correct, then click Next.

When you get this scary window next, click Install this driver software anyway.



27/41

That's it! Thankfully you only have to do this once.

Windows 10 Driver Installation

If you're using Windows 10 the process to an install a custom driver is a little different than previous

Windows versions. When you plug in your device, like a Trinket/Gemma/Flora, you might not get a

pop up telling you to install a driver for the device. However you can follow the steps below to

manually install the driver.

These instructions show how to install the driver for a Trinket, but the steps should also apply to

Gemma and Flora (just expect to see a different name for the board).

First make sure you've downloaded the signed driver for the board from the sections above. Extract

the contents of the driver to a folder and remember where you put it.

Then plug in the Trinket/Gemma/Flora. You might hear a 'ding' from Windows that a new device

appeared but no dialog to install a driver. Don't worry keep following along to get the driver

installed.

Now open Device Manager by clicking the start button and typing Device Manager, then clicking

the device manager result to run it. You should see something like the following:



28/41

Press the bootloader button on the Trinket/Gemma and after a few moments you should see device

manager refresh and display the board under an Other devices node:



29/41

Right-click the board (like Trinket in this example) and click the Update Driver Software... option

at the top. This should open a new dialog that looks like the following:



30/41

Select the Browse my computer for driver software option at the bottom. Now you should see a

dialog to find the driver like below:



31/41

Click Browse... and navigate to the folder where you unzipped the driver that was downloaded

earlier. Make sure the 'Include subfolders' option is checked so Windows is sure to find the driver.

Then click the Next button at the bottom.

You should see the driver installation start. During the installation you will probably see a pop-up

like below that asks if you want to allow the Adafruit driver to be installed:



32/41

Make sure Always trust software from "Adafruit Industries" is checked, then click Install.

The driver should finish installing. Note that you might see a "This device cannot start (Code 10)"

failure like the following:



33/41

Don't worry! This just means the Trinket/Gemma bootloader timed-out before the driver finished

installing. Everything should still be fine and you can continue along with the installation. Click

Close to finish the install.

Now device manager should show a libusb (WinUSB) devices node with the USBtiny device

below it:



34/41

Don't worry if the device has an exclamation point next to it indicating a problem. Press the

Trinket/Gemma bootloader button and after a moment device manager should update to show the

device is working:



35/41

That's it, your board should be ready to go and program with the Arduino IDE!



36/41

Mac OSX SetupIf you missed it on the previous page, the following will let you download the latest Arduino IDE

version 1.6.x with support for Adafruit's boards:


Mac OSX (10.7+)

http://adafru.it/eTR

If you're using Mac OS Mavericks you will need to update the setting to permit running Arduino IDE

1. Click the Lock Icon and Login

2. Change "Allow Apps Downloaded From": to "Anywhere"

3. Open the downloaded IDE.

4. Go back to the Security preferences and change the selection back to "Mac App Store and

identified developers"

5. You only need to go through this procedure once. Mavericks will remember that it's OK to runthe app.

That's it, you're ready to start using the Arduino IDE with Adafruit's board on OSX!


https://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.3-macosx.zip


37/41

Linux SetupIf you missed it on a previous page, the following link will let you download the latest 1.6.x version of

the Arduino IDE for Linux:


Linux (32-bit)



Linux (64-bit)


udev Rules

To use Adafruit's boards with most modern Linux distributions you'll want to ensure a few udev rules

are applied. These rules apply special configuration for USB devices like Adafruit's boards to

workaround or fix common issues. Specifically these rules allow Trinket and other boards to be

programmed by the Arduino IDE that's run as a normal non-root user. The rules also fix an issue

with ModemManager hanging on to /dev/ttyACM devices when using Flora or Bluefruit Micro

boards.

To install the rules you'll want download them and copy to the location of udev rules on your system.

For most Linux systems like Ubuntu, etc. udev rules are stored in /etc/udev/rules.d/ (check your

distribution's documentation / help forums if you don't see this folder exists). Run the followingcommands:

Note that you might need to change the rule if you're using a distribution other than Ubuntu/Debian.

In particular the first rule in the file applies the 'dialout' group to Trinket, etc. boards so they can be

programmed without running the Arduino IDE as root. Some distributions use a different group for

this instead of 'dialout'. Check your distribution docs or help forums to see what group should apply

to devices that can be accessed by non-root users.

Next you'll need to reload udev's rules so that they are properly applied. You can restart your

machine, or run a command like the following:

wget https: //github.com/adafruit/Trinket_Arduino_Linux/raw/master/99-adafruit-boards.rules

sudo cp 99-adafruit-boards.rules /etc/udev/rules.d/

sudo reload udev


https://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-linux64.tar.xzhttps://s3.amazonaws.com/adafruit-download/adafruit-arduino-1.6.4-linux32.tar.xz


38/41

If the command above fails, try instead running:

And if that still fails reboot your system as it will ensure udev picks up the new configuration.

sudo udevadm control --reload-rules

sudo udevadm trigger



39/41

Troubleshooting

If you get the error message avrdude: Error: Could not find USBtinydevice (0x1781/0xc9f)

That means the bootloader wasn't active. Make sure to press the button on the Trinket to activate

the bootloader before clicking the Upload button.

If you get a lot of red text, errors and also a warning about VerificationFailed

Check that you updated the avrdude.conf file above - if you don't update the description of the

Attiny85 in the configure file by replacing it, the IDE wont know to be patient with the Trinket/Gemma



40/41

bootloader and will have many upload errors

"



41/41

_control message: Protocol error (expected 4, got -71)"

These can generally be ignored and should not interfere with the program upload. Unfortunately

Linux's USB core is a little flakey communicating with the ATtiny85 processor on the Trinket/Gemma

and can cause these errors. If an upload does fail, try it again as it is likely an intermittent issue.