Getting Started with Necto Studio

Pages
Contributors: santaimpersonator
Favorited Favorite 0

Introduction

Necto Studio

Necto Studio is a productive cross-platform integrated developing environment provided by MikroElektronika and is available on Windows, Linux, and macOS. It includes C compilers, mikroSDK 2.0, package manager, and USB or WiFi Debugger capabilities with flexible licensing options. The development environment features intelligent code completion, auto-close brackets, and drag and drop visual elements.

Users can find their favorite Click Board library and working example through the Package Manager. Users will also be notified about new versions of installed packages, and easily update in one click.

MikroElektronika even provides first-time users with the longest time trial on the market - Get fully unlocked, feature-rich NECTO for three months, and explore it to the most delicate details before purchase!

For more information about NECTO Studio, please visit the product page.

mikroSDK

mikroSDK 2.0 makes application code portable and reusable on many different platforms and architectures, with virtually no code changes. It is a collection of open-source software libraries with unified API and software development tools. Everything you need to start developing, and prototyping cross-platform embedded applications, including Click board™ applications and GUIs for embedded devices.

mikroSDK 2.0 is open-source, and it’s natively supported in NECTO Studio. The video below, is a brief overview of how to use the mikroSDK:

Additional Resources:

Required Materials

To get started, users will need a few of items listed below. (You may already have a some of these items; read through the guide and modify your cart accordingly.)

To program a STM32 processor board (recommended) through Necto Studio, users will need a JTAG programmer. Below are programmers that are compatible with the Necto Studio software.

Apple Mac/Linux: Users with a Mac or Linux OS, should purchase the CODEGRIP programmer. The mikroProg is only compatible with Windows PCs.

MIKROE mikroProg for STM32

PGM-19104
Retired

MIKROE CODEGRIP for STM32

PGM-19105
Retired

Optional Hardware

Users may also need some soldering equipment and a JTAG header to connect the programmer to the board.

Note: Users should verify that the pinout for the programmer and adapter match up to the corresponding pins to avoid damaging their MCU.
Solder Lead Free - 100-gram Spool

Solder Lead Free - 100-gram Spool

TOL-09325
$9.95
8
Chip Quik No-Clean Flux Pen  - 10mL

Chip Quik No-Clean Flux Pen - 10mL

TOL-14579
$7.95
4
Header - 2x5 Pin (Male, 1.27mm)

Header - 2x5 Pin (Male, 1.27mm)

PRT-15362
$1.75
Header - 2x5 Pin (Female, 1.27mm)

Header - 2x5 Pin (Female, 1.27mm)

PRT-15363
$1.75

Weller WLC100 Soldering Station

TOL-14228
2 Retired

MIKROE 50-100mil Adapter

PGM-19220
Retired

Suggested Reading

Like our Qwiic connect system, mikroBUS™ socket is a standardized interface for the MIKROE Click boards™. Click on the banner below for more information.

mikroBUS Logo


For users who aren't familiar with the following concepts, we also recommend reading the following tutorials before continuing.

ARM Programming

How to program SAMD21 or SAMD51 boards (or other ARM processors).

Getting Started with MicroMod

Dive into the world of MicroMod - a compact interface to connect a microcontroller to various peripherals via the M.2 Connector!

Designing with MicroMod

This tutorial will walk you through the specs of the MicroMod processor and carrier board as well as the basics of incorporating the MicroMod form factor into your own PCB designs!

MicroMod mikroBUS™ Carrier Board Hookup Guide

This carrier board takes advantage of the MicroMod, Qwiic, and the mikroBUS™ ecosystems and allows users to take advantage of the growing number of 7 MicroMod processor boards, 83 Qwiic (add-on) boards, and +1100 drop-in Click boards™, which equates to +51M different board combinations. Click to learn more.

Software Installation

NOTE: Users will need administrative privileges on their computer's OS to install Necto Studio and the associated software for the MCU programmers.

To install Necto Studio, users will need to download the installation software for their computer's OS from MikroElektronika's Necto Studio product page. *(Users can also find link to the installation software from the mikroSDK GitHub repository's wiki page.)

Necto product page
Click here to head to the Necto Studio product page and download the installation software. (Click to enlarge)

Once downloaded, execute the installation software and go through the setup steps (Click on images to enlarge):

  1. Execute the installation software from the location that the file was downloaded to
    execute installation software
    Executing the downloaded installation file. (Click to enlarge)
  2. Click the Next > button to configure the software installation
    Start Page
  3. Enter the directory for the Necto Studio to be installed; then click Next >
    Program Directory
  4. Select the components to install; then click Next >
    Program Components
    • We recommend, at minimum, selecting the following components:
      • Necto Studio IDE
      • Compilers
        • ARM
      • mikroSDK
        • 2.4.0 (or latest)
  5. Read the License Agreement, accept or decline the license, and then click Next >
    License Agreement
    Note: Users will need to accept the terms, if they wish to continue the installation process
  6. Enter the where the software shortcut should be saved; then click Next >
    Shortcut Directory
  7. Once the setup has been configured, users can initiate the installation by clicking the Install button
    Installation Page
  8. Once the installation has completed; click the Finish button
    Installation Complete

CODEGRIP Suite

The first time users run Necto Studio, it will attempt to download and install the CODEGRIP Suite. (The computer will need to be connected to the internet for the installation software to be downloaded.)

Installation Prompt
Installation prompt for CODEGRIP Suite in Necto Studio. (Click to enlarge)

Click the Ok button to proceed and then follow the prompts below (Click images to enlarge):

  1. Enter the directory for the Necto Studio to be installed; then click Next >
    Program Directory
  2. Read the License Agreement, accept or decline the license, and then click Next >
    License Agreement
    Note: Users will need to accept the terms, if they wish to continue the installation process
  3. Once the installation has completed; click the Finish button
    Installation Complete

Installation Error

On Windows PCs, if users experience an issue downloading CODEGRIP Suite due to a Error:UnknownNetworkError error, their computer may be missing a Microsoft Visual C++ 2010 Runtime Library.

UnknownNetworkError
Failure to download CODEGRIP Suite and Error:UnknownNetworkError error message. (Click to enlarge)

To install the missing Microsoft Visual C++ 2010 Runtime Library, download the vcredist_x64.zip file (or click the button below), extract the folder, and execute the contained installation setup file vcredist_x64.exe.

Then, follow the installation prompts. After the Microsoft Visual C++ 2010 Runtime Library installation is complete, users can restart Necto Studio. The prompt for the CODEGRIP Suite installation will pop up again.

Alternatively, users can install the CODEGRIP Suite separately. However, the Microsoft Visual C++ 2010 Runtime Library is still necessary for users to login to their account in the User Account and Compiler License section.

Download CODEGRIP Suite

Users can still download and install the CODEGRIP Suite installation software separately:

  • www.mikroe.com/setup/codegrip
    hyperlink download
    Click on the link above this image. If successful, a thank you page will be displayed. (Click to enlarge)
  • CODEGRIP programmer product page
    product page download
    Scroll down to the Downloads section of the product page for the associated programmer. (Click to enlarge)

Once downloaded, execute the installation software and go through the setup steps mentioned above.

mikroProg Suite

Users with a Windows OS, will have the option to utilize the mikroProg programmer instead of the CODEGRIP programmer (the mikroProg is only compatible on Windows PCs). The installation software for the mikroProg Suite can be downloaded from the product page of the associated programmer:

product page download
Scroll down to the Downloads section of the product page for the associated programmer. (Click to enlarge)

Once downloaded, extract and execute the installation software and go through the setup steps (Click on images to enlarge):

  1. Execute the installation software from the location that the file was downloaded to
    execute installation software
    Executing the downloaded installation file. (Click to enlarge)
  2. Click the Next > button to configure the software installation
    Start Page
  3. Read the License Agreement, accept or decline the license, and then click Next >
    License Agreement
  4. Select the user access; then click Next >
    User access
  5. Enter the directory for the mikroProg Suite to be installed; then click Next >
    Directory
  6. Once the installation has completed; click the Finish button
    Installation Complete

Home Page Layout

When users open the Necto Studio application, they will be brought to the Home Page. Below is a brief overview of the page layout:

home page layout
Home page layout. (Click to enlarge)

The numbers below correspond with the numbers in the image above:

  1. Home button - Brings users back to the **Home Page*
  2. Sign In button
    • Displays the login page for users to enter their account credentials.
    • Users can also register a new account from this page.
    • Once users are logged in, this button will be replaced by their profile name.
  3. Licenses drop down menu - Location of the Manage licenses menu option, where users can activate, deactivate, and purchase compiler licenses
  4. New Project button - Use to create a new project
  5. Open Project button - Open a project
  6. Examples button - Open a project from available examples of installed libraries
  7. Packages button - Find and install libraries from the Package Manager page
  8. Planet Debug button - Allows users to debug a project from a remote hardware setup (paid service)
  9. Setups button - Create, manage, and configure hardware setup(s) from the My Setups page
  10. List of recent projects - Opens recently saved projects
  11. Build button - Used to build opened project and will output a compiled *.hex file for the selected hardware setup
  12. Program button - Used to program a project to a hardware setup, once it has been successfully built and compiled, through a compatible programmer
  13. Debugger button - Used to debug a project on a hardware setup with a compatible programmer
  14. Web button - Opens internal web browser
  15. Help button - Opens Help page

User Account and Compiler License

To utilize Necto Studio, users will need to register an account and activate a compiler license.

User Account

Users will need an account to activate their compiler license. These user accounts are also tied to the MikroElektronika forum. From the Necto Studio home page, click on the Sign In button and a dialog box will pop up; where users can sign in or register as a new user.

home page
Sign In button on the home page. (Click to enlarge)

New Users

To register as a new user account, click on the Create Account button. Then enter your user information in to the registration form and click the Register button to create your account.

registration form
New user registration form. (Click to enlarge)

Sign In

Enter your credentials into the sign in dialog box; then, click on the Sign In button.

  • Make sure to enter your username and not the email address registered to the account.

login page
Login page for user credentials. (Click to enlarge)

NOTE: On Windows 10 PCs, if users experience the following, their computer may be missing a Microsoft Visual C++ 2010 Runtime Library.

  • Aren't able to sign-in due to a network issue while they are connected to the internet.
  • Aren't able to download CODEGRIP Suite due to a Error:UnknownNetworkError error:
    UnknownNetworkError
    Error:UnknownNetworkError error. (Click to enlarge)

To install the missing Microsoft Visual C++ 2010 Runtime Library, download the vcredist_x64.zip file (or click the button below), extract the folder, and execute the contained installation setup file vcredist_x64.exe.

Compiler License

MikroElectronika offers new users 90-day trial license, but users will eventually need to purchase a compiler license if they wish to continue utilizing Necto Studio after the trial period has ended.

Purchase License

A compiler license can be purchased from MikroElektronika's Necto Studio product page, from the Manage licenses drop down menu on Necto Studio, or from the product category page of available compiler licenses.

Necto studio product page
Click here to head to the Necto Studio product page and purchase a compiler license. (Click to enlarge)
Necto Studio - purchase license
Users can also purchase a compiler license through Necto Studio. (Click to enlarge)
Compiler license page
Click here to view the available compiler licenses. (Click to enlarge)

Activate Trial License

To activate a compiler license, click on License > Manage licenses from the drop down menu and a dialog box will appear. From the dialog box, find the appropriate compiler license and select the activation method. Users will be given the following options:

Manage licenses page
Manage licenses page listing the available compiler licenses. (Click to enlarge)

  • To activate a permanent license click on the Activate via key button. Enter your license key and then click on the Activate button.
    activation by key
    Activation key entry, when the Activate via key option is selected. (Click to enlarge)
  • To activate a floating (or network) license, click on the Activate floating button. Enter the network address and port for the license; then click on the Activate button.
    activation by floating key
    Network key entry, when the Activate floating option is selected. (Click to enlarge)
    • If users are accessing the license remotely, they may need to VPN onto the network hosting the license.
  • New users can activate a trial license, click on the Activate trial button; then click on the Activate button.
    activation by trial
    Activation button, when the Activate trial option is selected. (Click to enlarge)
  • Users can also purchase a compiler license by clicking on the Buy License button.
    Necto Studio - purchase license
    Necto Studio's internal web browser, displaying the compiler license purchase options from the Necto Studio product page. (Click to enlarge)

Setup - Hardware Configuration

Similar to selecting a board from the Board Manager in the Arduino IDE, users will create a Setup for a specific board and processor configuration in Necto Studio. Users will need to sign in and activate a compiler license for the SDK to build a Setup. MikroElektronika has a tutorial video on their Youtube channel for this process:

Otherwise, users can also follow the steps below to create their setup (Click images to enlarge):

  1. From the Home page, select the Setups box
    home page
  2. Click the New button on the My Setups page
    my setups page
  3. Select a compiler on the Compiler page
    compiler page
  4. Select the SDK on the SDK page
    SDK page
  5. Select the board on the Board page
    board page
  6. Select the microcontroller on the MCU page
    MCU page
  7. Select display on the Display page
    display page
  8. Select the appropriate programmer on the Programmer page
    codegrip programmer
    CODEGRIP (recommended hardware)
    mikroprog programmer
    mikroProg for MCU
    • We recommend users select the following target options for the CODEGRIP programmer, if they wish to program the target MCU directly from Necto Studio:
      target options
  9. Click the Done and then Finish buttons

Users will then see the progress configuration and SDK build:

build progress
Configuration build progress. (Click to enlarge)

Once completed, users will be taken back to the My Setups page:

  • Users should now see that their hardware configuration has been added to the setup list on the left column.
  • These setups can be copied, modified, removed, and renamed (we recommend users rename their setup for organization purposes).
  • In the right column, users will find a summary of the hardware configuration for the selected setup (from the left column).

my setups
Layout of the My Setups page. (Click to enlarge)

Package Manager - Click Libraries

Similar to using a library from the Library Manager in the Arduino IDE, users will need to install a library for their Click Board™ through the Package Manager in Necto Studio. MikroElektronika has a tutorial video on their Youtube channel for this process:

Otherwise, users can also follow the steps below to install a library (Click images to enlarge):

  1. From the Home page, select the Packages box
    home page
  2. This will take users to a blank project page with the Package Manager window open the righthand side. Within the Package Manager window, users can search, upload, create, open libraries that are hosted on MikroElektronic's Libstock repository. Once found, users can install a library into Necto Studio by clicking the Install button
    Package manager window
  3. Like Arduino's libraries, MikroElektronika's libraries also contain an example file. To open an example for a library, click on the Open Example button after the library has been installed in Necto Studio
    Open example
  4. Opening an example will create a new project. Therefore, users will need to select a hardware setup for the project
    select hardware setup

Projects - Start and Build

Starting a Project

Similar to a sketch in the Arduino IDE, a project is used to organize the code and hardware configuration in Necto Studio. Users can start a new project, open an existing project, open a recently saved project, and use a project from a library example through the home page.

Below, are the options for starting a project (Click on the images to enlarge):

  • New Project
    1. Click on the New Project button
      home page
    2. Give the project a name and select a directory to save it on the Name page; then click on the Next button
      name and directory
    3. Select the project type from the Type page; then click on the Next button
      type
    4. Select an SDK from the Template page; then click on the Next button
      template
    5. Select a hardware configuration from the Setup page; then click the Finish button
      setup
      • Alternatively, use the Manage setups to create or modify a hardware configuration from the My Setups page
  • Open Project
    1. Click on the Open Project button
    2. Find and open the project file
  • Examples
    1. Click on the Examples button
    2. Select the example project from one of the available library examples
    3. Select a hardware configuration from the Choose setup page and then click the Choose button
      • Alternatively, use the Manage setups to create or modify a hardware configuration from the My Setups page

Modifying the Hardware Setup

Just as in the Arduino IDE, users can change the hardware configuration. From the project page, users can modify the project's hardware configuration by clicking on highlighted the Active setup.

change setup
Click on the highlighted Active setup to change the hardware configuration for the project. (Click to enlarge)

Build - Compiling a *.hex File

In order to compile a *.hex file to program a MCU, users will need to build the project. Users just need to click on the Build button, but it would be best to run meMake to optimize the project build (Click the images to enlarge):

  1. meMake is a simplified build system designed to get the most out of your CPU designed by parallelizing jobs to decrease the compile and linking times. Run meMake to optimize your project build
    Run meMake
  2. To compile the project code, users only need to click the Build button. Once the build is complete, the compiled *.hex file can be found in the directory (it might be located in a hidden folder) listed under the General Output tab
    build output

NOTE: Users who select a Generic board in their hardware setup, may run into a compilation error. This error is because the pins for the Generic board are undefined, by default. Users will need to declare the pins utilized by their code for the build to compile.

generic board error
The compile error for a generic board with undeclared pins. (Click to enlarge)

Programmer and Debugger Configuration

CODEGRIP Suite

The CODEGRIP Suite is the software application associated with the CODEGRIP programmer product line. It is used to:

  • Find and connect with available programmers through USB and/or WiFi
  • Configure the target MCU
  • Enable the power on a programmer to a target
  • Detect, write, read, erase, reset, and flash a target MCU

To get started with your CODEGRIP programmer, it is recommended you reference the Quick Start Guide linked on the associated product page. For more details on the programmer, users can refer to the User Manual, also linked on the associated product page.

Installation

The first time users run Necto Studio, it will attempt to download and install the CODEGRIP Suite.

NOTE: On Windows PCs, if users experience an issue downloading CODEGRIP Suite due to a Error:UnknownNetworkError error, their computer may be missing a Microsoft Visual C++ 2010 Runtime Library.

UnknownNetworkError
Error:UnknownNetworkError error. (Click to enlarge)

To install the missing Microsoft Visual C++ 2010 Runtime Library, download the vcredist_x64.zip file (or click the button below), extract the folder, and execute the contained installation setup file vcredist_x64.exe.

Users can also download the CODEGRIP Suite installation software from:

For more information, check out the Software Installation section.

Scan and Connect

Connect the CODEGRIP programmer to a computer using the included USB-C cable (and adapter, in necessary). If everything is connected properly, the POWER, ACTIVE, and USB LINK LED indicators on the device will turn on. When the ACTIVE LED indicator stops blinking, the CODEGRIP is ready.

CODEGRIP programmer LEDs
LED indicators on the CODEGRIP programmer. (Click to enlarge)

Open the CODEGRIP menu and select the newly unfolded Scanning menu item. Click the SCAN DEVICES button to get a list of available CODEGRIP devices.

scan for devices
Scanning for connected programmers. (Click to enlarge)

To connect with your CODEGRIP through a USB cable click the USB Link (icon) button. The USB Link indicator will turn yellow upon successful connection.

connect to device
Connect to a programmer. (Click to enlarge)

Target Configuration

Open TARGET menu and select the Options menu item. Set up target MCU either by selecting Vendor: first or by directly entering MCU: name in the drop-down list. To narrow down the list of available MCUs, start typing the name of the MCU manually. The list will be dynamically filtered while typing.

target selection
Selecting the target MCU for the programmer. (Click to enlarge)

Then select the programming protocol to match your hardware setup. Options are SWD or JTAG.

protocol selection
Selecting the programming protocol. (Click to enlarge)

Enabling Power

Open the POWER menu and select the newly unfolded Outputs menu item. Click the Set Voltage button to configure the power output of the programmer.

alt text
(Click to enlarge)

alt text
(Click to enlarge)

Once the output voltage has been configured, users can toggle the button to the right to enable the power output. If configured and enabled properly, Board Voltage (V): under the Measurements section will display the voltage output from the programmer.

enable power output
Programmer's power output enabled. (Click to enlarge)

Detect

Confirm the communication with the target MCU by clicking the Detect button located on the Shortcuts bar. A small pop-up window will display the confirmation message.

detect MCU
Verifying communication with the target MCU. (Click to enlarge)

Programming

Load the *.bin or *.hex file by using the Browse button.

load file
Selecting the source file to be uploaded to the MCU. (Click to enlarge)

Click the WRITE button to program the target MCU. The progress bar will indicate the programming process, while the programming status will be reported in the message area.

programming
Programming the target MCU and verification output. (Click to enlarge)

Debugging in Necto Studio

Instead of programming the MCU separately through CODEGRIP Suite, users can also program a project directly from Necto Studio.

  • Users will need to configure the programmer through CODEGRIP Suite, up until the detect step above
  • When creating the hardware configuration, the CODEGRIP programmer's target options must set to the following parameters:
    target options
  • The target MCU must be powered, this can be configured through the CODEGRIP Suite or the MCU can be powered from an external power source

If setup properly, users only need to click on the Program button. This target option configuration, also allows users to access the debugger in Necto Studio. Like most debuggers, users can step trough instruction steps, set breakpoints, step-in/out of loops, check values, etc. to help locate issues in the project's code execution.

debugging output
Debugging an example project at a breakpoint. (Click to enlarge)

Troubleshooting Tips

Below, we have also included some troubleshooting tips for issues that you may come across.

Sign-in or CODEGRIP Installation Issues

On Windows 10 PCs, if users experience an issues signing in to Necto Studio or come across an Error:UnknownNetworkError error message, their computer may be missing a Microsoft Visual C++ 2010 Runtime Library.

UnknownNetworkError
Failure to download CODEGRIP Suite and Error:UnknownNetworkError error message. (Click to enlarge)

To install the missing Microsoft Visual C++ 2010 Runtime Library, download the vcredist_x64.zip file (or click the button below), extract the folder, and execute the contained installation setup file vcredist_x64.exe.

Example Code Compilation Error

Users who select a Generic board in their hardware setup, may run into a compilation error. This error is because the pins for the Generic board are undefined, by default. Users will need to declare the pins utilized by their code for the build to compile.

generic board error
Compilation error message. (Click to enlarge)

No Power from the CODEGRIP Programmer

To detect a target MCU, it must be at least powered and have the SWD pins connected to the programmer. If the MCU has to be powered by the CODEGRIP programmer, users can enable it through the CODEGRIP Suite.

power enabled
CODEGRIP power output enabled. (Click to enlarge)

Remote Debugging

To learn more about configuring a remote debugging setup at your home, check out this blog post. For more information on Planet Debug, check out MikroElektronika's Planet Debug services page.


Source: Planet Debug services page

Resources and Going Further

For more on the Necto Studio and the mikroSDK, check out the links below: