Skip to content

Commit cad1536

Browse files
authored
Add info on how to get started using this core
There's been several post's on the Arduino forum on how to actually get started. Hopefully this clear things up a little bit!
1 parent 49dcbf2 commit cad1536

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

README.md

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ If you're into "pure" AVR programming, I'm happy to tell you that all relevant k
1010
* [Programmers](#programmers)
1111
* [Why add Arduino support for these microcontrollers?](#why-add-arduino-support-for-these-microcontrollers)
1212
* [Write to own flash](#write-to-own-flash)
13-
* [How to install](#how-to-install)
13+
* **[How to install](#how-to-install)**
1414
- [Boards Manager Installation](#boards-manager-installation)
1515
- [Manual Installation](#manual-installation)
16-
- [Eclipse](#eclipse)
17-
* [Pinout](#pinout)
18-
* [Minimal setup](#minimal-setup)
16+
* **[Getting started with MiniCore](#getting-started-with-minicore)**
17+
* **[Pinout](#pinout)**
18+
* **[Minimal setup](#minimal-setup)**
1919

2020

2121
## Supported microcontrollers:
@@ -91,17 +91,21 @@ Click on the "Download ZIP" button in the upper right corner. Exctract the ZIP f
9191
Open Arduino IDE, and a new category in the boards menu called "MiniCore" will show up.
9292

9393

94-
#### ~~Eclipse~~ Eclipse support is currently broken
95-
MiniCore works perfectly with Eclipse using the [Arduino Eclipse plugin](http://eclipse.baeyens.it) (formally Sloeber). If you're tired of Arduino IDEs limits but still want to stick with open source software; this is the way to go!
96-
* Download and install the latest version of Arduino Eclipse (Download the nighty build if you want support for aditional programmers)
97-
* Open **Preferences** (<i>Windows</i>: Window -> Preferences, <i>Mac</i>: [App name] -> Preferences)
98-
* Click the <i>expand</i> arrow next to the **Arduino** option in the preferences menu
99-
* Click **Locations**, paste the board manager URL and hit the **Apply** button: `https://mcudude.github.io/MiniCore/package_MCUdude_MiniCore_index.json`
100-
* Click the **Platform and Boards** menu option to the left and expand the **MiniCore** option. Select the latest version.
101-
* Click the **OK** button. MiniCore is now installed!
102-
<br/> <br/>
103-
Make sure to select the MiniCore boards.txt file when you create a new sketch.
104-
94+
##Getting started with MiniCore
95+
Ok, so you're downloaded and installed MiniCore, but do I get the wheels spinning? Here's a quick start guide:
96+
* Hook up your microcontroller as shown in the [pinout diagram](#pinout), or simply just plut it into an Arduino UNO board.
97+
- (If you're not planning to use the bootloader (uploading code using a USB to serial adapter), the FTDI header and the 100 nF capacitor on the reset pin can be omitted.)
98+
* Open the **Tools > Board** menu item, and select a MiniCore compatible microcontroller.
99+
* If the *BOD option* is presented, you can select at what voltage the microcontroller will shut down at. Read more about BOD [here](#bod-option).
100+
* Select your prefered clock frequency. **16 MHz** is standard on most Arduino boards, including the Arduino UNO.
101+
* Select what kind of programmer you're using under the **Programmers** menu.
102+
* If the *Variants* option is presented, you'll have to specify what version of the microcontroller you're using. E.g the ATmega328 and the ATmega328P got different device signatures, so selecting the wrong one will result in an error.
103+
* Hit **Burn Bootloader**. If an LED is connected to pin PB5 (Arduino pin 13), it should flash twice every second.
104+
* Now that the correct fuse settings is sat and the bootloader burnt, you can upload your code in two ways:
105+
- Disconnect your programmer tool, and connect a USB to serial adapter to the microcontroller, like shown in the [minimal setup circuit](#minimal-setup). Then select the correct serial port under the **Tools** menu, and click the **Upload** button. If you're getting some kind of timeout error, it means your RX and TX pins are swapped, or your auto reset circuity isn't working properly (the 100 nF capacitor on the reset line).
106+
- Keep your programmer connected, and hold down the `shift` button while clicking **Upload**. This will erase the bootloader and upload your code using the programmer tool.
107+
108+
Your code should now be running on your microcontroller! If you experience any issues related to bootloader burning or serial uploading, please use *[this forum post](https://forum.arduino.cc/index.php?topic=412070.0)* or create an issue on Github.
105109

106110

107111
##Pinout

0 commit comments

Comments
 (0)