Digistump Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======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:=====

The Digispark uses the Arduino IDE 1.6.5+

====== Installation Instructions: ======


  *  **First download the appropriate Arduino package at the Arduino.cc website: https://www.arduino.cc/en/Main/Software**
  *  **Install or Unzip the Arduino application.**
  *  **Run the Arduino application.**
  *  **In the Arduino application go to the "File" menu and select "Preferences"**
{{ :digispark:tutorials:preferences.gif?nolink |}}
  *  **In the box labeled "Additional Boards Manager URLs" enter:** <code>http://digistump.com/package_digistump_index.json</code>
**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 |}}

  *  **Go to the "Tools" menu and then the "Board" submenu - select "Boards Manager" and then from the type drop down select "Contributed":** 
  * **Select the "Digistump Digispark Boards" package and click the "Install" button.**
{{ :digispark:tutorials:digispark_install.gif?nolink |}}

    *  **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.** 
    *  **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)
    * **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:pickpro.gif?nolink |}}

  *  **The install is now complete!** (Linux users see note below)


==== Linux Install ====

  * If you haven't before - Install the udev rules found here: [[http://digistump.com/wiki/digispark/tutorials/linuxtroubleshooting|Troubleshooting section]]

  * **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:=====

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

Page Tools
