toc Atom more_vert What's in this document more_vert Getting Started > Getting Started Software > Atom


For beginners, users getting started with MicroPython & Pycom as well as Atom text editor users, we recommend the Pymakr Plugin for Atom. This section will help you get started using the Atom Text Editor & Pymakr Plugin.Please follow these steps to install the Pymakr Plugin:

  1. Download and install Atom. Ensure that you have Atom installed and open.

  1. Navigate to the Install page, via Atom > Preferences > Install

  2. Search for Pymakr and select the official Pycom Pymakr Plugin.

  3. You should now see and click the Install button. This will download and install the Pymakr Plugin.

  4. That’s it! You’ve installed the Pymakr Plugin for Atom.

Connecting via Serial USB

After installing the Pymakr Plugin, you need to take a few seconds to configure it for first time use. Please follow these steps:

  1. Connect your Pycom device to your computer via USB. If you are using an Expansion Board 2.0, and have just finished a firmware upgrade, be sure to remove the wire between GND and G23 and reset your device by pressing the button. Note: you don’t need the wire for Expansion Board 3.0

  2. Open Atom and ensure that the Pymakr Plugin has correctly installed.

  3. Pymakr has auto-connection enabled by default. In case your device hasn’t connected right away, click on Connect device and then on your device.

  1. Now it should show three arrows >>>, indicating that you are connected!

These settings can also be applied on a per project basis by clicking Settings then Project Settings. This will open a JSON file which you can edit to enter your desired settings.

Troubleshooting Guide

After the latest upgrade of Atom, the serialport package tries to rebuild based on the new electron version (used by Atom on version 1.57).

As a result, Pymakr may throw issues on environments that are missing some setup. You can install the missing setup requirements with the following steps:

  1. Install Python latest version ( If you already have python installed, check if it is added to the path.

  2. Download Microsoft Visual C++ ( and install the community edition.

We are working on updating the serialport package to avoid this type of issue in the future.

This process is easiest with either a Pycom Expansion Board or a Pytrack/Pysense as the addresses are automatically selected. For external products such as FTDI USB Serial Cables, the serial address may need to be copied manually. Additionally, the reset button on the device may also need to be pressed before a connection message appears.


Previous Next