Corella User Reference Manual

This document is available in PDF format : LO-RES (537KB) : MID-RES (1.1MB) : HI-RES (2.4MB)

  1. Functional Description
  2. Quick Setup
  3. Hardware
    1. Absolute Maximum Ratings
    2. Electrical Characteristics
    3. Pinout
    4. Mechanical Outline
    5. Low Power mode
    6. Compatibility with Popular Development Systems
  4. Data
    1. Serial Port Set Up
    2. Corella Packet Format
  5. AT Commands
    1. AT (Attention)
    2. AT+STATUS
    3. AT+SEND
    4. AT+VERSION
    5. AT+ID
    6. AT+DIAGNOSTICS
    7. AT+LEDS
  6. Serial Communication Example
    1. AT
    2. Status
    3. Send Packet
    4. Version
    5. Diagnostics
    6. ID
    7. LEDS
  7. Application Examples
    1. Raspberry Pi Setup
    2. Arduino Setup

1. Functional Description

The Corella Low Power Wide Area Network (LPWAN) module allows developers to connect a range of IoT devices to the Taggle network.

The Taggle network is an LPWAN solution based on world leading Australian developed technology operating in the 916-928MHz Low Interference Potential Device (LIPD) class licence band, which has been developed by Taggle Systems to provide one of the lowest cost, lowest power, longest range, and highest capacity LPWAN solutions available. The Taggle network is based on one-way transmissions from endpoint nodes to the Taggle receiver network, and is particularly well suited to battery powered endpoint applications with low data rate requirements, such as automatic meter reading, wireless sensors for smart agriculture and environmental monitoring, and cost sensitive smart city applications.

Corella is based on the popular XBee module format, and provides a single serial port with a simple "AT" command style interface to allow rapid integration of the module into both lab prototypes and volume production IoT devices. The module has a single radio transmit output via an SMA connector, and can be supplied with a 2dBi - wave dipole antenna to enable rapid connection to the Taggle network.

All receive functions are handled seamlessly by the Taggle network, with the user's receive data presented via a custom web portal. A range of data plans are available depending on the number of endpoints connected to the Taggle network and the frequency of messages per endpoint.


2. Quick Setup

  1. Firmly screw on antenna.
  2. Connect device through correct pins, refer to section 3.3
    1. When powered, observe the green power LED indicating a power connection.
  3. Press TX test button to transmit a Taggle test packet.
    1. Observe the flashing Blue LED which indicates payload is transmitting and should deactivate after roughly 10 seconds.
    2. Once the blue LED has stopped flashing this indicates the transmit period has concluded and Corella is now ready to transmit another packet. Note that while the blue LED is flashing Corella's Tx functionality is withheld and any send commands will not be processed.
    3. Note: Wait time remaining can be queried through serial communication using simple AT commands outlined in Section 5, AT Commands.
  4. Go to the Corella Data Portal and input the user name/Taggle ID and password provided with the Corella unit.
  5. Check to confirm your first data packet. This may take up to 15 seconds to process.

3. Hardware

3.1. Absolute Maximum Ratings

voltage The revision A Corella module is compatible with 3.3V systems only.

Connection to 5V systems such as Arduino or Beagle Bone will require an interface shield to provide appropriate IO level translation and power supply regulation.

Symbol Parameter Min Max Unit
VDD Supply Voltage 3.8 V
DIN Data input -0.3 VDD + 0.3 V
DOUT Data output -0.3 VDD + 0.3 V
RST Reset input -0.3 VDD + 0.3 V
Table 1 Absolute Maximum Ratings

3.2. Electrical Characteristics

Symbol Parameter Min Nom Max Unit
VDD Supply Voltage 2.8 3.3 3.8 V
VIL Voltage input low 0.3* VDD V
VIH Voltage Input High 0.7* VDD V
VOL Voltage output Low 0.3* VDD V
VOH Voltage output High 0.75* VDD V
TAMB Operating Temperature Range* -20 25 70 °C
IA Awake current 2.2 2.4 mA
ITx Transmit Current 95 110 mA
Iq Quiescent Current TBA 6 uA
Table 2 Electrical Characteristics

* Electrical characteristics measurements were taken in low power mode refer to section 3.5. Nominal sleep current in default mode is approximately 1.5mA

3.3. Pinout

bottomview
PIN SYMBOL DESCRIPTION
1 3V3 Power Supply Input
2 DOUT Data Output.
3 DIN Data Input.
4 None Not Connected
5 RST Reset Input Active Low
6-9 None Not Connected
10 GND Ground
11-20 None Not Connected
L1
L3
L5
LINK 0
LINK 1
LINK 2
General purpose Input pins.
Not supported in Revision A.
Table 3 Corella Pinout

3.4 Mechanical Outline

mech

Figure 2 Corella Dimensions

3.5. Low Power mode

The default configuration will nominally consume 1.5mA during sleep mode. The main power draw is from the green power LED and the voltage overload protection circuit. These features can be disabled by removal of the two jumper resistors shown below. This will significantly reduce the power consumption resulting in a nominal sleep current of approximately 2uA.

Removal of the jumper resistor J1 shown in Figure 3 will deactivate the green power led and reduce Corella sleep current to approximately 95 uA. Deactivating the flashing red and blue LEDs can be achieved through AT commands, referred to in section 5.7 AT+LEDS .

j1
Figure 3 - Power LED resistor

Resistor J2 links enables the voltage protection circuit, which has a leakage current of approximately 93 uA. Removal of J2 will prevent leakage current and significantly reduce power consumption resulting in a sleep current of approximately 2.2uA.

voltageCaution should be taken when removing J2 as the device will
no longer be protected from over voltage on the power supply input.

j2
Figure 4 - Crowbar Circuit

3.6. Compatibility with Popular Development Systems

Device Compatible Compatible Shields
Raspberry Pi Yes, can be connected directly with wires. View example in section 7.1 Raspberry Pi None yet that have been verified by Taggle Systems.
Arduino Uno Not directly, Arduino uses TTL (5V logic levels) which may damage the Corella module. Voltage translation is required. View section 7.2 Arduino The Taggle Corella Arduino shield converts all input voltage levels to allow full compatibility between the Arduino Uno and the Corella Module.
shield
Table 4 Compatibility Reference Table

4. Data

4.1 Serial Port Set Up

Rev A module: 9600 Baud, no parity, 1 stop bit, no flow control
(9600 Baud - 8N1)

4.2 Corella Packet Format

Field PacketID User Payload
Byte 0 (4 bits) 1 2 3 4 5 6 7 8 9 10 11 12

User Payload • Fixed 12 Bytes of User Data (Using AT+SEND command).
Packet ID • ASCII character between '1' and '9'.

5. AT Commands

Supported Commands:

5.1. AT (Attention)
ATTENTION
CommandsResponse
AT
Description
Debugging commands to check for active serial communication
OK
5.2. AT+STATUS
STATUS
Command (QUERY)Response
AT+STATUS? \r\n
Description
Corella allows for a maximum of one payload to be sent every 10 seconds. Status refers to the wait time remaining in seconds before another packet may be sent.
WAIT [SECONDS] SEC\r\n
Parameter: SECONDS
1-byte integer representing remaining wait time in seconds
5.3. AT+SEND
SEND
Command (SET)Response
AT+SEND=[<PACKET ID>,<DATA>]
Description
Transmits the user's data payload.
Parameter: PACKET ID
  • 1 ASCII character
  • Packet ID must be in the range of 1-9
  • Packet ID 0 : reserved for diagnostic messages
    (button press)
  • Packet ID 1 : interpreted as analog data in
    the Corella Data Portal
  • Parameter: DATA
    Users Data:
  • Must be EXACTLY 12-bytes
  • Padding required if the payload is shorter
  • OK
    5.4. AT+VERSION
    VERSION
    Command (QUERY)Response
    AT+VERSION?
    Description
    Used to check current Corella, hardware, and software version.
    TAGGLE_CORELLA\r\n
    H.W=REV_A\r\n
    F.W=1.1.01\r\n
    5.5. AT+ID
    TAGGLE ID
    Command (QUERY)Response
    AT+ID?
    Description
    Requests Corella's unique device ID which will be used to match the data from the Corella module to our Taggle Network.
    [TAGGLE ID]\r\n
    Parameter: TAGGLE ID
    5-byte integer representing device ID
    5.6. AT+DIAGNOSTICS
    DIAGNOSTICS
    Command (QUERY)Response
    AT+DIAGNOSTICS?
    Description
    Requests the devices internal diagnostics which includes temperature of the device in degrees Celsius and the supply voltage in Volts.
    MAX_TEMP=[TEMP]
    MIN_TEMP=[TEMP]
    CURR_TEMP=[TEMP]
    BATT=[VOLTAGE]
    Parameter: TEMP
    16-bit integer representing temperature of the Corella MCU
    Parameter: VOLTAGE
    ASCII string e.g. "3.17V" representing the current source voltage
    5.7. AT+LEDS
    CONFIG
    Command (SET)Response
    AT+LEDS=[STATE] Default State is on.
    Description
    Turn Corellas status LEDs on and off. Status LEDs provide feedback to the user allowing for easy understanding of their Corella modules current transmit state. In embedded environments, the user may wish to turn off the LEDS to reduce power consumption and extend battery life.
  • Note: The green Power LED cannot be turned off through software and if the user wishes to extend battery life further they should refer to section 3.6 Extended battery life.
  • Parameter: STATE
    Users Data: ASCII string
  • "ON" turns on LEDs
  • "OFF" turns off LEDs
  • LEDS [STATE]
    Parameter: STATE
    ASCII string either "ON" or "OFF"

    6. Serial Communication Example

    The following is a record of serial communications conducted using a terminal interface.

    6.1. AT

    [TX] - AT<CR><LF>
    [RX] - OK<CR><LF>
    

    6.2. Status

    [TX] - AT+STATUS?<CR><LF>
    [RX] - OK<CR><LF>
    

    6.3. Send Packet

    [TX] - AT+SEND=1,0123456789AB<CR><LF>
    [RX] - OK<CR><LF>
    
    [TX] - AT+SEND=1,0123456789AB<CR><LF>
    [RX] - WAIT_07_SEC<CR><LF>
    

    6.4. Version

    [TX] - AT+VERSION?<CR><LF>
    [RX] - TAGGLE_CORELLA<CR><LF>
           H.W=REV_A<CR><LF>
           F.W=1.0.31<CR><LF>
    

    6.5. Diagnostics

    [TX] - AT+DIAGNOSTICS?<CR><LF>
    [RX] - MAX_TEMP=28<CR><LF>
           MIN_TEMP=26<CR><LF>
           CURR_TEMP=27<CR><LF>
           BATT=3.17V<CR><LF>
    

    6.6. ID

    [TX] - AT+ID?<CR><LF>
    [RX] - 130123<CR><LF>
    

    6.7. LEDS

    [TX] - AT+LEDS=ON<CR><LF>
    [RX] - LEDS ON<CR><LF>
    
    [TX] - AT+LEDS=OFF<CR><LF>
    [RX] - LEDS OFF<CR><LF>
    

    7. Appplication Examples

    7.1 Raspberry Pi Setup

    For detailed information and existing Library refer to the Corella + Raspberry Pi guide.

    Connect the Corella power.
    3.3v connects to RPi pin #01
    GND connects to RPi pin #09
    Connect the UART as shown.
    (GPIO 14/15)
    Corella DOUT connects to RPi pin #08
    Corella DIN connects to RPi pin #10

    circ01
    Figure 5 - Corella to R-PI suggested connection

    wiring02

    7.2. Arduino Setup

    For detailed information and existing Library refer to the Corella + Arduino guide.

    The Corella Arduino Shield is asymmetrical and will only fit properly using the correct orientation.

    The Corella should be fitted to the shield as shown with the antenna SMA connector overhanging the edge of the board.

    arduinoshield
    Figure 6 - Arduino fitted to Corella Arduino Shield


    About Taggle Systems

    Taggle is an Australian based and owned developer of Low Power Wide Area (LPWA) radio technology offering low-cost, low-power, long range communications for many types of sensors and devices.

    With a rapidly expanding international network, we service high-rise and urban centres, regional utilities, remote communities and farm monitoring. We work with our customers to deliver tailored solutions.

    The Corella project enables experimentation, innovation, small-scale or specialized projects to be implemented without fuss or large investment.