CubeCell Series Quick Start

简体中文

Summary

CubeCell is based on ASR650x series, this page shown how to install and configuration CubeCell Arduino Framework, and how to uploading and running code (examples).

Install CubeCell Relevant Framework

Tip

Please confirm whether the USB driver, Git and Arduino IDE has been installed correctly.

If not, please view this two articles establish serial connection and Install Git and Arduino IDE.

there are two methods to install the CubeCell framework, choose one of them.

Use Arduino board manager

Open Arduino IDE, and click File->Peferences->Settings

../_images/019.png

../_images/028.png

Input following json url to board manager URLs:

http://resource.heltec.cn/download/package_CubeCell_index.json

../_images/034.png

Click Tools->Board:->Boards Manager..., search Heltec cubecellin the new pop-up dialog, select the latest releases and click install

../_images/041.png

../_images/05.png

The source code of Heltec ASR650x series (ASR6501&ASR6502) framework available here: https://github.com/HelTecAutomation/ASR650x-Arduino

Running an Example

Connect your CubeCell board to computer via a high quality Micro USB cable (This is the most common reason we had encountered can’t program software).

Correctly Config the Tools Menu

In the tools menu, there are following options:

  • Board – Choose the right hardware connected to your computer;
  • LORAWAN_REGION – LoRaWAN protocol region definition, strictly follow LoRaWAN 1.1 Regional Parameters;
  • LORAWAN_CLASS – Now with Class A and Class C supported;
  • LORAWAN_NETMODE – OTAA or ABP;
  • LORAWAN_ADR – Turn ON or turn OFF ADR (Adaptive Data Rate);
  • LORAWAN_Net_Reservation – This is a feature outside the LoRaWAN protocol, only valid in OTAA mode. If this option is enabled, when system reset does not need join again. Projects such as smart street lights may be useful.
  • LORAWAN_UPLINKMODE – LoRa uplink confirmed/unconfirmed messages. Confirmed messages need server send downlink to node, but some LoRa server have downlink limited (such as TTN).
  • LORAWAN_AT_SUPPORT – AT command will provide many useful functions, for example, users can use serial port to config LoRa Node’s DevEui, AppKey, or make node sleep, reset etc.
  • LORAWAN_RGB – RGB light for LoRaWAN status:
    • Purple -- Join;
    • Blue -- First RX window;
    • Yellow -- Second RX window;
    • Green -- Join done.
  • LoRaWan Debug Level – LoRaWAN relevant messages print by serial port
    • None -- Default;
    • Freq -- Sending/receiving frequency;
    • Freq && DIO -- Sending/receiving frequency, and DIO pin interrupt information.
  • COM Port – Device’s serial port in your computer.

Note

LORAWAN_Net_Reservation: For example, a large-scale power outage in city, when power is restored, thousands of devices are connected to the network at the same time, which may cause the LoRa gateway or server to fail. Enable this feature will avoid this situation. Enable LORAWAN_Net_Reservation must disable Frame counter (fCnt) in LoRa server.

../_images/06.png

Select an example

../_images/07.png

Compile and upload

../_images/08.png

New a sketch for CubeCell

In Arduino IDE, click File --> new and copy the following code:

// the setup routine runs once when starts up
void setup(){

  // Initialize the Heltec ASR650x object


// the loop routine runs over and over again forever
void loop() {

}

 

External resources

  • Serial port cannot connected to Linux system?

In the Linux system, If encounter the serial port cannot be connected. Please refer to this document: https://playground.arduino.cc/Linux/All/#Permission

 

Enjoy!