Sming is an asynchronous embedded C++ framework with superb performance and multiple network features. Sming is open source, modular and supports multiple architectures including ESP8266, ESP32 and RP2040.
If you like Sming, give it a star, or fork it and contribute!
Sming supports multiple architectures and has a plethora of features. Choose the architecture of your choice to install the needed development software.
You can also try Sming without installing anything locally. We have an interactive tutorial that can be run directly from your browser.
The purpose of Sming is to simplify the creation of embedded applications. The documentation will help you get started in no time.
- Documentation for version 5.2.0 - current stable version.
- Documentation for latest - development version.
- Sming V5.2.0 - great new features, performance and stability improvements.
To follow the latest development you will need to clone our develop branch:
git clone https://github.com/SmingHub/Sming.gitThe examples are a great way to learn the API and brush up your C++ knowledge. Once you have completed the installation of the development tools, you can get the latest source code:
git clone https://github.com/SmingHub/Sming.gitAnd check some of the examples:
- Basic Blink
- Simple GPIO input/output
- Start Serial communication
- Connect to WiFi
- Read DHT22 sensor
- HTTP Client
- OTA Application Update
- HTTP Server
- Email Client
Blinking is something like the "Hello World" example for the embedded world. You can check it using the commands below:
cd Sming/samples
cd Basic_Blink
make # -- compiles the application
make flash # -- tries to upload the application to your ESP8266 device.More information at Sample Projects page.
#define LED_PIN 2 // GPIO2
...
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, HIGH);For a complete example take a look at the Basic_Blink sample.
Serial.begin(9600);
Serial.println("Hello Sming! Let's do smart things.");WifiStation.enable(true);
WifiStation.config("LOCAL-NETWORK", "123456789087"); // Put your SSID and password here#include <Libraries/DHTesp/DHTesp.h> // This is just a popular Arduino library!
#define DHT_PIN 0 // GPIO0
DHTesp dht;
void init()
{
dht.setup(DHT_PIN, DHTesp::DHT22);
float h = dht.getHumidity();
float t = dht.getTemperature();
}Take a look at the code of the Humidity_DHT22 sample.
HttpClient thingSpeak;
...
thingSpeak.downloadString("http://api.thingspeak.com/update?key=XXXXXXX&field1=" + String(sensorValue), onDataSent);
void onDataSent(HttpClient& client, bool successful)
{
if (successful) {
Serial.println("Successful!");
}
else {
Serial.println("Failed");
}
}For more examples take a look at the HttpClient, HttpClient_Instapush and HttpClient_ThingSpeak samples.
void doUpgrade()
{
// need a clean object, otherwise if run before and failed will not run again
if(otaUpdater) {
delete otaUpdater;
}
otaUpdater = new Ota::Network::HttpUpgrader();
// select rom partition to flash
auto part = ota.getNextBootPartition();
// The content located on ROM_0_URL will be stored to the new partition
otaUpdater->addItem(ROM_0_URL, part);
// and/or set a callback (called on failure or success without switching requested)
otaUpdater->setCallback(upgradeCallback);
// start update
otaUpdater->start();
}For a complete example take a look at the Basic_Ota sample.
server.listen(80);
server.paths.set("/", onIndex);
server.paths.set("/hello", onHello);
server.paths.setDefault(onFile);
Serial.println("=== WEB SERVER STARTED ===");
Serial.println(WifiStation.getIP());
...
void onIndex(HttpRequest &request, HttpResponse &response)
{
TemplateFileStream *tmpl = new TemplateFileStream("index.html");
auto &vars = tmpl->variables();
vars["counter"] = String(counter);
vars["IP"] = WifiStation.getIP().toString();
vars["MAC"] = WifiStation.getMAC();
response.sendTemplate(tmpl);
}
void onFile(HttpRequest &request, HttpResponse &response)
{
String file = request.getPath();
if (file[0] == '/')
file = file.substring(1);
response.setCache(86400, true);
response.sendFile(file);
}For more examples take a look at the HttpServer_ConfigNetwork, HttpServer_Bootstrap, HttpServer_WebSockets and HttpServer_AJAX samples.
SmtpClient emailClient;
emailClient.connect(Url("smtp://user:password@domain.com"));
MailMessage* mail = new MailMessage();
mail->from = "developers@sming";
mail->to = "iot-developers@world";
mail->subject = "Greetings from Sming";
mail->setBody("Hello");
FileStream* file= new FileStream("image.png");
mail->addAttachment(file);
emailClient.onMessageSent(onMailSent);
emailClient.send(mail);
...
int onMailSent(SmtpClient& client, int code, char* status)
{
MailMessage* mail = client.getCurrentMessage();
...
if(!client.countPending()) {
client.quit();
}
return 0;
}
See the SmtpClient sample for details.
Applications based on Sming Framework that are flashed and running on an ESP8266 device can be debugged using interactive debuggers. In order to debug an application it has to be re-compiled with the ENABLE_GDB=1 directive. And then flashed on the device. As shown below:
cd $SMING_HOME/../samples/LiveDebug
make clean
make ENABLE_GDB=1
make flashapp # <-- this will update only the application firmware.Once the debuggable application is flashed on the device the developers have to run GDB. The easiest way to run the command-line GDB is to execute the following command:
make gdbDevelopers using Eclipse CDT can have debugging sessions like the one below:
See LiveDebug sample for details.
You can contribute to Sming by:
- Providing Pull Requests with new features, bug fixes, new ideas, etc. See Contributing for details.
- Testing our latest source code and reporting issues.
- Supporting us financially to acquire hardware for testing and implementing or out of gratitude
We welcome financial contributions in full transparency on our open collective page. They help us improve the project and the community around it. If you would like to support us you can become a backer or a sponsor.
In addition to that anyone who is helping this project can file an expense. If the expense makes sense for the development of the community, it will be "merged" in the ledger of our open collective by the core contributors and the person who filed the expense will be reimbursed.
Thank you to all the people who have backed Sming
or sponsored it.
