This page has no translation to 中文 yet. The original English version is below. If you’d like to help, great! See how to translate a documentation page in the contribution guide.
Note This is a web-version of a tutorial chapter embedded right into the XOD IDE. To get a better learning experience we recommend to install the desktop IDE or start the browser-based IDE, and you’ll see the same tutorial there.

Interactive Session

Screenshot of 102-interactive

As you run the simulation, you can run an interactive session on the board also known as debugger. Tweaks and watches go live while running the program on physical hardware.

Exercise #

Let’s control our LED in real time.

  1. Connect the Arduino board to your computer.

  2. Upload the program with the interactive session enabled: hit Deploy → Upload to Arduino and check “Debug after upload”.

  3. Once the interactive session has been started, select tweak-boolean and change its value; see how the built-in LED on the board reacts to these changes.

To stop the interactive session press “Stop” button on the green panel above. To start the interactive session again, you have to re-upload the program.

👆 Shortcut #

Click the button with a bug icon in the deployment pane below. To quickly access the upload dialog with “Debug after upload” checked.

Debug protocol #

During interactive sessions XOD IDE and the board keep connection open and exchange with messages about value changes. These message are simple plain-text lines and you can see them in the Serial tab of the Deployment pane.

Click the funnel icon and make sure “Watched Values” is checked. To echo the messages to the log.

Found a typo or mistake? Want to improve the text? Edit this page on GitHub and open a pull request. If you have a complex proposal or you want to discuss the content, feel free to start a new thread on XOD forum.