Build Instructions

Collapse

• 1

  Hardware Connections

  The ESP32 board is placed on a breadboard. The soil-moisture sensor is connected via analog mode to pin 32 of the ESP board. The OLED display is set on an I2C bus with SDA and SCL connected to 21 and 22 pins of the ESP board respectively. The required power inputs of 3.3V and GND are given to both the sensor and the display unit.

   

• 2

  Setting up Application on Toit

  We are assuming that you are already familiar with the Toit platform and have your ESP board hooked up with your PC and account. If not, refer to the Quick Start Guide from Toit.

  From the Toit CLI, you first need to install the driver for the SSD1306 OLED display provided in the Toit package registry.
  

  For that, in Toit CLI, open your application directory and run the commands

  $ toit pkg install ssd1306 $ toit pkg install pixel_display

  Next up, we use Visual Studio Code to implement and deploy the application. The program first imports all the necessary libraries. The gpio.adc is required for processing analog inputs from the moisture sensor whereas the i2c library is required for SSD1306 OLED display’s I2C bus output. We also import some fonts needed for our display output.
  

  // Import libraries
  
  import gpio
  
  import gpio.adc
  
  import serial.protocols.i2c as i2c
  
  import i2c
  
   
  
  import font show *
  
  import font.x11_100dpi.sans.sans_24_bold as sans_24_bold
  
  import pixel_display show *
  
  import pixel_display.texture show *
  
  import pixel_display.two_color show *
  
   
  
  import ssd1306 show *

  Next, we initialize signal pins for our sensor and the I2C bus. We scan the bus for connected devices and if no SSD1306 display is found the program will throw an error and put the board to sleep. And if the display is found with that address, the program will initialise it.

  MOISTURE_SENSOR ::= 32
  
   
  
  SCL ::= 22
  
  SDA ::= 21
  
   
  
  main:
  
    // Set up the I2C bus for the OLED display.
  
    bus := i2c.Bus
  
        --sda=gpio.Pin SDA
  
        --scl=gpio.Pin SCL
  
   
  
    devices := bus.scan
  
    if not devices.contains SSD1306_ID: throw "No SSD1306 display found"
  
   
  
    oled :=
  
      TwoColorPixelDisplay
  
        SSD1306 (bus.device SSD1306_ID)
  
   
  
    oled.background = BLACK
  
    sans := Font.get "sans10"
  
    sans24b := Font [sans_24_bold.ASCII]
  
    sans_context := oled.context --landscape --font=sans --color=WHITE
  
    sans24b_context := sans_context.with --font=sans24b --alignment=TEXT_TEXTURE_ALIGN_RIGHT
  
    oled_text := (oled as any).text sans24b_context 130 55 "0.0"
  
  //"oled as any" is necessary

  SSD1306_ID points to the address of 0x3c. If it's different for your display, then replace the variable with your address.

  Now, we initialize some variables to store the input signals from the moisture sensor and convert it to percentages.

  pin := gpio.Pin MOISTURE_SENSOR
  
  sensor := adc.Adc pin

  The following code lines run in a loop and what they do is collect the analog input signal from the moisture sensor, make a linear conversion of it to percentage value and display it on the OLED display. In the next loop cycle, the value is again fetched and updated on the display.

    while true:
  
      val := sensor.get
  
      per := (-41.66666667*val) + 145.833333334 // Linear conversion to percentage.
  
      oled.text sans_context 10 20 "Moisture Reading"
  
      print "Moisture: $(%.2f per) %"
  
      oled_text.text = "$(%.2f per)%"
  
      oled.draw
  
      sleep --ms=500

• 3

  Deploying the Application

  Toit’s VS Code extension has made it super easy to deploy applications to the ESP board on the go. Just navigate to your application directory, open the .toit/.yaml files, click on deploy/run buttons, select your device and you are done!

  See the output on the Toit output (device_name) and Toit logs (device_name)

  Application Video:

View all 3 instructions