Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Necessary Hardware

  • Microcontroller/development board of your choice
    • With necessary programmer
  • SmartMesh IP Mote (DC9003A-B)
    • With 6 female-female jumper cables
  • SmartMesh IP Manager (DC2274A-A)
  • SmartMesh Interface Board (DC9006A)
    • With USB-A to USB-micro cable
  • Computer (should support Python and Java)

...

There are two ways to download the QuickStart Library:

a) Clone The Source Code

...

Clone the repository with git (or a git GUI client):

$ git clone https://github.com/dustcloud/QSL-for-sm_clib.git

or checkout the latest release with subversion

...

Enter the repository:

$ cd QSL-for-sm_clib

...

Initialize and update  update the neccessary necessary C Library submodule:

 

(...)/QuickStart_LibraryQSL-for-sm_clib$ git submodule init
(...)/QuickStart_LibraryQSL-for-sm_clib$ git submodule update

 

You can also checkout the latest release with subversion:

$ svn checkout https://github.com/dustcloud/QSL-for-sm_clib.git

but then you will also have to checkout the latest release of the C Library, since SVN does not support git submodules:

$ svn checkout https://github.com/dustcloud/sm_clib.git

b) Download Zip/Tar

  1. Go to the QSL release page and download the latest zip/tar.
  2. Go to the C Library release page and download the latest zip/tar.  The The C Library is automatically generated from the SmartMesh IP stack library source, and so it may change with each stack release and needs to be downloaded separately.
  3. Unzip the files using your favourite compression tool.

...

  • sm_qsl/ contains the QuickStart Library as a collection of headers (.h) and source code files (.c).
  • sm_clib/ is a submodule that contains the underlying C Library, with sample applications for its direct use.
    • sm_clib/ is the C Library itself as a collection of headers (.h) and source code files (.c).
      • ports/ contains an example of the necessary C Library ports.
    • examples/ contains sample applications which use the C Library directly.
  • examples/ contains sample applications utilizing the QSL
    • rpi/SimplePublish/ contains an example that connects and starts publishing random data, where the necessary porting functions have been implemented for the Raspberry Pi. 

 

...

The SmartMesh C Library will be in the 

Note
If you chose the zip download or subversion checkout, the sm_clib/ directory from the separate unzipped folder
if you chose the zip download
/svn checkout should be copied into the QSL repository, as some example code will expect the above structure.

 

The SmartMesh QuickStart Library, and C Library it depends on, are both designed so you can drop their directories into your application without modification, i.e. these two folders from the structure above:

...

The ports of interest are the third and fourth, which map to the CLI and API, respectively, as defined by Table 1

 

 

Device

Anchor
tab_serialPorts
tab_serialPorts

Serial Port NumberUsageBaudrateData BitsParityStop Bits
SmartMesh IP Managerthird*CLI96008No1
fourth*API115200**8**No**1**
SmartMesh IP Motethird*CLI96008No1
fourth*API115200**8**No**1**

 

Table 1: Serial port configurations

...