Skip to content

Getting Started with the Tapioca

This guide will specifically help you to configure your Tapioca as a Modbus Slave device.

Required resources: Tapioca, a Windows PC with IoTize Studio installed, Android/iOS smartphone, power supply (Tapioca RS232/485 only. Power can be supplied through the RJ45 connector or through the dedicated power connector)

  1. Launch IoTize Studio and create a new Tapioca Project.
New Project
  1. Setup Target communication options

Go to IOTZ Explorer > Duetware Configuration > Target Link and select the following options:

  • Target Architecture Type: System
  • Link Target <=> Tap: Modbus
  • Authorize Serial Slave Server: Yes
  • Slave Server Communication Channel. Select then the Modbus communication server you wish the Tapioca to use
Target System
  1. Create Modbus variables

In the IOTZ Explorer > Duetware Configuration > Bundles, right click on Main and select Add custom variable. Select the created variable and modify its settings:

  • Name: the name you want to give to the variable
  • Data Model: the type of Modbus register you want to create Use 0 as the default read/write type (Holding register)
  • Unit-size Typically Half-Word (16bits)
Modbus Variable

Repeat this operation for every Modbus variable you wish to create.

Immportant Each variable is created with a unique id. This id will be used as the modbus register of the address.

  1. Configure and test

Connect IoTize Studio to your Tapioca, through direct BLE or by setting up a relay with the TapManager app on your smartphone. see Setup a communication channel between a Tap and IoTize Studio

Click now on the Configure button to upload the configuration to your Tapioca. When done, click the Connect button to diplay the values of your variables in the HTML view.

You can now use the Tapioca as a Modbus Slave device, with the configured variables as modbus registers, their register address being their own ids.

To test it, you may connect the Tapioca to your Modbus master device. If your Tapioca model has USB, or if you have an adapter to connect it to your computer, you may use computer Modbus clients like Modbus Doctor to communicate with Tapioca. On writes, the HTML view of IoTize Studio will be refreshed with the new values that are stored within the Tapioca.

You have now successfully configured your Tapioca as a Modbus Slave device. You may now add new variables to the configuration, create new bundles, manage profile access rights or go on with the mobile app creation. Check out our How To guides or go back to the Main page for more information.