Skip to main content

1. Set up your host

To use virtual machines for emulating AosEdge connected device units you need to enable the Virtualization in your BIOS. Please refer to the documentation of your PC to do this.

Next OS are supported:​

macOS

  • Catalina (macOS 10.15)
  • Big Sur (macOS 11)
  • Monterey (macOS 12)

Next tools should be installed:

  • Python 3.7+ installed on your system.
  • Git installed on your system.
  • VirtualBox 7+

Supported desktop browsers

  • MS Edge - AosEdge team recommends using this browser under MS Windows.
  • Google Chrome
  • Apple Safari
  • Opera
  • Firefox

Other browsers not listed in the section "unsupported" might work but have not been tested.

Follow the instructions for your operating system:

OS requirements​

Aos SDK supports the next Microsoft Windows versions:

  • Windows 10
  • Windows 11

Installing tools​

Install VirtualBox​

Refer to official site on instruction on how to install VirtualBox: https://www.virtualbox.org/

Python​

Download the latest Python from the official website (https://www.python.org/) and install it.

Important! During the installation process on the options screen select "Add Python 3.xx" to the PATH checkbox (as shown in the screenshot below).

Press "Install Now" to proceed with the installation.

To verify installation open a terminal window and run the command to check the python version (which should be 3.8 or above):

python --version

Also, install Python from the official website if you have already installed Python from the Microsoft Store or you do not know the source of Python installation. This prevents possible errors during python package installation and issues related to the environment variables.

Install libraries​

Run the following command in the terminal window to install all needed libraries:

python -m pip install --upgrade pip

Install Aos SDK tools​

In a terminal execute the next command:

pip install --upgrade aos-keys aos-signer aos-prov

Install Aos root certificate as trusted​

In a terminal execute the next command:

aos-keys install-root

MS Windows might ask approvement to install the root certificate (if it does not present on the system):

Press "Yes" to allow installation.