Codeanywhere¶

Demo¶

Integration¶

1. Sign in to Codeanywhere. A registration is FREE and gives you unlimited private projects within the one Container.

2. Open Dashboard Projects

3. Create a new Project and open it. In Connection Wizard create new Container:

   • Name set to “PlatformIO”

   • Stack search for Python stack (not Python3) that is based on Ubuntu OS.

   • Click on “Create” button.

4. Open SSH-Terminal tab (right click on Container (PlatformIO) > SSH Terminal) and install PlatformIO Core using a next command

sudo python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/develop/scripts/get-platformio.py)"

5. Log in to PIO Account using platformio account login command.

Quick Start¶

Let’s create our first PlatformIO-based Codeanywhere Project

1. Initialize new PlatformIO-based Project. Run a next command in a Cloud IDE SSH Terminal:

   platformio init --board <ID>
   
   # initialize project for Arduino Uno
   platformio init --board uno
   

   To get board ID please use platformio boards command or Embedded Boards Explorer.

   If you do not see created project, please refresh Project Tree using right-click on Container Name (PlatformIO) > Refresh.

2. Create new source file named main.cpp in src folder using Project Tree (left side). Please make right click on src folder, then “Create File” and insert a next content:

   #include <Arduino.h>
   
   int i = 0;
   
   void setup() {
       Serial.begin(9600);
       Serial.println("Hello Codeanywhere!");
   }
   
   void loop() {
       /*  serial echo */
       while (Serial.available()) {
           Serial.write(Serial.read());
       }
   
       i++;
       Serial.println(i);
       delay(100);
   }
   

3. If you prefer to work with PlatformIO Core CLI, then you can process project using Cloud IDE SSH Terminal and the next commands:

   • platformio run - build project

   • pio run -t clean - clean project

   • pio remote run -t upload - upload firmware Over-The-Air

   • platformio remote device list - list available devices (OTA Device Manager)

   • platformio remote device monitor - OTA Serial Port Monitor

4. We recommend to hide “Hidden Files”. You can do that via Cloud IDE Menu: View > Show Hidden Files.

Run Button¶

Codeanywhere provides a quick “Run Project” button where you can specify own command. Let’s add “PlatformIO Build Project” command:

1. Open “Project Config” via right click on Container Name (PlatformIO) > Config

2. Set commands field to

   "commands": [
       "pio run"
   ]
   

3. Save configuration file.

Now, try to click on “Run Project” button. You can assign any PlatformIO command to this button.

OTA Device Manager¶

Over-The-Air (OTA) Device Manager works in pair with PIO Remote™. You can list remote devices that are connected to host machine where PIO Remote™ Agent is started or are visible for it.

1. Open Cloud IDE SSH Terminal

2. Paste this command

   pio remote device list
   

OTA Firmware Uploading¶

Over-The-Air (OTA) Firmware Uploading works in pair with PIO Remote™. You can deploy firmware to any devices which are visible for PIO Remote™ Agent.

1. Open Cloud IDE SSH Terminal

2. Paste this command

   pio remote run -t upload
   

OTA Serial Port Monitor¶

Over-The-Air (OTA) Serial Port Monitor works in pair with PIO Remote™. You can read or send data to any device that is connected to host machine where PIO Remote™ Agent is started. To list active agents please use this command platformio remote agent list.

1. Open Cloud IDE SSH Terminal

2. Paste this command

   pio remote device monitor
   

Multi-Project workspace¶

You can have multiple PlatformIO-based Projects in the same workspace. We recommend a next folders structure:

├── project-A
│   ├── lib
│   │   └── readme.txt
│   ├── platformio.ini
│   └── src
│       └── main.ino
└── project-B
    ├── lib
    │   └── readme.txt
    ├── platformio.ini
    └── src
        ├── main.cpp
        └── main.h

In this case, you need to use -d, --project-dir option for platformio run or platformio remote run commands:

• pio remote run --project-dir project-A -t upload build Project-A

• pio remote run --project-dir project-A -t upload upload OTA Firmware

  using Project-A

• pio remote run -d project-B -t upload upload OTA Firmware

  using Project-B

See documentation for platformio remote run --project-dir option.