Welcome to Rialto Board by Silica Architech’s documentation!

Version:1.00
Copyright:(C)2016 Avnet Silica company
Date:30 july 2013
_images/nxplogo.gif _images/jennic.gif

INTRODUCTION

Silica Rialto Board is useful system to evaluate a basic IEE802.15.4 network using JN5168 wireless module.
Rialto board has a single built-in USB dongle. Simply switching serial channel from terminal application to programming software, you can perform two alternate functions:
a - Evaluate network with simple serial monitor (using a PC terminal such as HyperTerminal)
b - Program Firmware into JN5168 module (using JN-SW-4007-Flash-Programmer v1.8.9)

If you want, you can use separate USB-TTL adapter connected with 6 pin strip on Rialto board. In this case, you can have two separate serial channel, first (USBdongle) for programming and second (6 pin strip) for Serial Monitor. See Serial channel details

Rialto board is also designed as a plugin for SerizII board. Rialto “ready to run” kit is specially designed for quick use and fast evaluate network functionallity. All you have to do is plug End-Node on SerizII board, plug Coordinator on PC USB port, start HyperTerminal and enjoy!!

With Rialto board you can evaluate the performance of new NXP SENS300/01 device. The SEN300/01 integrates one high-accuracy temperature sensor, four relative humidity sensors, six light sensors, a user-writable non-volatile memory and a 10-bit analog-to-digital converter. Rialto application reads out basic data from temperature, humidity and light sensors. For more information about this sensor, see at NXP official site NXP official site

Rialto board integrates a NTAG203F, NFC Forum Type 2 Tag compliant IC with 144 bytes user memory and field detection. This device is used on SerizII labs. See at official documentation page of NXP site NTAG203F

Firmware application was developed with JN-SW-4041-SDK-Toolchain-v.1.1 (Eclipse based).
You must also install JN-SW-4065-JN516x-JenNet-IP-SDK-v857 software library.
Firmware project is included in Rialto_Jennic.zip file.
Reference guide are included into Install.zip and are:
1) JN-UG-3064 - Software Developer’s Kit Installation and User Guide
2) JN-UG-3007 - JN51xx Flash Programmer User Guide

Install.zip also include JN-SW-4041-SDK-Toolchain-v.1.1.exe and JN-SW-4065-JN516x-JenNet-IP-SDK-v857.exe to install developement suite.

For JN5168 modules programming, you must install FlashGUI programmer from JN-SW-4007 (included in Install.zip). Please, note that JN-UG-3007 refers to Flash GUI programmer version 1.8.4, and JN-SW-4047 contains new release 1.8.9 of Flash GUI programmer. See release note document included in JN-SW-4047 package. The release 1.8.9 must be installed for JN516x modules programming.
Install.zip and Rialto_Jennic.zip files can be downloaded from Rialto section of Silica ArchiTech web page (registration needed)
Installing Jennic Developement Suite chapter will guide you through the basic steps of the installation procedure of Jennic Developement Suite

We suggest you to read first the Quick Start Guide to perform a correct Firmware setup.

Quick start guide

This guide explains how to use this application and provides an overview of on the structure of the project firmware

Installing Jennic Developement Suite

This small guide is intended to explain the main steps to properly install the Jennic SDK Toolchain.
As possibly not shown here, refer to the document JN-UG-3064.
All steps here described are performed with WINDOWS 7 OS

First step

Unpack the file ‘Install.zip’ that you have downloaded You must find these files:

_images/install.jpg

Then, you are ready for Jennic Developement Suite setup.

Installing Jennic Toolchain JN-SW-4041

Double click on JN-SW-4041-SDK-Toolchain-v1.1.exe.
Leave unchanged all default setting in the following dialog box.
When appear verify checkbox selection as image below
_images/setup_1.jpg

During installation, if you don’t have Java Runtime on your PC, this popup will appear:

_images/setup_2.jpg

Click OK button and proceed following Java Installer instructions

_images/setup_3.jpg

When installation ends, the followiong will appear:

_images/setup_4.jpg

click “next” button, and setup will ask you to perform a system restart

_images/setup_5.jpg

click “OK” and wait for restart

Installing JN-AN-4065 library

Double click on JN-SW-4065-JN516x-JenNet-IP-SDK-v857.exe.
Leave unchanged all default setting in the following dialog box.
When appear verify checkbox selection as image below, then click “Next”
_images/lib_1.jpg

When library installation has finished, Jennic Toolchain is ready to start

Starting Jennic Toolchain

Open Start and go to Jennic –> Eclipse (as show in figure below)
click on Eclipse to start program
_images/start_1.jpg

Jennic Toolchain will ask for workspace. Leave unchanged an click “OK”

_images/start_2.jpg

Jennic Eclipse will open Welcome tab.

_images/welcome.jpg
Close Welcome tab by clicking on X red circled in figure above
Now the Jennic Eclipse main window will appear
_images/screen_1.jpg

Close Eclipse and proceed with next steps.

Installing Flash GUI Tool Programmer

In order to complete developement suite setup, you must install Flah Programmer as a external tool.
Open file menu, and select “Import”
_images/import_1.jpg

chose “Run/Debug –> Launch Configurations and click “Next” button

_images/import_2.jpg

click “Browse” button and navigate to C:\Jennic\Tools\eclipse_config and then click “OK”

_images/ext_tools_folder.jpg
Sign “Flash GUI Tool” and “Flash CLI Tool” checkbox
Please, note that Eclipse default is all tool checked, but as actual for JN5168 application only the two Flash tool are needed.
_images/import_3.jpg
Click “Finish” button to perform Flash Tools setup.
When finished, you can find the tools in the Run–>External Tools menu
They can also be accessed from the drop-down arrow next to the tools symbol, as show in figure below
_images/tools_1.jpg

Upgrading Flash GUI tool (for JN5168)

We must upgrade Flash GUI tool to release 1.8.9, because the tool just installed does’n work with JN5168.
To make this, unpack the zip file JN-SW-4007.zip into new folder and navigate to Tools\FlashProgrammer located inside this new folder.
you can find the JN-SW-4007 file inside Install.zip as show in First step chapter on this document
_images/flash_update_2.jpg
Select all files, right click an copy.
Open folder C:\Jennic\Tools\flashprogrammer and paste all file inside this folder.
_images/flash_update_3.jpg

Now Jennic Eclipse setup is complete and the suite is ready for work with Rialto Project!




WINXP TROUBLESHOOTING

INSTALLING DRIVER FOR USB DONGLE

With some release of Windows Xp, you must manually install the USB drivers of the Rialto board.

_images/winxp.png

In this case, go to FTDI driver page download and install Windows driver.

CYGWIN1.DLL TROUBLES WITH WINXP

Jennic SDK Toolchain install CygWin API inside the folder C:\Jennic\cygwin.
Some XP installation have the file “cygwin1.dll” inside C:windowssystem32 folder.
This is a cause for fatal error during project building.
If it occours, build fails and on the “Console” tab of the Jennic Eclipse you can see one or more messages as follow:
290 [main] ? (680) c:\Jennic\Tools\ba-elf-ba2\bin\ba-elf-gcc.exe: *** fatal error - cygheap base mismatch detected - 0x611668E0/0x611688E0.
This problem is probably due to using incompatible versions of the cygwin DLL.
Search for cygwin1.dll using the Windows Start->Find/Search facility
and delete all but the most recent version.  The most recent version *should*
reside in x:\cygwin\bin, where 'x' is the drive on which you have
installed the cygwin distribution.  Rebooting is also suggested if you
are unable to find another cygwin DLL.
To solve this trouble with Jennic Eclipse Builder, we suggest to try to remove file “cygwin1.dll” located inside folder C:\Windows\system32
We suggest to rename the file in your system folder and check if there are no other troubles
Be careful if you have other applications that use cygwin!! Removing file from OS system folder must be checked before.
For more detail and further information regarding cygwin, you can visit the cygwin site.
For further information about this trouble, click here .

Quick start guide

Hardware requirements

  • Silica Rialto Board kit
  • One or more USB type-A extension cable
  • PC with terminal software (such as HyperTerminal)
_images/wise_usb.jpg

Software requirements

  • Jennic SDK toolchain (JN-SW-4041), JN5168 stack library (JN-SW-4065) and Flash GUI tool (JN-SW-4007)
  • Rialto_Jennic firmware
  • PC terminal emulator (such as HyperTerminal)

Note

If you have not yet installed Eclipse Jennic, before proceeding, go to:

Hardware setup

Plug Rialto Board into USB port (also using USB type-A extension cable)

_images/usb_plug.jpg

with USB type-A extension cable

_images/usb_cable.jpg

Wait for properly USB dongle driver installation

_images/ftdi230.jpg

When drivers are ready you can connect one or more Rialto Board (at least two for firmware evaluation)

_images/ftdi230_ready.jpg

Tip

See Control Panel of your PC and note COM Port number configured for each Rialto Board (figure above).
For any troubles during USB driver installation in Windows XP see at WINXP TROUBLESHOOTING
_images/usb_port.jpg

Connecting two Rialto Board (minimun number for full firmware evaluation), take care at COM number installed on your PC

_images/2usb.jpg
SerizII plugin

Rialto board has in bottom layer two strip (6 and 4 way) and can be used as a plugin for SerizII.

_images/seriz_wise.jpg

Important

Before using Rialto boards as SerizII plugin, you must download and install the proper firmware revision of the SerizII board (SerizRialto.zip). For all instruction and information about, see at Silica SerizII

Take care plugging Rialto on SerizII: be shure that both boards (Rialto and SerizII) are power off before!!

HyperTerminal settings

Set your HyperTerminal COMx parameter:

speed = 115200 baud
data with = 8
parity = none
stop bit = 1
flow control = none
_images/com_set.jpg

In Ascci Setup windows, check “Send line ends with line feeds”

_images/com_crlf.jpg

Rialto Board FW installation & setup

  • In the folder C:\Jennic\Application create new folder named Rialto_Jennic
_images/wise_work_folder.jpg
  • Unzip all files from Rialto_Jennic_1_0.zip into the folder C:\Jennic\Application\Rialto_Jennic just created
_images/folder.jpg
  • Go to Start –> Jennic –> JN-SW-404x products –> Eclipse and click on to start Jennic Eclipse
_images/start_1.jpg
  • Check if workspace setting is like figure below. Then click OK to proceed.
_images/start_2.jpg
  • Now you can see the Eclipse Main Window
_images/screen_1.jpg
  • Select menu File –> Import
_images/import_1.jpg
  • In the dialog box that will open, click on General, select Existing Projects Into Workspace and after click “Next” button: new dialog will open.
_images/prj_import.jpg
  • Click on “Browse...” button an navigate to C:\Jennic\Application\Rialto_Jennic folder. Click on “OK” button
_images/prj_import_2.jpg
  • Check options and setting as the image below, then click “Finish” button to import project.
_images/prj_import_3.jpg
  • Wait for project import, then you can see Rialto_Jennic project in the Project Explorer windows of Eclipse Platform.
_images/project_ready.jpg
  • First of all, right click over “Rialto_Jennic” in the Project Exporer window, then select “Clean Project”. After cleaning, a first build will start automaticaly
_images/import_5.jpg
  • Take care at image above. Expand project, and see at “Console” tab: you can find a log that ends with “Generating binary .... Rialto_Coord_JN5168.bin”
_images/clean&build.jpg

Tip

If you can’t see in the “Console” tab the message above, make shure that “Build Automatically” option (inside “Project” menu) is set

_images/aut_build.jpg

Note

The binary file for Coordinator has been generated and ready for Rialto Board programming

Tip

don’t care if you have this warning (see Problems tab).

_images/warning.jpg
  • Now you can build End_Node project. Click on drop-down arrow next to Hammer Icon (blue circled in image below)
_images/build_1.jpg

then click on “Rialto_EndD”. Build will start.

_images/build_2.jpg
  • When build has finished, in the Project Explorer tab expand Rialto_Coord and Rialto_EndD Build folders. The result in image below.
_images/compile.jpg

You have built the two binary files and you are ready for program Rialto Board

Programming Rialto Board with Flash GUI Tool

Before starting Flash GUI programmer tool, you must connect Rialto Board whit built-in USB dongle. Please refer to Hardware Setup chapter on this document to check connection

  • Flash Gui Tool can be accessed by clicking on the drop-down arrow next to Tools Symbols on the toolbar, then selecting “Flash GUI Tool”
_images/tools_1.jpg

Dont’t care of error in Console tab: no troubles or malfunctioning will be affect board program!

_images/error_flash_gui.jpg _images/flash_1.jpg
- Step 1: make these actions:
1) Check and/or select appropriate COM port (green circled).
You can find find out which serial communications port your PC has allocated to the Rialto Board by checking in the Control Panel–>Hardware–>device Manager–>COM port
2) Click on “Refresh” button (blue arrow) and check the result (orange circled): if device not appear, check cable and USB connection (COM port installed)
3) Select in the Baud rate drop-down menu “500000” (for maximun programming time performace)
4) Check “Automatic Program and Reset” checkbox (brown arrow)
_images/flash_2.jpg

Note

Take care at COM port: if it’s already busy with other applications (such as HyperTerminal), you cannot find it in COM port dropdown menu of Flash GUI Tool

  • Step 2: click “Browse” button red circled, navigate to C:\Jennic\Application\Rialto_Jennic\Rialto_Coord\Build and select bin file “Rialto_Coord_JN5168.bin”. Then click “Open” button.
_images/flash_3.jpg
- Step 3: in the “Program” window will appear C:\Jennic\Application\Rialto_Jennic\Rialto_Coord\Build\Rialto_Coord_JN5168.bin.
Clik on “Program” button to start board programming.
_images/flash_4.jpg
  • Step 4: wait for verifyng...
_images/flash_5.jpg
  • Step 5: Click “OK” button and board will reset and start.
_images/flash_6.jpg

Tip

To program End-Node, repeat from step 2 but navigate to C:\Jennic\Application\Rialto_Jennic\Rialto_EndD\Build and select “Rialto_EndD_JN5168.bin” When you have programmed even Coordinator that End-node, you can select FW binary by clicking the drop-down arrow (red circled in image below) and select from drop-down menu

_images/flash_set.jpg
Now you have finished all setup necessary to evaluate, debug and make changes inside Rialto Firmware.
You can plug the Rialto boards into USB ports of your PC, open HyperTerminal sessions and use Serial Monitor command for evaluate the main Firmware functions.
For further details you can read the guides:

Serial Monitor guide

Tip & Tricks

“Ready to run” Rialto Kit

Ready to run is a pre-programmed kit that perform basic function for Jennic evaluation purpose. We can find two Rialto board, first one as Coordinator and second as End-Node.

_images/seriz_coord.jpg

Important

Before using Rialto Boards as a SerizII plugin, read note inside ‘important’ box on chapter SerizII plugin

Working with Rialto board

Simply use of Rialto Board, is to plug Coordinator and End-Node on two USB port of your PC See at com port configured, and then open two HyperTerminal sessions to evaluate Rialto network

Coordinator Serial Monitor main menu

_images/coord_menu.jpg

End-Node Serial Monitor main menu

_images/end_menu.jpg

By default, Coordinator has “verbose mode” enabled and End-Node has “auto send sensors data” enabled. “Verbose mode” shows for every transaction (both TX and RX) more data detail, such as HEX format (enclosed in square bracket) When verbose mode is disabled, Serial Monitor gets out only the string or data. It is useful to receive VCARD data from SerizII and save these in VCF format.

“Auto send sensors data” performs read&send sensors data (ADXL362 and SENS300), every time that End-Node receive a poll from Coordinator. When disabled, auto send function will not work.

Note

For more details about Serial Monitor, see Serial Monitor guide

First Lab

The Lab1 that you can perform, is by following the next steps:

  • Connect Coordinator and End-Node Rialto boards on USB port of your PC
  • Open terminals, connect appropriate serial port and check correct settings (see HyperTerminal settings)
  • Wait for network connection (blue-led will flash fast both in Coordinator and End-Node)
  • See at red-led flash (poll, trasmit or receive, default is 8 seconds)
  • See at terminals windows: you can see regullary (every poll-time), both coordinator and end-node, details of sensors data trasmitted and received
  • Disable End-Node “Auto send sensors data” typing command ‘!‘.
  • Change End-Node PAN.ID (i.e. 1234) typing ‘C‘ command. Board will restart and then wait for new Coordinator (blue-led flash slow)
  • See blue-led of Coordinator board: when it flash slow, the Coordinator detect poll failure and automatically dissociate End-Node (it will take about 30-35 seconds). Serial monitor will inform when it occur.
  • Now change Coordinator PAN.ID (‘C‘ command) and set same as End-Node previously changed (i.e. 1234) Coordinator restarts itself.
  • In a few seconds, End-Node will reassociate with new Coordinator and start to send sensors data.
  • Enter End-Node sleep mode (typing ‘Z’ command). When leds off, plug out End-Node. It will send every 15 seconds sensors data to Coordinator. In sleep-mode the power drain by the end-node is very low. You can take out from USB port and the End-node will run on the small supercap on the board for few minutes.

Important

Sleep Wake Time can be set changing default definition in define.h file. For more information, read Poll and Sleep settings

Lab 2 with SerizII

The purpose af Lab2 is to show how to add a new end-node to an exhisting network, by setting authomatically the end-node PAN-ID to mach the exhisting network PAN-ID. The processo is: - the network is running ( coordinator on PC ) - the end-node to be added, which is the SerizII, will read the PAN-ID stored on the NTAG on the ccordinator. - the end-node PAN-ID is set to the network PAN-ID - data can be now exchanged by end node to coordinator, the Vcard data.

Rialto board is designed as a SerizII plugin (see SerizII plugin). In Lab1, plug End-Node board on SerizII and Coordinator on USB port of your PC. If you want, you can connect Rialto End-Node board, plugged on SerizII, to PC using USB type-A extension cable. Serial Monitor will run, without affecting SerizII communications. Then, follow next steps:

  • Open terminals, connect appropriate serial port and check correct settings (see HyperTerminal settings)
  • See SerizII display: it will inform that JN5168 End-Node is installed.
  • Wait for End-Node restart. See blue-leds flash, that will be slow. No network connection and no device associated. (You can also verify by typing ‘N’ command on Coordinator serial monitor)
  • If the PC serial monitor is connect to the End-Node, on main menu you can see that ‘Auto send sensors data’ is disabled, because of this is a default setting by SerizII connection.
  • Take Coordinator near SerizII RFID antenna: the Seriz will read the Coordinator PAN.ID from the onboard Ntag. SerizII will update the End-Node PAN.ID.
  • End-Node will restart, and in a few seconds will be associated to the Coordinator.
  • Blue-leds will flash fast to indicate that Network is connected, and also the SerizII display will show this.
  • Disable verbose mode on the Coordinator (typing ‘!’ command)
  • Place the business card in near SerizII RFID antenna; see at Serial Monitor windows of Coordinator and you can see all data readed from business card.
  • You can copy and paste business data (using NotePad) and save this file with extension .vcf and directly import to your contact database.

Important

When End-Node is connected to SerizII, Sleep mode entering is not allowed. Even ‘Auto send sensors data’ is disabled, but you can enable it using ‘!’ Serial Monitor command.

Lab 3 with SerizII

The purpose af Lab3 is to show how to add a new end-node to an exhisting network, by setting authomatically the end-node PAN-ID to mach the nexhisting network PAN-ID. The processo is: - the network is running ( ccordinator on SerizII ) - the default address of the end-node to be added is read by Seriz from the NTAG on the end-node - the coordinator is set to the end-node read PAN-ID, to be able to comunicate with the end-nod to be added - the end-node PAN-Id is set to the network PAN-ID - the coordinator is put back on the original networn PAN-ID, to which the end-node is now added

In Lab3, plug Coordinator on SerizII and End-Node on USB port of your PC. Simillary to Lab2, you can connect Rialto Coordinator board, plugged on SerizII, to PC. After this, see here steps for Lab2.

  • Open terminals, connect appropriate serial port and check correct settings (see HyperTerminal settings)
  • See SerizII display: it will inform that JN5168 Coordinator is installed.
  • Wait for Coordinator restart: blue-led will flash slow, no network is connected.
  • Take End-Node near SerizII RFID antenna: the Seriz will read the End-Node PAN.ID from the onboard Ntag. SerizII will update the Coordinator PAN.ID, wait for End-Node association and will perform update of End-Node PAN.ID to the previos network PAN.ID.
  • Wait for End-Node restart, and in a few seconds it will associate to the Coordinator.
  • End-Node, every time that receive poll command, send sensors data to Coordinator. You can see these data both Coordinator and End-Node Serial Monitor windows
  • SerizII display show sensors data received and network state for each End-Node associated: short Network address and state (Sleep or not). You can verify also using Serial Monitor command ‘N’.
  • Now place End-Node in ‘Sleep mode’: SerizII will show the End-Node new state (sleep) and receive (every Sleep Wake Time) End-Node sensors data.

Important

Sleep Wake Time can be set changing default definition in define.h file. For more information, read Poll and Sleep settings

After this 3 Labs, use Serial Monitor guide and enjoy with Rialto Boards!!

Firmware specification

Firmware overview

The Rialto_Jennic firmware has been developed using JN-AN-1174-JN516x-802-15-4-Application-Template skeleton code.
This template include basic application of IEEE802-15-4 stack and some callback function that can be personalized and help end-user application development.
More detail regarding the structure of this template can be found on document “JN-AN-1174-IEEE802.15.4-App-Template.pdf” inside “Doc” folder included in Rialto_Jennic zip file
_images/document.jpg
JN-AN-1174-IEEE802.15.4-App-Template.pdf reference manual refers to other documents in this folder, especially for:
IEEE 802.15.4 Wireless Networks User Guide (JN-UG-3024)
IEEE 802.15.4 Application Development Reference Manual (JN-RM-2024)

This is the complete set of guides to know the structure and operation of the skeleton code contained in the template

Other documents:
JN-UG-3087-JN516x-Integrated-Peripherals-API.pdf JN516x integrate peripherals API user guide (hardware library functions details)
JN-DS-JN5168MO-1v2.pdf JN5168 module hardware manual

JN516X.pdf JN5168 wireless microcontroller data sheet.

Firmware restrictions

The application skeleton assumes the following restrictions (directly derived from JN-AN-1174 Application Template):
• You have one device which will act as the PAN Co-ordinator.
• You have at least one other device which will act as an End Device.
• You will use pre-determined values for the PAN ID and the short addresses (for the PAN Co-ordinator and for the End Device(s)).
• The network topology will be a Star network.
• The network will be non-beacon enabled (meaning that the PAN Co-ordinator will not transmit regular beacons).
• Short addressing will be used.
• Data transfers will be direct transmissions with acknowledgements.
• There will be no security implemented.

Main firmware features

Rialto_jennic firmware is based on IEEE802.15.4 network stack. The application also features a serial monitor which, with simple control commands, allows you to evaluate the status of the network and perform basic functions of data transmission / reception. The network topology is a “star”, with one Coordinator and more End-Node. The coordinator accepts up to a maximum of 8 End-Node, assigns them a short address and operates a regular polling of all devices associated to check your status. When a End-Node poll fails for 4 next times, the node is automatically dissociated from the Coordinator. Similary, when End-Node doesn’t receive poll and the polling timeout is expired, dissociates itself automatically and restarts the scan sequence to search for a coordinator. This is needed because that the network stack IEEE802.15.4, included in the JN-SW-4065 libraries, doesn’t seem manage orphan devices. In other words, this mode of operation (polling) allows for constantly monitoring the status of the network and update the presence or absence of networked devices.

Rialto Board End-Node firmware implements a demonstration of Low Power functionality. Using Serial Monitor command ‘Z’, you can place the board in “sleep mode”. As a result, Serial Monitor will be disabled, and any Serial Monitor commands will not performed when board is in sleep mode. Please note that restart is the only way to exit from sleep mode.

Project structure

_images/prj_files.jpg

The application’s file structure includes the following folders:

  • Rialto_Coord – contains source files and makefiles for the PAN Co-ordinator
    • Rialto_Coord.c specific application file for Coordinator functions (see chapter 3.2.1 of “JN-RM-2024” resource manual for main details)
  • Rialto_EndD – contains source files and makefiles for an End Device
    • Rialto_EndD.c specific application file for End-Node functions (see chapter 3.2.2 of “JN-RM-2024” resource manual for main details)
  • Common – contains:
    • application.c common functions used both by coordinator that end-node
    • application.h common functions and variables global definition
    • define.h common costant defines
    • config.h network parameter and macro definition

Firmware & documents download

Firmware project file Rialto_Jennic.zip, installation file Install.zip and all other documentation for the Rialto project can be found at Silica ArchiTech page. Registration is needed to access at download section. Click here to go to ArchiTech main page.

Serial Monitor guide

Using serial monitor

You can use USB built-in dongle on Rialto Board for programming or Serial Monitor purpose.
The only attention is that you must “deselect” COM port in the Flash GUI Tool (or close program) before connect with Terminal (i.e. HyperTerminal)
This is because the same COM port is used by Flash Programmer and (when application firmware starts) by Serial Monitor.
Example: if your Rialto Board is connected to COM4, if possible, change COM Port settings in Flash GUI Programmer BEFORE attempting to connect HyperTerminal
Best way is to close NXP Flash GUI Tool before connect Terminal to device COM port.
_images/com_ch.jpg

Note

Startup messages are same in End-Node and Coordinator

Coordinator Serial Monitor

When Coordinator is power up, it sends (in sequence):

_images/reset.jpg _images/res_coord.jpg

and after starts main menu as follow:

_images/coord_menu.jpg

Serial Monitor main messages and commands

  • End-Node detected and associated
_images/coord_ass.jpg
  • End-Node poll fail and dissociated (details orange circled)
_images/coord_diss.jpg
  • Send data to End-Node (“W” command)
_images/coord_wdata.jpg
- Sendig data to End-Node result
Red circled: detail of data message
Blue circled: sending End_Node address
Green circled: data string hex format
Yellow circled: data string terminator (same for all data sending)
Orange circled: Data sending result
_images/coord_wsend.jpg

Important

In the Coordinator Monitor W command will send a “string” to a selected End_Node. You can see the received message inside End_Node Serial Monitor addressed by Coordinator

  • Network status (“N” command)
_images/coord_net_status.jpg
  • Set Coordinator PAN.ID (‘c’ command)
_images/coord_local_pan.jpg

Please, note that ‘c’ command (lowercase) set only coordinator PAN.ID. To configure all network PAN.ID, use ‘C’ command (uppercase)

_images/coord_local_pan_set.jpg
  • Set network PAN.ID (“C” command)
_images/coord_pan_id.jpg
- See image below:
Red circled: detail of PAN.ID configuration message
Blue circled: PAN.ID message status
Green circled: PAN.ID network global settings
_images/coord_set_new_pan.jpg

after system restart

_images/coord_new_pan.jpg
  • Default PAN.ID (“I” command)
_images/coord_init_pan.jpg
  • Request End-Node ADXL362 data (“S” command)
_images/coord_adxl_request.jpg
  • Received End-Node ADXL362 data
_images/coord_adxl_data.jpg
  • Request End-Node SENS300 data (“3” command)
_images/coord_s300_request.jpg
  • Received End-Node SENS300 data
_images/coord_s300_data.jpg

Important

All sensors data are transmitted in 32 bit HEX format, without any conversion in ASCII format. Values are position dependent, and must be read scanning the data string received

Note

In the Coordinator Monitor S and 3 command will answers a selected End_Node to read and send sensor data. You can see sensor data both in End_Node monitor and Coordinator monitor

  • Disable verbose mode (”!” command)
_images/verbose.jpg

Note

In the Coordinator Serial Monitor, verbose mode is also set by SerizII. With verbose mode disabled, Serial Monitor messages are limited to data string and few other information. Check by yourself this operation mode.

End-Node Serial Monitor

  • End-Node main menu
_images/end_menu.jpg
  • Coordinator found, End-Node association
_images/end_ass.jpg
  • Coordinator lost, End-Node dissociation
_images/end_diss.jpg
  • Set data to send to Coordinator (“W” command)
_images/end_set_string.jpg
- Data sending
Blue arrow: string to send
Orange circled: hex string format
Red circled: End-Node address that send the message
Blue circled: Data sending result
_images/end_w_send.jpg
  • End-Node network status (“N” command)
_images/end_status.jpg
  • End-Node ADXL362 data sending (“S” command)
_images/end_adxl.jpg
  • End-Node SENS300 data sending (“3” command)
_images/end_s300.jpg
  • End-Node Auto Send Sensors Data toggle (”!” command)

disable auto send

_images/end_auto_dis.jpg

enable auto send

_images/end_auto_en.jpg
  • End-Node Sleep Mode (“Z” command)
_images/end_sleep.jpg

Important

In End-Node module, configuration command “C” perform only local device PAN.ID settings. If you use this command, End-Node will dissociate himself until it find a Coordinator with same new PAN.ID. The setting sequence is identical to that of the Coordinator command “c”(lowercase)

Tip & Tricks

Stand-alone use of Rialto Boards

“Ready to run” Rialto boards are designed to quick and fast evaluation with PC and SerizII board.
You can use the board both connected with PC for stand-alone evaluation or personal purpose.
In this case, take care at USB com port installed for each board.
For full informations about, see “Ready to run” Rialto Kit

Serial channel details

For best developement purpose, you can change serial monitor out:

  • USB to serial adapter (TTL out)
  • Custom cable to connect 6 pin strip from Rialto Board to USB serial adapter
_images/serial_ext.jpg
Rialto 6 pin strip schematich

pin 1 --> RxD TTL level
pin 2 --> TxD TTL level
pin 3 --> NC
pin 4 --> GND
pin 5 --> NC
pin 6 --> RESET
_images/wise_strip.jpg
How to change Serial Monitor out
At the top of Rialto_Coord.c and Rialto_EndD file you can find a variable statement

uint8 vprintf_uart = E_AHI_UART_0;

/****************************************************************************/
/***        Serial Monitor define                                         ***/
/****************************************************************************/

uint8 vprintf_uart = E_AHI_UART_0;

The Coordinator and End-Node, by default, use USB dongle serial channel (E_AHI_UART_0) for both programming and serial monitor. You can change it to E_AHI_UART_1, and serial monitor will communicate using serial channel connected to 6 pin strip.

Important

Serial channel 1 (E_AHI_UART_1) is default communication channel to SerizII board. When you switch Rialto Serial Monitor out to this channel, all SerizII communication functions will be disabled. The result of this change is the loss of functionality with SerizII

Poll and Sleep settings

In the file define.h you can find the Poll and Sleep settings. By defualt, polling is executed every 8 seconds, the number of maximum poll failure is 4. This gives a maximun non-response time equal to 32 seconds: if End-Node will not be found for this timing, Coordinator will disassociate it from Network. End-Node use instead a polling timeout, that is equal ((POLL_TIME * MAX_FAIL)+1) seconds, and by default gives a value of 33 seconds. Then, the time necessary for disassociation will be just over 30 seconds.

The Sleep time is by default 15 seconds: this means that every End-Node in sleep mode will awakes every 15 seconds, sends sensors data and will return in sleep mode. With this setting, the sleep mode has a duration of about 5 minutes. After this time, the device dies. You can change the Sleep Time definition and make it more great to obtain a more long device life.

When in Sleep-mode, if End-Node will not find a valid Coordinator for SLEEP_RETRY times, stops itself with Blue-Led on. By default, this gives End_Node timeout equal to 45 seconds. After this time, End-Node lights up Blue-Led and let it die. You can change number of SLEEP_RETRY in order to have more retry (only during sleep mode)

/******************************************************************
* SLEEP and POLL SETTINGS
*****************************************************************/

// POLL definition --> leave before MAX_SLEEP_FAIL definition
// Coordinator
#define POLL_TIME ONE_SEC*8
#define MAX_FAIL 4
// End-Node
#define POLL_TIMEOUT (POLL_TIME * MAX_FAIL)+ONE_SEC

//End-Node SLEEP MODE time definition --> seconds - leave before MAX_SLEEP_FAIL definition
#define SLEEP_TIME 15

//Max End-Node sending retry --> only valid in sleep mode
#define SLEEP_RETRY 3

//Coordinator SLEEP MODE fail definition
#if ((SLEEP_TIME*MAX_FAIL) >= ((POLL_TIME/ONE_SEC)*MAX_FAIL))
#define MAX_SLEEP_FAIL ((SLEEP_TIME*MAX_FAIL)/(POLL_TIME/ONE_SEC)+1)
#else
#define MAX_SLEEP_FAIL = MAX_FAIL
#endif

Led functions

Rialto board has 2 LEDs, one blue and one red, which indicate the following features

Coordinator

  • Blue led, slow lamp –> network scanning active, no devices associated
  • Blue led, fast lamp –> network ready, almost one device associated
  • Red led –> flashing to indicate radio Rx/Tx

End-Node

  • Blue led, slow lamp –> ready to associate, no network or coordinator found
  • Blue led, fast lamp –> network ready, device associated (coordinator found)
  • Blue led, on –> sleep fail, no coordinator found
  • Red led –> flashing to indicate radio Rx/Tx
_images/wise_led2.jpg

Firmware debugging

JN5168 modules does’t support Jtag emulation. If you need to develope new application, you can use “vPrintf” function.

We also suggest you to see documentation JN516x Wireless Microcontrollers for any specific further detail.