Windows Installation

This page describes how to install the required tools and obtain the current release version of Sming using the Chocolatey package manager.

Use Manual Windows Installation for control over installation locations.

Install Chocolatey

Open an administrative cmd.exe command prompt and paste the text from the box below and press enter:

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin

Upgrade .NET

Choco requires a recent version of .NET in order to be able to access HTTPS links. To check if you need to upgrade, type the following command:

choco --v

If you see a warning similar to the one below then make sure to upgrade your .NET version:

Choco prefers to use TLS v1.2 if it is available, but this client is running on .NET 4.3,
which uses an older SSL. It's using TLS 1.0 or earlier, which makes it susceptible to BEAST
and also doesn't implement the 1/n-1 record splitting mitigation for Cipher-Block Chaining.
Upgrade to at least .NET 4.5 at your earliest convenience.

You can upgrade the .NET version from this direct link or search in internet for “.NET upgrade”.

Install packages

First, tell Chocolatey about the Sming package repository:

choco sources add -name smingrepo -source 'https://www.myget.org/F/sming/'

(You can find the installer sources at https://github.com/slaff/chocolatey-packages.)

You can now install with:

choco install -y sming

Packages are as follows:

git

GIT CLI client.

Please configure after installation to leave line-endings intact or else patching will fail:

git config --global core.autocrlf input
python

Python version 3.

cmake

CMake.

Required to build some Components, also for Host mode.

mingw

MinGW 32-bit.

The installer updates the system PATH but please check by running:

where make.exe

The output should show only one result:

"C:\MinGW\msys\1.0\bin\make.exe"
esp8266-eqt

ESP Quick Toolchain.

Sets a system-wide ESP_HOME variable.

sming.core

Latest stable version of Sming.

Sets a system-wide SMING_HOME environment variable.

Note that setting SMING_HOME and ESP_HOME as system-wide variables means they do not need to be set every time a command prompt is opened, and will be seen by eclipse without any further configuration.

Important

After installation, please close the administrative command prompt and open a new, regular command shell.

This ensures that environment variables are set correctly.

It is also inadvisable to continue running with elevated privileges.

Update Sming

Sming is very dynamic and updates are usually announced in gitter. The command below will get for you the latest stable release:

cd %SMING_HOME%
git pull

If you would like access to the latest features and bug-fixes, use the develop branch:

cd %SMING_HOME%
git checkout develop

Force Reinstall Sming

In case something is broken, this will perform a forced re-install of all packages:

rmdir /s /q c:\tools\sming
choco install sming -y -f -x

Next steps

Proceed to Configuring your Esp8266 device.