Creating a Unit physically

Configuring the environment

Open the Unit modal window and click the green Set Env Variable button; you will see the variables that need to be filled in.

Usually, Unit Developers preconfigure them for correct operation of the Unit, but some of them, such as WIFI_SSID and WIFI_PASS, must be filled with your own values.

You can find hints about the functional purpose of each variable by clicking the remote repository link Documentation Link; there, Unit Developers usually describe the meaning of each variable.

After you click Update, the variables you added will be saved.

INFO

Environment variables are stored in an encrypted form.

WARNING

The reset button allows you to reset the variables to the state provided by the Unit Developer. This state is the result of the env generation algorithm.

DANGER

Until you click Update, the system variables with the PU_ prefix will be regenerated every time the variables are requested. After clicking Update they become fixed.

Getting deployment files

Depending on whether your Repo is Compilable or not, the process of obtaining files will differ:

Compilable Repo

You need to download two components of your future Unit:

1. The compiled part from the Compiled Firmware Platforms tab, which contains links to platforms for the current target version of the Unit.
2. An archive from the Firmware with env.json and schema.json tab.

You must place the files from the archive in the same directory as the platform you selected so that they can see each other.

Interpretable Repo

It is enough to download the archive from the Firmware with env.json and schema.json tab — it will contain all the files you need. After extracting the archive, you will be ready to move to the next stage.

INFO

For Micropython you must first install the interpreter on the physical Unit.

First deployment

Typically, you need to upload the files obtained in the previous step to your physical device and satisfy its startup conditions.

For microcontrollers such as esp32, stm ..., you need to upload the files into flash memory and start the device by pressing the reset button.

For Desktop applications it is usually enough to run the binary file or invoke the required file via the interpreter command.

WARNING

There cannot be a universal rule here, because Units can be very different. Usually Unit Developers leave instructions on how to make the Unit work correctly in the repository Readme of the Git project.