Portal Basics
7 minute read
The motorcortex.io portal is where you store your projects, run test machines, and reach the browser tools that configure and monitor a controller. This page walks the portal’s navigation so you know where each task lives.
You need an account to log in. Request a trial through the Motorcortex contact page; accounts and projects live at app.motorcortex.io.
Logging in opens the Projects page. The sidebar groups everything else, and the tabs below follow that grouping in the same order — Main first, then Tools, Administration and your account.
The sidebar’s last group, Links, points outward: Docs to this documentation site and Support to the Motorcortex support forum, where you can ask a question and read what other users have run into.
Three controls sit outside the sidebar groups. The top bar carries a global search (Ctrl K), the storage gauge for your organisation, and a bell that opens the notification list. Your own account sits at the foot of the sidebar.
Your projects
The Projects page lists every project you can reach, with its version, owner and last-modified date. Sort by any column, search by title, and use View to choose which columns show.
To create a project, click Add Project and fill in the title, description and version; an image is optional. The … button beside it holds the two other ways in — From store installs a ready-made project, and Upload project takes a .proj file from your PC.
Tip
Starting from a store project is usually faster than an empty one: it arrives with the package structure already in place.
Inside a project
Opening a project shows its contents split into Directories and Files. Packages appear as directories with a Type — binary, config, grid or home — and their own version.
A Motorcortex application is built from three of these: a binary package with the compiled real-time application, a config package with its configuration, and a grid package with the user interface. The Project Packages chapter covers each one.
Adding and getting things out
Everything you add or export sits behind the … Actions menu at the top right.
| Entry | What it does |
|---|---|
| New ▸ Package | Creates an empty grid, config, home or binary package |
| New ▸ Item | Creates a directory or a file |
| New ▸ From store | Installs a package or file from the Asset Store |
| Upload ▸ | Uploads files, a folder, or a packaged project from your PC |
| Download | Downloads the whole project to your PC |
| Share | Opens the project’s sharing settings |
Fetch config sits next to that menu as its own button. It reads the configuration currently active on a controller and stores it in the project, which is the reverse of deploying. Bulk actions applies an action to the rows you tick, and each row has its own download button and ⋮ menu.
Virtual machines
Machines lists the virtual controllers your organisation runs. A virtual machine gives you a Motorcortex controller to deploy to and test against without hardware.
Two counters sit at the top. VM slots is how many machines you have against the maximum, and Credits is the running budget the machines draw from. Both are shared across everyone in your organisation, as the line beneath them states.
Working with a machine
Each machine shows its name, state, hostname, the image version it runs, and its owner. The hostname ends in .virtual.motorcortex.io and is what you point a browser tool or a client application at.
The buttons on the card cover the machine’s life cycle:
| Button | What it does |
|---|---|
| Start | Boots a stopped machine |
| Stop | Shuts the machine down, keeping its slot |
| Restart | Reboots the machine |
| Clone | Creates a copy of the machine |
Warning
Stopping or restarting a machine interrupts anything deployed on it, including a running control application.
New machine creates another one, which takes a free VM slot.
The Asset Store
The Asset Store holds the ready-made assets you install into a project or download to your PC — complete application projects, and the operating-system images and SDK you need to set up a controller or a development machine.
Every item carries a Category, a Type and a Version. Two categories are in use:
| Category | Holds |
|---|---|
applications |
Complete application projects — the Robot, Machine, AGV and Centaur apps in their several kinematic variants |
os images & sdk |
Controller OS images, a virtual-machine appliance, and the cross-development SDK |
Filter the list by category or type with Filter, choose columns with View, or search by title.
Getting an item
Each row’s … menu downloads the item. To install one straight into a project instead, open the project and use Actions ▸ New ▸ From store, which offers the store’s packages and files in place.
An applications item of type project becomes a whole new project: use Actions ▸ From store on the Projects page.
Motorcortex Desk
Desk opens desk.motorcortex.io, a plotting and parameter tool that runs in the browser independently of the portal. It starts disconnected: enter a controller’s address in its Connection panel and click Connect, then plot live signals, read and write parameters, measure, and export traces as CSV.
Because Desk connects on your behalf, it works against a physical controller and a virtual machine alike. Motorcortex Desk covers it in full.
Motorcortex ECAT
Ecat opens ecat.motorcortex.io, the tool that scans an EtherCAT network and configures the devices on it. See Motorcortex ECAT.
ESI Database
ESI Database lists the EtherCAT Slave Information files the portal knows about, by vendor, with the number of devices each file describes. Entries marked Public are available to every organisation.
Filter and search the list to check whether a device you plan to use is already described. Actions holds the operations on the database itself.
Dashboard
The Dashboard reports what your organisation is using against what its subscription allows. It is about the organisation, not about you — your own settings live in the account menu.
Usage Stats shows the number of users and projects against their limits, the subscription plan, and the date the subscription runs until. Limits depend on the plan.
Storage shows how much space the organisation’s projects occupy, the maximum, and the percentage in use. The same percentage sits in the top bar on every page.
Note
Once storage is full you cannot add files or packages to a project. Delete what you no longer need, or download it and remove it from the portal.
Recent logins lists who logged in and when.
The account menu
Your account sits at the bottom of the sidebar, showing your name and email. Clicking it opens the menu.
| Entry | What it opens |
|---|---|
| Settings | Your profile, security, password and appearance settings |
| Subscriptions | The organisation’s subscription |
| Send feedback | A form for reporting a problem or a request to Motorcortex |
| Log out | Ends the session |
Settings
Settings has four sections.
| Section | Covers |
|---|---|
| Profile | Your avatar, email address and name |
| Security | Account security. Re-enter your password to open it |
| Password | Changing your password |
| Appearance | Light, dark, or follow the system theme |
A new password must be at least 12 characters, no more than 72, and is checked against known breached passwords when you submit it. The form can suggest one for you.
Notifications
The bell in the top bar lists announcements about portal releases and services, newest first, with View all notifications at the foot of the list for the full history.
Next: Project Packages — what goes inside a binary, config and GRID package.