This repository contains a public version of IOWA LwM2M stack, illustrating how to use the LwM2M library.

Don't forget to have a look at the Documentation:

This code is provided as-is, under the associated licence (./LICENSE.txt). (This code should not be used in a commercial product and is for personal evaluation ONLY)

With this code, you can jump into LwM2M and validate the build and the execution of the IOWA stack on your device, but with some limitations:

All the samples can be built/run on Windows and Linux. Other platforms and OS are available in:

If you prefer, a Docker version is available in the docker folder.

You can find some interesting tutorials on Hackster.io:

• Device management with LwM2M IOWA stack - Tutorial 1

• Device management with LwM2M IOWA stack #2: ESP32

Initial setup: Don't forget to clone this repository:

git clone https://github.com/IOTEROP/IOWA.git

Prerequisites: An x86-64 computer with a Linux distribution installed, the cmake utility, the make utility and a C compiler.

To compile the 08-secure_client_tinydtls sample, you will also need git to be installed.

1. Inside the IOWA repository, create a build folder

   mkdir build

2. Go to this folder

   cd build

3. Launch cmake in debug mode

   cmake -DCMAKE_BUILD_TYPE=Debug ..

   The last parameter point to the folder containing the CMakeLists.txt file of your target. In this case the one at the root of the repo.

4. Compile the samples.

   make -j 4

   (The -j 4 parameter enables four parallel compilations, could be replaced with make -j$(nproc))

   (After making some modifications to the code, only the step 4 is required)

5. Jump into the associated directory. E.g:

   cd samples/01-baseline_client

6. Run the sample. E.g:

   ./baseline_client

1. Install the Microsoft C++ compiler as explained here: https://docs.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=vs-2022
   1. Select the "Build Tools for Visual Studio 2022".
   2. In the Installer, make sure the following optional features are checked:
      • MSVC v142 - VS 2022 C++ x64/x86 build tools (Note that the version may differ)
      • Windows 10 SDK
      • C++ CMake tools for Windows
2. Install Visual Studio Code from https://code.visualstudio.com/
3. Launch Visual Studio Code.
4. Go to the "Extensions" panel (Ctrl+Shift+X) on the left side.
5. Install the "C/C++", "CMake", and "CMake Tools" extensions
6. Open the folder containing the IOWA SDK ("File" menu -> "Open Folder..." or "Ctrl+K Ctrl+O")
7. Open the CMake panel on the left side.
8. On the top bar of the CMake panel, click on the icon "Configure All Projects".
9. When prompted to select a kit, choose one of the Visual Studio Build Tools.
10. On the top bar of the CMake panel, click on the icon "Build All Projects".
11. Click on the sample of your choice.
12. Right-click on the application and select "Run in terminal"

Visual Studio version must be at least 2017 for the CMake support.

1. In the Visual Studio menu bar, go to "File", "Open", "Folder". Select the IOWA folder.
2. In the "Solution Explorer" windows, right-click on "CMakeList.txt" and choose "Set as Startup Item".
3. In the Visual Studio menu bar, go to "Build", "Build All"

You can interact with the samples or your device with ALASKA Platform

Click on the button below to jump to the ALASKA Platform