Welcome to Xtron’s documentation!

Xtron Pro is a modular console produced by Ovobot.

_images/ovobot.png

First steps

Xtron Pro tutorial

In this tutorial you will learn the basic use of Xtron Pro, download a game from MakeCode Arcade to the device, and create a simple game yourself.

The tutorial is armed at people interested in learning how to make pixel games and apps with MakeCode Arcade and run them on Xtron Pro. No prior experience with programming is required.

The things you will need to follow are a Xtron Pro, a web browser and an Internet connection.

Getting started

Preparing your Xtron Pro

To start, press the Start button of your Xtron Pro to turn it on. Xtron Pro has two program areas, the bootloader area and the user application area. You must first make sure which program is started.

Bootloader

The bootloader is a program to load user application, in the boodloader program, you can download your games or apps to the device, and view the application list in the device storage.

The following interface is the bootloader home, where you will see our website url and button instructions, press Select button to enter application list interface.

In the appliction list interface, you can navigate by press “Up/Down” buttons on the gamepad or “<” button on the core, and press “A” button on the gamepad or “Menu” button on the core to run an application.

User application

A user application is a program that you made using MakeCode Arcade. It can be a game, a watch app or other apps.

The following pictue is the screenshot of falling duck game.

Switch between them

Press Reset button on the core to switch between the bootloader and the user app.

Download a game

Go to MakeCode Arcade

Go to arcade.makecode.com web application, scroll down to the Blocks Games section, select the first one - Falling Duck, then you will see a game introduction card.

Press Open Example button to enter the Editor, where you can code in the Editor, and play the game on the simulator.

Press download button to download the game, scroll down to select the Xtron Pro in the Hardware list page. Then you will get the game file on you computer.

Connect your Xtron Pro

Now connect your Xtron Pro to your computer, and reset it to Bootloader, there will be a drive disk named XTRON on your computer.

The default files in drive disk

The XTRON drive disk contains the following device related files defaultly that don’t show in the bootloader application list:

INFO_UF2.TXT

Basic information of the device, it contains the bootloader version, the model and the BOARD-ID of the device.

CONFIG.BIN

The device configuration file in binary format.

CURRENT.UF2

The current firmware on the device in UF2 format.

INDEX.HTM

The HTML document you click will go to the MakeCode Arcade website.

These files are genarated automatically, and can not be deleted, so keep them.

Copy

Copy the game file to the XTRON drive disk, it will take a while to download the game to the device, the game will execute automatically after the download is complete.

Yes, the download procedure is simple like copy and paste, it not only save the game to the device internel storage, but also upgrade the flash of the MCU on the devce.

WebUSB

In addition to copy and paste, you can also download the game via WebUSB.

This is a new technology that allows your web browser to directly interact with connected devices over USB, meaning that you don’t need to download your uf2 file before flashing it to the Xtron Pro! Also, the games are not stored in the inernal storage, when you need to repeatedly download the game to the device for testing, you can use this method.

Step 1: Click the download option button to the right of the download button to choose hardware.

Step 2: Choose Xtron Pro in the hardware list, and then click the download option button again to connet hardware.

Step3: Select Ovobot Xtron in the pop-up dialog box of the browser and click the connect button.

Make a game

You can use Blocks, Javascipt and Python to make your games on the MakeCode Arcade, the following picture shows how your block code generate a binary firmware runs on your Xtron Pro:

MakeCode Arcade System

You can start making a game from the tutorial or skillmap on the MakeCode Arcade homepage.

Select a tutorial to get started

or

Start from skillmaps

Where to go from here

This is the end of the tutorial. You started by learning the basic use of Xtron Pro and downloading a game to it, following the tutorial to make a game, and then running the game on Xtron Pro.

Here you have some resources to continue learning about Xtron Pro and MakeCode Arcade.

  • You can learn more about the functionality of Xtron Pro by going over our Xtron Pro features page.

Hardware

Block Diagram

Xtron Pro is composed of core and gamepad, the core is the programmable unit, and the gamepad is a peripheral. when they are connected together, it becomes a programmable game console, The core can be connected to the gamepad in two ways, portrait and landscape, so you can build games in either orientation.

The core can also work alone, and it can be turned into a watch after putting on the silicone shell, you can make your own watch applications.

There is an 8-pin pogopin connector on the back of the core. In addition to the handle, it can also connect to many other peripherals.

Specifications

Specifications

Description

MCU

Model

STM32F412

Frequency

100MHz

SRAM

Size

256KB

Flash

Size

1MB

Extenal Flash

Capacity

128M-bit

SPI Clock

133MHz

RTC IC

Model

DS1330

Backup Battery

0.3F Super Capacitance

IMU

Model

MPU6887

Gyroscopes Range

+/- 2000 °/s

Accelerometer Range

+/- 16g

Screen

Type

TFT

Size

1.8”

Resolution

160 x 128

Size

82 x 53 x 22 mm

Button

2 Touch Buttons, 8 Physical Buttons

Vibration Motor

14000 rpm

Speaker

Type

Moving Coil

Rated Power

0.7W

Radio Module

Model

ESP32

PSRAM

64M-bit

Flash

16M-bit

Micophone

Model

4015

Sensitivity

-30dB

Directivity

Omnidirectional

Connectors

USB-C, 4PIN Port, 8PIN Pogopin, Jacdac Phone Jack

Battery

Lipo, 500mAh

Weight

70g

Diagram

  1. The Core

  2. The GamePad

  3. Power button

  4. Reset button

  5. Light sensor

  6. LED indicator

  7. C button

  8. Menu Button

  9. Direction buttons

  10. A, B buttons

  11. Pogopin connector

  12. USB Type-C

  13. I2C connector

  14. Jacdac connector

Xtron Pro features

Xtron Pro has many hardware resources available for programming, you can use these hardware resources to make games, create a watch, or do some creative projects.

MakeCode Arcade

Xtron Pro was born for MakeCode Arcade platform, which is a famous retro game editor usding Blocks, Javascipt and Python language. It is very suitable for children to learn programming, there are many tutorials and skillmaps for getting started. Of course, it is also suitable for some game lovers and makers who want to make their own games.

You can run the MakeCode Arcade games on the simulator, it is very covenient when you are developing a game, you can get responce and optimize your program immediately. You can share your game when you have completed it.

Xtron Pro offers many hardware resources for you to make a game, you can use the IMU sensor to make a gravity sensing game, or connect two Xtron Pros to develop a multiplayer game, and it is ideal for running MakeCode Arcade games.

Magnetic Modular Design

  • 竖屏飞机大战

  • 俄罗斯方块

Store Multiple Apps

Built-in IMU Sensor

  • 体感游戏

Real Time Clock

Xtron Pro is built-in a real-time clock (RTC) ic, which is a low power clock/date device with a programmable time-of-day alarm and a programmable interupt output.

The RTC ic is connected to the mcu of Xtron Pro with I2C bus and a interupt line. The mcu can communicate with the ic through the i2c bus, and the interupt line is for alarm use.

With the RTC function, You can make a watch application to run on the Xtron Pro. Once you calibrate the time, it will run even if you turn off the device.

You can import pxt-xtronpro-rtc extension to MakeCode Arcade to add a RTC catogory in the toolbox, it has a bunch of blocks for real-time clock.

Learn more about Real Time Clock

Wi-Fi Module

IoT

Speech Recognition

Expansions

Emulator

Micropython

Extensions for MakeCode Arcade

Extensions are MakeCode dynamic/static library mechanism for extending a target, such as the pxt-arcade. Xtron Pro has many features that MakeCode Arcade don’t support by default, so you should load a specific extension when you need that feature.

Use the Extension

The extension can be added to MakeCode Arcade.

  • open https://arcade.makecode.com/

  • click on New Project

  • click on Extensions under the gearwheel menu

  • search for github repository link of the extension and import

pxt-xtronpro-util

As the name says, this extension has a bunch of utilities for Xtron Pro, includes additional buttons and step counter. This extention will add two more button options (C and start) to on [A] button [pressed] and is [A] button pressed blocks and a steps block in the Extra section under the Controller category in the toolbox.

Import this extension with the URL:

Learn more about [pxt-xtronpro-util]

pxt-xtronpro-rtc

This extension is for Xtron Pro’s real-time clock function, which is a low power clock/date device with a programmable time-of-day alarm and a programmable interupt output.

This extension has a bunch of blocks for real-time clock, including blocks to get/set time and alarm. This extension will add a new category called RTC in the toolbox and and add two menus for setting the time and alarm in the menu interface.

Github repository link: https://github.com/tsunyi/pxt-xtronpro-rtc

Learn more about pxt-xtronpro-rtc

FAQs

Use the NES emulator

Xtron Pro currently can only run the NES emulator, we are working on its new features, including running more simulators, micropython and tensorflow, etc.

More

Update the bootloader firmware

  • Click here to get the latest version of the Bootloader.

  • Connect your Xtron Pro to your computer with the USB-C cable, and enter it to Bootloader mode.

  • Drag the downloaded bootloader firmware to the XTRON drive, which is the same as the method of downloading game firmware.

  • You have the latest Bootloader, then reset to Bootloader and reload your program.

Format the Device Intenal Storage

The Xtron Pro bootloader file system may be damaged due to some reasons. At this time, you need to format the file system to solve the issue.

Press the up (1), right (2), menu (3) buttons as shown in the figure below at the same time, and then press the reset (4) button, the green light will keep flashing during the formatting process, which will last about 30 seconds.

After the format is complete, the green light stops flashing, and the bootloader home interface will be displayed.

Xtron Pro feature overview

MakeCode Arcade

Real Time Clock

The real-time clock is one of the main functions of Xtron Pro. Xtron Pro is composed of the core and the gamepad, the core can work as a watch with a silicone case. With the real-time clock function, you can write basic clock applications.

The real-time clock is a low power clock/date device with a programmable time-of-day alarm and a programmable interupt output. To use of the RTC function, first you should load pxt-xtronpro-rtc extension to MakeCode Arcade, which will add a RTC catogory in the toolbox.

Example

The following example will display the time, date and alarm on the screen.

Click the below link you will go to MakeCode Arcade simulator, which will show the example, then click the Edit Code button to open the Editor to modify or download the example.

RTC Example

Tutorial

Click the below tutorial link to make your own watch application.

Tutorial

API

time

Returns the selected item of the time in decimal number.

Learn More

stringFormatTime

Get time in string format.

Learn More

setTime

Set the time of the RTC.

Learn More

setAlarm

Set the alarm time of the RTC.

Learn More

onEvent

Run some code when the alarm time is up.

Learn More

clearAlarmStatus

Clear alarm interrupt status, it is alway used in alarm onEvent function, if you forget to use it, the alarm can only fire once even though in repeat mode.

Learn More

alarm

Returns the selected item of the alarm time in decimal number.

Learn More

stringFormatAlarm

Get alarm time in string format.

Learn More

alarmRepeatMode

Get the alarm repeat mode of the RTC.

Learn More

isAlarmOn

Get the alarm On/Off status.

Learn More

Community and Social Media

  1. Discord

  2. Instagram

  3. Twitter