Differences

This shows you the differences between two versions of the page.

--- digispark:tutorials:connectingpro [2014/12/27 13:53]
digistump [Software:]
+++ digispark:tutorials:connectingpro [2016/06/09 12:03]
@@ Line 1: / Line 1: @@
-======Connecting and Programming Your Digispark Pro======
-=====Bootloader:=====
-The bootloader is the code that is pre-programmed on your Digispark and allows it to act as a USB device so that it can be programmed by the Arduino IDE.
-The Digispark runs the micronucleus bootloader version 2, an open source project [[https://github.com/micronucleus ]].
-**CAUTION** We are not at this point supporting upgrading the firmware, so if you decide to, you do so entirely at your own risk.
-=====Software:=====
-**NOTE: ** If you used a version of the ide where the digistump add-ons were installed separately you must delete the 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 Pro 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.
-First download the appropriate package:
-      * Windows (now with fully signed drivers!)
-          * Installer (recommended): https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8B/DigistumpArduinoInstall1.5.8B.exe
-          * Zip: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8B/DigistumpIDE1.5.8B.zip
-      * Mac: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8B/DigistumpIDE1.5.8BOSX.zip
-      * Linux:
-          * 32-bit: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8B/DigistumpIDE1.5.8B-linux32.tar.gz
-          * 64-bit: https://github.com/digistump/DigistumpArduino/releases/download/v1.5.8B/DigistumpIDE1.5.8B-linux64.tar.gz
-      * Note: report any issues with the builds to the forum: http://digistump.com/board
-**Compiling from source: ** https://github.com/digistump/DigistumpArduino
-==== Windows Install ====
-  * Complete these steps before plugging in the Digispark (Pro)
-  * 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.
-  * 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.
-==== Mac OS X Install====
-  * 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 ====
-  * Untar
-  * 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**]]
-=====Using the Digispark with the Arduino IDE:=====
-The Digispark (and Pro) 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.
-From the Tools menu select Board->Digispark Pro (16Mhz) (Default)
-(The Tools->Programmer selection does not matter)
-Write some code, open your code, or open a Digispark example.
-**You do not need to plug in your Digispark Pro before invoking upload**
-Hit the upload button. The bottom status box will now ask you to plug in your Digispark Pro - at this point you need to hit the reset button on it or plug it in.
-You'll see the upload progress and then it will immediately run your code on the Digispark Pro.
-If you unplug the Digispark Pro and plug it back in or attach it to another power source there will be a delay of 5 seconds before the code you programmed will run. This 5 second delay is the Digispark Pro checking to see if you are trying to program it. After the 5 second delay when the bootloader launches the stored program, the USB device will typically go away (and may report a failure to install, or "Unknown Device") unless the nature of the 'sketch' is to act as a USB device.
-=====Your first upload:=====
-If you're just getting started try the above procedure with the following example
-Here is the code it will load:
-<code>
-// the setup routine runs once when you press reset:
-void setup() {
-  // initialize the digital pin as an output.
-  pinMode(1, OUTPUT); //on board LED
-}
-// the loop routine runs over and over again forever:
-void loop() {
-  digitalWrite(1, HIGH);   // turn the LED on (HIGH is the voltage level)
-  delay(1000);               // wait for a second
-  digitalWrite(1, LOW);    // turn the LED off by making the voltage LOW
-  delay(1000);               // wait for a second
-}
-</code>
-This code will blink the BUILT IN LED on Pin 1
-As soon as it has uploaded you should see the LED start to blink!
-=====Precautions:=====
-The Digispark Pro, due to its small size and low cost is not as robust as a full blown Arduino.
-The Digispark Pro does not have reverse polarity protection. Connecting power to the Digispark Pro power pins backwards will almost certainly destroy it.
-The Digispark Pro does have a 0.5A fuse for both the USB and VIN lines - this should safeguard it from brief shorts - but is not by any means a failsafe.
-The Digispark Pro is small enough to present a choking hazard and small enough to be inserted into some sockets. We take no responsibility for misuse of the product. Please treat electricity and electronics with respect and common sense.
-=====Troubleshooting:=====
-The Digispark Pro pushes affordable, small components to their limits by using software to emulate USB functions generally served by a dedicated chip. For this reason much of the Digispark's USB operation is considered borderline out of spec. Certain laptops, older machines, and just some cheaply made USB hubs/controllers do not like this. We tested and designed the Digispark Pro for maximum compatibility but we can not guarantee it will work with everything.
-In addition remember the Digispark Pro only shows up as a programmable device for 5 seconds, after that it will start running its code (when it is new and un-programmed this means it will blink) and disappear or act like the USB device you programmed it to act like.
-Always remember plug in or restart the Digispark Pro when the Arduino IDE requests you to.
-**If the computer will not recognize the Digispark Pro try the following:**
-  * Try connecting it to another USB port or system.
-  * [USB 2 on Windows may be better]
-  * Try connecting it to the rear ports (if a desktop)
-  * Try connecting it to a USB hub.
-  * Try a powered USB hub.
-  * Use a different cable, especially if system ignores the device.
-**If it won't upload:**
-**Did you set your board AND programmer to Digispark in the Arduino IDE?**
-**WINDOWS:**
-  * **Did you install the driver?**
-  * 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.
-**MAC**
-  * If the Arduino application works fine but the computer does not recognize the Digispark after you are asked to plug it in - try a usb extension cable or hub, some MacBook's ports are recessed too far for the data connectors to make contact.
-  * **If the Arduino application won't start (especially an error like: "Arduino" is damaged and can't be opened.) or the upload fails try allowing all unsigned code to be run: See the "How to change Gatekeeper settings to allow or disallow unidentified apps" section on this page: http://www.imore.com/how-open-apps-unidentified-developer-os-x-mountain-lion**
-  * If you're getting the error above and allowing unidentified apps doesn't fix it try this: http://digistump.com/board/index.php/topic,119.0.html  - we are actively working on a fix for this issue.
-  * **2012 MBP** The USB ports on the 2012 MBPs (Retina and non) cause issues due to their USB3 controllers, currently the best work around is to use a cheap USB hub (non USB3) - we are working on future solutions. The hub on a Cinema display will work as well.
-**LINUX:** See the [[digispark:tutorials:linuxtroubleshooting|Linux troubleshooting page]]
-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

Digistump Wiki

User Tools

Site Tools

Differences

Page Tools