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:
- Windows
- Linux
- macOS
OS requirements
Aos SDK supports the next Microsoft Windows versions:
- Windows 10
- Windows 11
Installing tools
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.
OS requirements
Aos SDK tested on Ubuntu distros, other distros should also work. Aos SDK supports the next Ubuntu versions:
- Ubuntu 20.04 LTS
- Ubuntu 22.04 LTS
1. Install required Libraries
Run the following command in the terminal window to install all needed libraries:
sudo apt install libnss3-tools ca-certificates
Update python package manager to avoid compile problems
sudo pip3 install --upgrade pip
2. Install Aos SDK tools
sudo pip3 install --upgrade aos-keys aos-signer aos-prov
3. Install Aos root certificate as trusted
In a terminal execute the following command:
aos-keys install-root
After this command, it is needed to install the Aos Root certificate systemwide. To do this run the following command (as suggested by aos-keys install-root script) :
sudo ~/.aos/scripts/install_aos_root_ca.sh
OS requirements
- Catalina (macOS 10.15)
- Big Sur (macOS 11)
- Monterey (macOS 12)
- Ventura (macOS 13)
Other macOS versions might work, but they are not thoroughly tested.
Installing tools
Python
Download the latest Python from the official website (https://www.python.org/) and install it.
Open a terminal window and run the command to check python version (should be 3.8 or above):
python3 --version
Also, install Python from the official website if you have already installed Python from the Apple repository 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.
Libraries
python3 -m pip install --upgrade aos-keys aos-signer aos-prov
Install Aos root certificate as trusted
In a terminal, execute the following command:
aos-keys install-root