Terra customization: ESP8266 Basic customization

In this page we present a customization, called TerraEsp, that is a very light customization for ESP8266-12F Board using only simple radio communications and GPIO.

TerraEsp - Basic Operations

This Terra customization mainly provides only very basic "send" and "receive" events and GPIO operations. Table 1 presents the current TerraEsp events interface and Table 2 presents the functions interface.

Some code examples are presented at the end.

The local operations comprises operations to access input and output devices of the microcontroller. Terra encapsulates all these operations in a component called Local Operations providing them as input and/or output events. Timers, on the other hand, are handled directly by the Céu-T language with the await time command.

The SEND() command is a basic send command where only the nodes in the local network may receive the message. If the field target is set to BROADCAST value, all nodes in the local network will receive the message. On the other hand, if this field is set to a specific node identifier, only this node will receive the message (if the node is in the local network). A SEND_DONE() event indicates that the send request was processed by the radio. The RECEIVE event returns a received message. A variation of the SEND() command is the SEND_ACK() command that requests an acknowledgement from the target mote. In this variation the SEND_DONE_ACK() event return a boolean value indicating the acknowledgement. Additionally, TerraEsp implements a simple message queue to support message buffering needs.

The user must define the radio message data structure before create a message variable.

Events definitions

Available functions

Constant definitions

Code samples

Digital Pin - Blinking the Led connected in the GPIO12

#include "TerraEsp.defs"
pinMode(GPIO12,OUTPUT);   // GPIO12 pin as output
loop do
    await 500ms;          // Waits 0,5 seconds
    pinToggle(GPIO12);    // Toggle LED value
end

Interrupt Pin - Trigger a GPIO interruption

Connect a push button to GND and GPIO5. Connect a 10Kohms resistor to 3.3v and GPIO5. The LED at GPIO12 will toggle once when you press the button. Do nothing when releasing it.

#include "TerraEsp.defs"
pinMode(GPIO12,OUTPUT);          // GPIO12 pin as output
pinMode(GPIO5,INPUT);            // GPIO5  pin as input
intPinConfig(GPIO5,INT_NEGEDGE); // GPIO5 Interrupts from 1 to 0.
intEnable();                     // Enable all GPIO interruptions.
loop do
    await GPIO_INT();       // Waits for any configured GPIO interrupt.
    pinToggle(GPIO12);      // Toggle the LED status
    await 30ms;             // Debouncing: Waits some time before next Interruption.
end