TS Smart Home Developer SDK: Build Your Own Smart Devices

The TS Smart Home Developer SDK is a C++ firmware framework for the ESP32 microcontroller that allows hardware developers, makers, and businesses to build their own smart devices that integrate seamlessly with the TS Smart Home ecosystem. If you have ever wanted to create a custom smart appliance, an IoT sensor, or a branded smart product — this SDK is your foundation.

What Is the TS Smart Home SDK?

The SDK is a pre-built firmware library that handles all the complex cloud connectivity, authentication, and real-time communication that a smart home device requires. Instead of building this infrastructure yourself from scratch, you write a small amount of device-specific C++ code and the SDK handles the rest.

When you flash your ESP32 with SDK-based firmware, your device automatically gains:

• Wi-Fi provisioning via the TS Smart Home mobile app
• Cloud registration and device identity management
• Real-time relay control through the app and API
• Automatic OTA firmware updates pushed from the TS Smart Home platform
• Schedule execution — schedules set in the app run on the device itself
• Status reporting — online/offline, relay state, error conditions

Who Is the SDK For?

The SDK is designed for:

• Hardware startups building consumer smart home products
• Electronics hobbyists who want their DIY ESP32 projects to work with a polished app
• System integrators adding smart control to industrial or commercial equipment
• Educators and researchers studying IoT connectivity and home automation

Getting Your Developer Token

To use the SDK, you must register as a developer on the TS Smart Home platform and obtain a Developer SDK Token. This token is embedded in your firmware and identifies which developer account your devices belong to.

Steps to get your token:

1. Download and install the TS Smart Home app
2. Create an account if you do not have one
3. Navigate to Account > Developer Portal in the app
4. Fill in the developer registration form with your project details
5. Submit the form — the Techs Solutions team reviews applications
6. Upon approval, your SDK token will appear in the Developer Portal section of the app

Security Note: Treat your SDK token like a private API key. Do not commit it to public repositories. It authenticates all devices you produce, so compromising it would affect all your deployed hardware.

SDK Architecture Overview

The SDK firmware follows a straightforward initialization pattern:

#include "TSSmartHome.h"TSSmartHome device("YOUR_SDK_TOKEN", "DEVICE_MODEL_ID");void setup() { device.begin(); device.onRelayCommand([](bool state) { // Control your relay/output hardware here digitalWrite(RELAY_PIN, state ? HIGH : LOW); });}void loop() { device.loop();}

The SDK takes care of:

• Wi-Fi connection management — reconnects automatically on drop
• MQTT/WebSocket communication with the TS Smart Home cloud
• Command parsing — converts cloud commands into callback triggers
• OTA update handling — downloads and applies firmware updates safely
• Heartbeat reporting — keeps the cloud informed of device health

Key SDK Features

Relay Control Callbacks

Register callback functions that fire when the app or a schedule sends a Turn On or Turn Off command. Your callback receives a boolean and you decide how to control your hardware output.

State Reporting

Call device.reportState(bool relayState) to push the current relay state back to the cloud. This keeps the app in sync with what is physically happening on your device.

Custom Metadata

You can attach a device model ID and firmware version to your device registration. This allows the TS Smart Home platform to manage OTA updates correctly — different device models receive different firmware.

OTA Update Integration

The SDK monitors a firmware update endpoint. When Techs Solutions publishes a new firmware version for your device model, it is automatically downloaded and applied to every deployed unit in the field. This means you can push bug fixes and new features to thousands of devices without any user action.

Development Environment Setup

To start building with the SDK:

1. Install Arduino IDE or PlatformIO (PlatformIO recommended for larger projects)
2. Add ESP32 board support to your IDE
3. Download the TS Smart Home SDK library from the Developer Portal
4. Add the library to your project
5. Write your firmware using the SDK API
6. Flash your ESP32 and pair it through the TS Smart Home app

What You Can Build

The SDK supports any device category that relies on binary relay control or state reporting:

• Smart plugs and power strips
• Smart light switches (single, double, triple gang)
• Smart irrigation controllers
• Relay-based appliance controllers
• Custom IoT sensors with relay output
• Industrial equipment on/off control

SDK Limitations and Roadmap

Current limitations of the SDK:

• Binary relay control only (on/off) — analog outputs and sensor readings are on the roadmap
• Wi-Fi connectivity only — Bluetooth and Zigbee support planned for future releases
• Single relay per device in the current version — multi-relay support coming soon

The TS Smart Home developer ecosystem is growing. If you have specific feature requests, submit them through the Developer Portal feedback form.

Support for SDK Developers

SDK developers have access to a dedicated support channel through the Developer Portal. You can submit technical questions, report firmware bugs, and request new SDK features directly to the Techs Solutions engineering team.

Start building today — the future of smart home hardware is open for everyone.