I am looking for a way to measure temperature and control two 12v (3 pin, no PWM) fans with one device. I think the Pill could do each of the two things (fans via 5-Terminal Add-on/SSR Add-On, temp via DS18B20), but can it do both at the same time?

Wiring:

Shelly => TTL to RS485 module
Out 1 / TX => RX
Out 2 / RX => TX
5V => 5V
GND => GND

TTL to RS485 => Sensor
A => A
B => B

After that, I used the code in the attached file The_Pill_Modbus.js to read the sensor values into the virtual components as follows:
Temp => Number:200
Humidity => Number:201

You can also refer to the attached file “SHT RS485 Modbus-RTU Temperature Humidity Sensor” for more information about the sensor.

Next, I’m going to try writing a standard Modbus function for Shelly The Pill so it can be used with other Modbus RTU devices as well. At the same time, I hope Shelly can develop a Modbus add-on for The Pill — I think that would be an amazing product 😄

The_Pill_Modbus.js SHT RS485 Modbus-RTU Temperature Humidity Sensor.pdf

⚠️ Note: This is a beta firmware version. APIs may be subject to change before the final release.
 

Summary:
This firmware update unlocks The Pill possibility to act as a compact bridge for connecting various third-party sensors and devices to your Home Automation setup!

The newly added Serial Communication (UART) mode allows you to communicate with external hardware using Scripts.  Send/receive data from different peripherals and visualize it using Virtual Components!

Useful for:

• Data gathering: Reading data from sensors and devices, which use UART Communication
• External Control: Sending commands to external controllers and devices.
• DIY projects: Bridging data from your Arduino, Raspberry Pi, or ESP32 projects directly into the Shelly Ecosystem and App.
• Visualization: Reading data into a Virtual Component to monitor status or trigger automations
• Statistics: Use Virtual Devices in Shelly Smart Control for statistics visualization!

Wiring The Pill to external devices:
- IO1: TX -> External Device RX
- IO2: RX -> External Device TX
- GND -> External device GND

Note: The Pill uses 3.3V Logic-levels.

Quick-setup:
1. Select Peripheral mode: Serial communication (UART)
2. Connect your external device (Ensure TX/RX are crossed and GND is connected)
3. Create a Shelly script on The Pill to process the data (see example below)
4. (Optional) Create Virtual components and Virtual Device to display your data in Shelly Smart Control, the WebUI or external systems

Example: Minimal Script

Here is a basic script to get you started:

const BAUD_RATE = 9600; //UART Baud rate: E.g.: 2000000; 1000000; 115200; 

// Obtain a handle to the peripheral 
const uart = UART.get(); 
// Configure 
if (!uart.configure({ baud: BAUD_RATE, mode: "8N1" })) { 
    print("Unable to configure UART"); 
    die(); 
} 
 
// Subscribe for incoming data 
uart.recv(function (data) {   
    print("RX: "+data) 
}); 

// Send message 
uart.write("Hello from The Pill!\n"); 

Showcase
Example configuration & Virtual device visualization with Shelly Smart Control

 

Whats next:
- Use the Virtual component data to trigger Automations via Cloud Scenes, Device Actions or Scripting
- Showcase your use-cases!

ThePill-UART-minimal-example.js

wollte einen neuen H&T BT per BTHome einbinden. Leider klappt das mit der Stable/Beta für die Pill nicht.

Es ist kein Scan möglich und auch kein Hinzufügen per Mac.

Testweise wurde der H&T an einem anderen Gerät erfolgreich gekoppelt.

// ----------------------------------------------------------
// Shelly The Pill – Temperatur-Alarm (Cloud Push + Warnton)
// ----------------------------------------------------------

let TEMP_LIMIT = 30.0;     // °C Grenzwert
let HYST = 1.0;            // Rückkehrschwelle
let CHECK_MS = 1500;       // Polling-Intervall

let alarm = {};
let polling = false;

// ---------- Notification Funktion ---------------------------
function notify(msg) {
  // Cloud Push mit Ton an alle verbundenen Geräte
  Shelly.call("Cloud.SendNotification", {
    title: "⚠️ Temperatur-Alarm",
    message: msg,
    sound: true
  });
}

// ---------- Temperatur prüfen -------------------------------
function checkValue(id, t) {
  if (t === null || typeof t !== "number") return;

  if (!alarm[id]) alarm[id] = false;

  if (t > TEMP_LIMIT && !alarm[id]) {
    alarm[id] = true;
    notify("Temp-Alarm " + id + ": " + t.toFixed(2) + "°C");
    print("ALARM " + id + " = " + t.toFixed(2));
  }

  if (t < (TEMP_LIMIT - HYST) && alarm[id]) {
    alarm[id] = false;
    print("ALARM AUS " + id + " = " + t.toFixed(2));
  }
}

// ---------- Status-Events überwachen ------------------------
Shelly.addStatusHandler(function(e) {
  if (!e.component || e.component.indexOf("temperature:") !== 0) return;

  let id = parseInt(e.component.split(":")[1]);
  let t = null;

  if (e.delta && typeof e.delta.tC === "number") t = e.delta.tC;
  if (e.status && typeof e.status.tC === "number") t = e.status.tC;

  if (t !== null) checkValue(id, t);
});

// ---------- Polling (optional) -----------------------------
function pollSensor() {
  // Bei The Pill ist kein RPC-Sensor verfügbar, Polling hier optional
  // Kann Status-Events ergänzen, falls gewünscht
  if (polling) return;
  polling = true;

  // Polling abbrechen nach 1 Durchlauf (nur Status-Events nutzen)
  Timer.set(CHECK_MS, false, function() { polling = false; });
}

// ---------- Start --------------------------------------------
print("Shelly The Pill Temperatur-Alarm aktiv");
Timer.set(CHECK_MS, true, pollSensor)



Can you please help me, thanks.


BR
KOAL

I created a quick script to better understand the data (json) structure managed by the Pill, but regardless of the way I call the functions, I got a few results.

Clearly, I am doing something wrong. Any idea?

Thanks for the support

Franco

    let info =  Shelly.getDeviceInfo();
    print("INFO: ", info);  /* THIS WORKS */

    let InputStatus = Shelly.getComponentStatus("voltmeter:1"); /* THIS FAIL */
    print("VALORI: ", JSON.stringify(InputStatus)); 
   

   let InputStatus = Shelly.getComponentStatus("input:100"); /* THIS FAIL */
    print("VALORI: ", JSON.stringify(InputStatus)); 
        
    Shelly.call("Input.GetStatus", {id: 1}, function (res) {                /* THIS FAIL */
    print("RISULTATI: ", JSON.stringify(res)); 
    });

The Pill by Shelly : SITE | DOCS (incl. 3.5mm cable adapter)

Plug'n'Play: Temperature sensing

• Temperature sensor DS18B20 - 3.5mm jack - LINK | DOCS

• Splitter 1 to 5 - 3.5mm jack - LINK | DOCS

Peripheral expansion

• 5-Terminal Add-on - LINK | DOCS

• SSR Add-on - LINK | DOCS

• Analog 0-30V Add-on - LINK | DOCS

The Pill_ Usage_Overview.pdf

Pill_Mount_V1.stl

Author: @Olsche

DIN-Rail Mounts

Variant 1) Snap-on

Pill_DIN-Mount_V1 1.stp

Variant 2) Base and clip

Pill_DIN-Mount_V2_Clip.stpPill_DIN-Mount_V2.stp

Author: @Olsche

Accessories

Breadboard Attachment Cover

Exposes the 3x IOs of The Pill. Utilizes a generic microUSB pigtail and 400-points breadbord. Perfect for building custom sensors (DHT22, voltage dividers) or interfacing dev kits (Arduino, esp32, dev modules).

Download LINK: MakerWorld

Author: @terae / License: CC BY 4.0

Cable holder

A generic cable holder that happens to fit the DS18B20 and official 5-Terminal Add-on cables perfectly.
Note: Found online, personally used for different setups.

Download LINK: https://www.thingiverse.com/thing:2481258
License: CC BY 4.0

Have you designed a custom case, mount or accessory? Reply below with your STL/step files or links! Let’s build a library of custom accessories.

Create Air Quality monitor for your Home automation ecosystem! By combining The Pill with the popular Nova SDS011 Sensor, you can monitor PM2.5, PM10, and overall Air Quality.

The newly released beta firmware for The Pill opens the possibility to gather data from external sensors via UART and visualize it natively in the Shelly ecosystem.

Hardware Required

• Device: The Pill by Shelly
• Adapter:  5-Terminal Add-on (for quick wiring, alternative: custom wiring)
• Sensor: Nova PM Sensor SDS011
• Communication: Serial UART

Features

• Visualize: Display real-time PM2.5 & PM10 values in the App and WebUI, using Virtual Components
• Statistics: Get historical charts using the Virtual Devices feature in Shelly Smart Control and Shelly Cloud statistics.
• Automation ready: Use the collected values for in-device automations (Actions, Scripts) or Shelly Cloud Scenes
• Sensor Life: Enhanced communication logic (Measure & Sleep periods) to extend the sensor's lifespan.
• Control: Manually trigger measurements or put the sensor to sleep via a Virtual Switch.

1. Wiring

Connect the 5-Terminal Add-on to the PM sensor as follows:

• IO1 (TX) -> Sensor RX
• IO2 (RX) -> Sensor TX
• 5V -> Sensor 5V
• GND -> Sensor GND

2. Device Configuration

• Open the WebUI of The Pill
• Select Pill Configuration
• Change the Peripheral setup -> Serial Communication (UART)

3. Virtual Components & Groups

Create the following Virtual Components from the device WebUI or using the App:

• PM2.5 - Type: Number, View: Label, Step: 0.1, Unit: µg/m³
• PM10 - Type: Number, View: Label, Step: 0.1, Unit: µg/m³
• Last updated - Type: Text, View: Label 
• Status - Type: Text, View: Label 
• (Optional) Power - Type: Boolean, View: Toggle
• (Optional) Air Quality - Type: Enum; WIth the following options (Key/Title):
  • Key: n_a, Title: N/A
  • Key: good, Title: Good
  • Key: poor, Title: Poor
  • Key: moderate, Title: Moderate
  • Key: very_poor, Title: Very Poor
  • Key: extremely_poor, Title: Extremely Poor

* Statistic: Using Shelly Smart Control you can turn on Statistics for PM2.5 & PM10 components to have nice historical charts of the values!

Virtual Groups

The following Virtual Groups will help you to visually organize the measured values:
- Air quality: Select the components: Air quality, PM2.5, PM10, Last updated
- (Optional) Sensor: Power, Status

* Virtual Devices Tip: Virtual Groups can be Extracted as Virtual Devices in the Shelly Smart Control App

4. The Script

• Go to Scripts -> Create Script
•  Name it "The Pill: Air quality"
• Enter the code below
• Save
• Enable the script on startup.  

Note: The script assumes the Virtual Component IDs match the order created above. If your IDs differ (e.g., number:200), please adjust the configuration at the top of the script.

JS Script Code:
thepill-nova-sds011.shelly.js

(Huge Thanks to L. Milanov  from the FE team for crafting and advancing this scripts!)


5. The Result: Visualization and Visual enhancements

WebUI

Shelly Smart Control

To get historical charts and a polished dashboard look:

1. Enable Statistics for the Virtual Components

• Virtual Components -> Components

• Edit the already created PM2.5 and PM10 components

• Choose type of statistics -> "Measurement"

2. Extract as Virtual Device:

•  Virtual components -> Groups -> Edit the created group

• Toggle "Extract virtual group as a Virtual Device"

• Tip: The first Virtual Device on your account is available for free for all users.

Example customization of the used Virtual Devices in Shelly Smart Control:

6. What's next: Automation Ideas

Unlock the full potential of your Air Quality Monitor by pairing it with other Shelly devices using Shelly Cloud Scenes:

• Smart Air Purifier: Create a Shelly Cloud Scene to automate your Air Purifier using a Shelly Plug S, turning it on automatically when the levels rise.

• Kitchen Ventilation: Monitor air around the kitchen and automatically trigger your absorber/hood using a Shelly 1 when cooking fumes are detected.

Unfortunately are not available the documentation (in the api site) so there are a few questions:

• It has three programmable i/o : do all the three ones be programmed either as analogue or a digital input [i would see an app where two analugue ones would be perfect]? (edit: i read the specifications and says that only inpout one is usable as 1wire or analogue. I see this as an artificial limitation that would forbide the use of the pill in many applications where the UNI was used, so a very negative point)
• You are shipping the device with an adapter to a 3pin jack, and offer the DS18B20 with jack pin. I would see better to offer the DS18B20 with a 5pin [looks as USB B-micro] and offer by default the device with a wire with just a 5 pin female dupont connector (even better a 4+4 pin one, with 3 GND and 2 5V pins). in case you use [the most frequent case] with a temperature sensor, you would not have to add another connector, that is another source of problems, while if you use for other purpose you would have a more versatile connection.
• One thing that i see: the position of connector and the supplied accessory one make the device extremely long. I would have supplied connectors of the "180° bent  version that does not occupy much space in length and allows the output on the same side of input after passing below the device.
• The button is very prominent, it would be useful that after one minute from boot it becomes a normal input. no reengineering necessary, just a code patch.
• The putting on assortment of the Pill has not to be a reason to not issue a Gen3 UNI, retaining its original features. It could also be a PIll with on the output side a USB3.0-B connector, that would retain the compatibility with the pill, and using the extra 4 pins for the 2 outputs and the counter input that now are not available to the pill (so a 6+6 pin on the other end of cable) [I second to have the output MOS or relay unit separate, since it is one field where one size does not fit all]
•  

I am wondering if The Pill could get the pulse counter feature like the Uni Plus. This is unique for any kinds of meters. But Uni is still some kind of a DIY PCB and The Pill is already a real product.

Is Uni really the only Shelly device for this area of home automation solutions?

Thanks!

Alex

I am using the unit to control some accessories on my fish tank with two temperature sensors (one for air and one for water) one digital output via an off the shelf optically isolated relay board to control some low voltage feature lights and an air pump and a second digital output to control a feeding system via an off the shelf optically isolated relay board.

I have staged this and it seems to be working but the logic between the pill and the relays is inverted. When the Shelly digital output is off the relays are on. I was hoping there would be an option to Invert the output state on the pill to fix this but I am unable to find an option for this.

Would this be something that could be added to the firmware in the future? 

ich habe nach einer alternativen Temperaturauswertung gesucht und bin auf die Pille Von Shelly gestoßen und gekauft. Leider ist diese Im Adapter von IOBROKER noch nicht hinzugefügt worden. Wann kann man mit einem aktualisierten Adapter rechnen ?

Liebe Grüße in die Runde

Mathias Vorwerg