This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
digispark:tutorials:connecting [2015/01/16 17:56] digistump [Software:] |
digispark:tutorials:connecting [2016/11/16 16:35] pfeerick |
||
|---|---|---|---|
| Line 12: | Line 12: | ||
| =====Software:===== | =====Software:===== | ||
| - | **NOTE: ** If you used a version of the ide where the digistump add-ons were installed separately you must delete the digistump folder at My Documents/Arduino/hardware (windows) or Documents/Arduino/hardware (OS X) or /home/[username]/Sketchbook (Linux) or this new IDE install will not work properly and you will get library errors! | + | The Digispark uses the Arduino IDE 1.6.5+ (Arduino 1.6.5r2 - NOT 1.6.6 or 1.6.7 strongly recommended) |
| - | The Digispark uses the Arduino IDE - Digistump Release 1.5.x which is the Arduino IDE with some custom additions and supports Digispark, Digispark Pro, and DigiX. These are presented as a fully integrated package with 1.5.x that can be downloaded as an installed or zip file. | + | ====== Installation Instructions: ====== |
| - | First download the appropriate package: | ||
| - | * Windows (now with fully signed drivers!) | + | * **First download the appropriate Arduino package at the Arduino.cc website: https://www.arduino.cc/en/Main/Software** |
| - | * Installer (recommended): https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8C/DigistumpArduinoInstall1.5.8C.exe | + | * If using Arduino 1.6.6 or higher and windows - you will need to download and install the drivers manually. Download, unzip and run "Install Drivers" (on 32bit systems) or "DPInst64" (on 64bit systems). If you get stuck, try following the steps [[https://www.youtube.com/watch?v=MmDBvgrYGZs|shown in this YouTube video]]. The driver files are located here: https://github.com/digistump/DigistumpArduino/releases/download/1.6.7/Digistump.Drivers.zip |
| - | * Zip: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8C/DigistumpIDE1.5.8C.zip | + | * **Install or Unzip the Arduino application.** |
| - | * Mac: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8C/DigistumpIDE1.5.8COSX.zip | + | * **Run the Arduino application.** |
| - | * Linux: | + | * **In the Arduino application go to the "File" menu and select "Preferences"** |
| - | * 32-bit: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8C/DigistumpIDE1.5.8C-linux32.tar.gz | + | {{ :digispark:tutorials:preferences.gif?nolink |}} |
| - | * 64-bit: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8C/DigistumpIDE1.5.8C-linux64.tar.gz | + | * **In the box labeled "Additional Boards Manager URLs" enter:** <code>http://digistump.com/package_digistump_index.json</code> |
| - | * Note: report any issues with the builds to the forum: http://digistump.com/board | + | **and click OK** |
| + | Note: If you already have additional URLs entered in that box, then click the button on the right of the box and enter this URL on a new line. | ||
| + | {{ :digispark:tutorials:entry.jpg?nolink |}} | ||
| - | **Compiling from source: ** https://github.com/digistump/DigistumpArduino | + | * **Go to the "Tools" menu and then the "Board" submenu - select "Boards Manager" and then from the type drop down select "Contributed":** |
| - | ==== Windows Install ==== | + | * **Select the "Digistump AVR Boards" package and click the "Install" button.** |
| + | {{ :digispark:tutorials:digispark_install.gif?nolink |}} | ||
| - | * Complete these steps before plugging in the Digispark (Pro) | + | * **You'll see the download progress on the bottom bar of the "Boards Manager" window, when complete it will show "Installed" next to that item on the list.** |
| - | * Installer: Run the installer, when it pops up the driver install, install the drivers as well. When complete run the "Arduino IDE - Digistump Release" from your start menu. | + | * **WINDOWS USERS: When complete the install with pop up a Driver Install Wizard window, please click "Next" on this Window to install the drivers for Digistump Boards** (If you already have them installed, this installer will update them and install any that are missing) |
| - | * Zip: Unzip and run the driver install - which is the "Install Drivers.bat" file inside the drivers folder. Then run Arduino.exe to run the IDE. | + | * **With the install complete, close the "Boards Manager" window and select the Digispark from the Tools->Boards menu. "Digispark (Default - 16.5mhz)" is the board that should be selected by all new users. ** |
| + | {{ :digispark:tutorials:pickdigispark.gif?nolink |}} | ||
| - | ==== Mac OS X Install==== | + | * **The install is now complete!** (Linux users see note below) |
| - | + | ||
| - | + | ||
| - | * Disable Gatekeeper by following this tutorial: [[digispark:tutorials:gatekeeper|Disabling Gatekeeper on OSX]] | + | |
| - | * Unzip the App and drag it to your Programs folder - or whereever you would like to store it. | + | |
| - | * Run the "Arduino - Digistump Release" App that you just unzipped. | + | |
| - | * See the troubleshooting section below for any other issues. | + | |
| ==== Linux Install ==== | ==== Linux Install ==== | ||
| - | * Untar | ||
| * If you haven't before - Install the udev rules found here: [[http://digistump.com/wiki/digispark/tutorials/linuxtroubleshooting|Troubleshooting section]] | * If you haven't before - Install the udev rules found here: [[http://digistump.com/wiki/digispark/tutorials/linuxtroubleshooting|Troubleshooting section]] | ||
| - | * Run the arduino executable | ||
| * **ATTENTION LINUX USERS:** [[digispark:tutorials:linuxtroubleshooting|PLEASE CHECKOUT THE LINUX TROUBLESHOOTING PAGE**]] | * **ATTENTION LINUX USERS:** [[digispark:tutorials:linuxtroubleshooting|PLEASE CHECKOUT THE LINUX TROUBLESHOOTING PAGE**]] | ||
| - | + | ==== Sources ==== | |
| + | |||
| + | **Digistump Package Sources: ** https://github.com/digistump/DigistumpArduino | ||
| =====Using the Digispark with the Arduino IDE:===== | =====Using the Digispark with the Arduino IDE:===== | ||
| - | The Digispark works a bit differently than some Arduino compatible products. Not only is there a special add-on to the IDE to support it, but it also programs with a different procedure. | + | The Digispark works a bit differently than some Arduino compatible products. The Digispark programs with a different procedure. |
| From the Tools menu select Board->Digispark (Default - 16.5Mhz) | From the Tools menu select Board->Digispark (Default - 16.5Mhz) | ||
| Line 116: | Line 114: | ||
| * Pin 0 -> I2C SDA, PWM (LED on Model B) | * Pin 0 -> I2C SDA, PWM (LED on Model B) | ||
| * Pin 1 -> PWM (LED on Model A) | * Pin 1 -> PWM (LED on Model A) | ||
| - | * Pin 2 -> I2C SCK, Analog | + | * Pin 2 -> I2C SCK, Analog In |
| * Pin 3 -> Analog In (also used for USB+ when USB is in use) | * Pin 3 -> Analog In (also used for USB+ when USB is in use) | ||
| * Pin 4 -> PWM, Analog (also used for USB- when USB is in use) | * Pin 4 -> PWM, Analog (also used for USB- when USB is in use) | ||
| Line 153: | Line 151: | ||
| * Try connecting it to a USB hub. | * Try connecting it to a USB hub. | ||
| * Try a powered USB hub. | * Try a powered USB hub. | ||
| + | * Try a different cable. | ||
| **If it won't upload:** | **If it won't upload:** | ||
| Line 160: | Line 159: | ||
| **WINDOWS:** | **WINDOWS:** | ||
| - | + | * **Did you install the right driver?** | |
| - | * **Did you install the driver?** | + | * Try following the [[https://www.youtube.com/watch?v=MmDBvgrYGZs|steps shown in this video]], as it addresses most of the problems encountered during the driver installation on Windows, including needing to run a different installer on 64 bit versions of windows, and how to finish installing the drivers without having to plug and unplug your digispark multiple times. |
| * For the example programs if you are getting "Device not found" even after installing the DigiUSB driver in the examples folder then try this: http://digistump.com/board/index.php/topic,257.0.html | * For the example programs if you are getting "Device not found" even after installing the DigiUSB driver in the examples folder then try this: http://digistump.com/board/index.php/topic,257.0.html | ||
| * If Windows does not recognize a "DigiUSB" but a generic "HID-compliant device"/"USB Input Device" pair, go to the Device Manager, find in the "Human Interface Devices" category the USB Input Device with a vendor ID of 0x16C0 and select "update driver" / "browse my computer" / "let me pick from a list" and the DigiUSB should show up there. | * If Windows does not recognize a "DigiUSB" but a generic "HID-compliant device"/"USB Input Device" pair, go to the Device Manager, find in the "Human Interface Devices" category the USB Input Device with a vendor ID of 0x16C0 and select "update driver" / "browse my computer" / "let me pick from a list" and the DigiUSB should show up there. | ||
| Line 179: | Line 178: | ||
| If your upload fails in the middle of it, you may also be using a bad USB cord and or a bad hub. | If your upload fails in the middle of it, you may also be using a bad USB cord and or a bad hub. | ||
| - | Support requests are best posted to the forum, so everyone can benefit and we can help eachother through any issues - http://digistump.com/board | + | Support requests are best posted to the forum, so everyone can benefit and we can help each other through any issues - http://digistump.com/board |