UM RF 04 ENG BeanScape WSN 2 4GHz Supervision Software
UM RF 04 ENG BeanScape WSN 2 4GHz Supervision Software
Version 1.5
DOCUMENT
Document ID Version V1.5
External reference UM_RF_05 Date 17/11/2021
Author Fahd ESSID, Application Engineer
Project Code
Document’s name BeanScape® 2.4GHz user Manual
VALIDATION
For For
Function Destination
validation info
Writer Youssef Shahine ✓
Reader Mohamed-Yosri Jaouadi ✓
Validation Antje Jacob ✓
DIFFUSION
For For
Function Destination
action info
Reader n°1 Antje Jacob, Production Manager ✓
Mohamed-Yosri Jaouadi., Embedded
Reader n°2 ✓
software engineer
UPDATES
Version Date Auteur Evolution & Status
1.12 20/01/2016 Maxime Obr. • FFT function updated
1.14 04/07/2016 Salah RIAHI • Multigraph/ Tx file with multiple channel/ Auto-Start
1.16 24/10/2016 Salah Riahi • Multi FFT & DIN 4150-3 / Velocity LOG files
1.17 22/12/2016 Salah Riahi • Overview of BeanScape basic/Alarm by Email/ SNTP videos added
1.20 08/07/2018 Youssef Shahine • Data analysis tool transferred to BeanDevice® SmartSensor UM
1.21 • New screenshots added with Windows 10: Connecting the BeanScape®
12/08/2018 Youssef Shahine
to BeanGateway®
UPDATES
• Vocabulary updated
• Screenshots updated
• Right click on BeanDevice® Profiles added
• BeanScape Install/Uninstall updated
1.3 08/01/2019 Fahd ESSID
• Firewall auto exception added
• LAN settings updated
• BeanScape® Client/Server updated
• Appendices Auto-start server removed
1.3.2 20/10/2019 Shimon Abadi • More description added about BeanScape Client
• Screenshots updated
1.5 17/11/2021 Seddik ATTIG
• Links updated
Disclaimer
The contents are confidential and any disclosure to persons other than the officers, employees, agents or
subcontractors of the owner or licensee of this document, without the prior written consent of Beanair GmbH, is
strictly prohibited.
Beanair makes every effort to ensure the quality of the information it makes available. Notwithstanding the
foregoing, Beanair does not make any warranty as to the information contained herein, and does not accept any
liability for any injury, loss or damage of any kind incurred by use of or reliance upon the information.
Beanair disclaims any and all responsibility for the application of the devices characterized in this document, and
notes that the application of the device must comply with the safety standards of the applicable country, and
where applicable, with the relevant wiring rules.
Beanair reserves the right to make modifications, additions and deletions to this document due to typographical
errors, inaccurate information, or improvements to programs and/or equipment at any time and without notice.
Such changes will, nevertheless be incorporated into new editions of this document.
Copyright: Transmittal, reproduction, dissemination and/or editing of this document as well as utilization of its
contents and communication thereof to others without express authorization are prohibited. Offenders will be
held liable for payment of damages. All rights are reserved.
Contents
5. SYSTEM OVERVIEW.......................................................................................................................................... 16
5.1 Different versions of beanscape 2.4 GHz software ................................................................................. 17
5.2 About Synchronous multicasting ............................................................................................................ 18
14. APPENDIX......................................................................................................................................................... 58
14.1 Appendix 1: Creating a remote access with BeanScape® Multiview ...................................................... 58
14.1.1 VPN Server Configuration .............................................................................................................. 58
14.1.2 VPN Connection (Client) ................................................................................................................ 65
14.1.3 Localizing Multiview Server ........................................................................................................... 73
14.1.4 Case of Dynamic IP ........................................................................................................................ 75
14.2 Appendix 2: Auto-start BeanScape® ....................................................................................................... 78
14.2.1 Auto-start software ....................................................................................................................... 78
14.3 Appendix 3 : Firewall exception for BeanScape® .................................................................................... 79
List of Tables
List of Figures
Figure 1: Overview of BeanScape® software ..............................................................................................................16
Figure 2 : the different versions of BeanScape® software .........................................................................................17
Figure 3: Run BeanScape as an Administrator ...........................................................................................................21
Figure 4: Uninstall BeanScape ....................................................................................................................................22
Figure 5: Typical LAN connection ...............................................................................................................................23
Figure 6: Windows 10 settings ...................................................................................................................................24
Figure 7: Windows 10 control panel...........................................................................................................................24
Figure 8: Network status window...............................................................................................................................25
Figure 9: Ethernet adapter .........................................................................................................................................25
Figure 10: Ethernet adapter options ..........................................................................................................................26
Figure 11: Ethernet IP Proprieties ..............................................................................................................................26
Figure 12: IP settings window .....................................................................................................................................27
Figure 13: IP settings ..................................................................................................................................................27
Figure 14: LAN connection icons ................................................................................................................................28
Figure 15: LAN information ........................................................................................................................................29
Figure 16: Firewall auto exception .............................................................................................................................30
Figure 17: BeanScape main window...........................................................................................................................30
Figure 18: Start server menu ......................................................................................................................................31
Figure 19: BeanDevices® profiles ...............................................................................................................................31
Figure 20: BeanGateway configuration menu ............................................................................................................35
Figure 21: BeanGateway configuration window on BeanScape.................................................................................36
Figure 22: BeanGateway PAN ID on BeanScape .........................................................................................................37
Figure 23: BeanGateway Profile on BeanScape .........................................................................................................37
Figure 24: BeanDevices profiles .................................................................................................................................38
Figure 25: Right click on BeanDevice profiles .............................................................................................................38
Figure 26: BeanScape Configuration menu ................................................................................................................39
Figure 27: BeanScape configuration window .............................................................................................................39
Figure 28: TCP/UDP tab ..............................................................................................................................................40
Figure 29: Keep alive tab ............................................................................................................................................40
Figure 30: TCP/UDP tab ..............................................................................................................................................41
Figure 31: Language configuration .............................................................................................................................41
Figure 32: System configuration .................................................................................................................................42
Figure 33: Data configuration .....................................................................................................................................42
Figure 34: G value configuration ................................................................................................................................43
Figure 35: Export/Import user settings menu ............................................................................................................44
Figure 36: Custom user configuration window ..........................................................................................................44
Figure 37: User export ................................................................................................................................................45
Figure 38: Custom_DB example .................................................................................................................................45
Figure 39: Custom user configuration window ..........................................................................................................46
Figure 40: Custom user configuration (merge) ..........................................................................................................46
Figure 41: Export window for BeanScape Config .......................................................................................................47
Figure 42: BeanScape Config exportation ..................................................................................................................47
Figure 43: Import function for BeanScape Config ......................................................................................................48
Figure 44: Advanced Settings option ..........................................................................................................................49
Figure 45: Settings Options.........................................................................................................................................49
Figure 46: Add BeanScape to Firewall ........................................................................................................................50
Figure 47: Notification message .................................................................................................................................50
Figure 48: check MATLAB installation ........................................................................................................................50
Figure 49: Pop-up window for MATLAB installation ..................................................................................................50
Figure 50: SQL Server installation ...............................................................................................................................51
1. TECHNICAL SUPPORT
For general contact, technical support, to report documentation errors and to order manuals, contact Beanair
Technical Support Center (BTSC) at:
tech-support@[Link]
For detailed information about where you can buy the Beanair equipment/software or for recommendations on
accessories and components visit:
[Link]
To register for product news and announcements or for product questions contact Beanair’s Technical Support
Center (BTSC).
Our aim is to make this user manual as helpful as possible. Keep us informed of your comments and suggestions
for improvements.
Beanair appreciates feedback from the users of our information.
Symbols Definition
RF Radio Frequency
SD Secure Digital
WSN Wireless sensor Network
In addition to this User manual, please consult the related application notes, technical notes and videos:
Document name
Related product Description
(Click on the weblink)
The aim of this document is to help
TN_RF_013 – « OPC configuration » BeanScape® Premium+ deploying the OPC DA and all associated
services.
The aim of this document is to describe
the autonomy performance of the
TN_RF_012– « BeanDevice® battery life
All the products BeanDevice® SmartSensor® and
in streaming mode »
ProcessSensor® product line in streaming
and streaming mode.
This document aims to highlight the issues
TN_RF_011 – « Coexistence of Beanair affecting co-existence of Beanair WSN
All the products
WSN at 2.4GHz » (IEEE 802.15.4) in the presence of
interference.
This technical note describes the sleeping
TN_RF_010 – « BeanDevice® Power All the BeanDevice® & active power mode on the BeanDevice®.
Management »
TN_RF_009 – « BeanGateway ® BeanGateway ® integration on a LAN
BeanGateway ®
management on LAN infrastructure » infrastructure
TN_RF_008 – “Data acquisition modes Data acquisition modes available on the
All the BeanDevice®
available on the BeanDevice®” BeanDevice®
TN_RF_007 – “BeanDevice® This document presents the DataLogger
All the BeanDevice®
DataLogger User Guide” feature on the BeanDevice®
TN_RF_006 – “WSN Association All the BeanDevice® Description of the BeanDevice® network
process” association
RF_TN_003- “Aggregation capacity of Network capacity characterization of
All the products
wireless sensor networks” Beanair Wireless Sensor Networks
RF_TN_002 V1.0 - Current consumption Current consumption estimation of the
BeanDevice®
in active & sleeping mode BeanDevice in active and sleeping mode
BeanDevice® AN-XX wireless range demonstration BeanDevice® AN-XX & BeanDevice® AN-XX Extender
BeanDevice® AN-XX presentation BeanDevice® AN-XX & BeanDevice® AN-XX Extender
BeanDevice® AX-3D presentation BeanDevice® AX-3D
BeanDevice® HI-INC presentation BeanDevice® HI-INC
BeanDevice® AX-3DS presentation BeanDevice® AX-3DS
BeanScape® – WSN supervision software BeanScape®
5. SYSTEM OVERVIEW
BeanScape® software is suitable for monitoring and configuring BeanAir wireless sensor networks. It is designed
to provide a high level of flexibility and efficiency.
BeanScape® provides the following features:
✓ Monitoring wireless sensor networks.
✓ Displaying configured alarms of different wireless networks.
✓ Sensors calibration and configuration
✓ OTAC (Over-the-air-configuration)
✓ Data and diagnosis analysis through curves and statistics
✓ Ability to store measurements and diagnostic information in a database as a LOG file
✓ Tools for optimizing the installation of wireless sensor networks
The BeanScape® is a powerful software tool with client/server architecture. This implies that the network sensor
communicates with the BeanScape® through a wireless coordinator called BeanGateway®. The BeanScape® acts
as the server and the BeanGateway® acts as the client.
Beanair ® network is comprised of a network coordinator (BeanGateway ®) and wireless sensors (BeanDevice®).
For more information about Synchronous Multicasting, please read the Data acquisition mode
available on the BeanDevice® technical note
The BeanScape® license is related to the BeanGateway® device, i.e. user can install the BeanScape® on
different PC and asynchronously connect it to the same BeanGateway®.
If a new BeanGateway® is acquired, there will be two applications cases:
• The BeanGateway® works independently; a new BeanScape® Basic should be acquired.
The BeanScape software license is linked to the BeanGateway. Therefore, it can be installed on a
different PC/Laptop.
BeanScape®
Manager
(Streaming mode BeanScape® Basic BeanScape® Basic
Operating BeanScape® BeanScape®
not enabled) (Streaming mode not (Streaming mode
Systems Premium+ Premium
enabled) enabled)
RAM memory 1 GB 2 GB 4 GB
Disk Space 5 GB 5 GB 10 GB
To uninstall BeanScape®, go to settings then select the menu Apps. A list of installed applications will be
displayed, go to BeanScape and select uninstall.
BeanScape® BeanGateway®
on a PC
To view the entire wireless sensor network from your BeanScape®, you must firstly connect your
BeanGateway® to a PC where the BeanScape® is installed. Connection is established through an
Ethernet cable.
✓ Make sure the Ethernet cable is connected to both your PC and BeanGateway®
✓ Make sure your BeanGateway® is powered and in "ON" position.
✓ Make sure that your BeanScape® is installed on your PC
6. Ethernet Properties Window will open, select “Internet Protocol Version 4 (TCPv4)” then click OK
7. If your DHCP is enabled (BeanGateway® is connected to an Ethernet Router), make sure that the
option Obtain an IP address automatically is selected
8. If the DHCP option is not enabled, you should enter a static IP [Link] on your PC with a
subnet mask: [Link] Click “OK” to confirm and safeguard your work.
Your computer is now connected to your wireless sensor networks. In order, facilitate these exchanges
you must give commands from BeanScape®.
To have an overview on IP address and the network status of your computer, click on the computer icon
on the bottom of the windows taskbar
On the displayed menu select the profile of your ethernet connection then select again the ethernet
profile on the new window that will be opened to show your network information.
By default, the BeanGateway® IP address is set at [Link] with the DHCP disabled. The
BeanGateway is considered as a client by the BeanScape ® (server) having the IP address by default set to
[Link].
Some firewalls will not permit applications such as BeanScape® (or any applications you have not
specifically allowed) to access your BeanGateway®. Generally, the first time the BeanScape® or another
application tries to access the BeanGateway®, you will be asked if you would like to allow that
application access. If you accidentally clicked No on that message (or if your firewall never asked for
permission to allow the BeanScape® access), you will not be able to use the BeanScape® until you
configure your firewall to allow BeanScape® to access your BeanGateway®.
With most firewalls, this is easy to do. Keep in mind that all firewalls are a bit different, but the process
is usually as follows:
If you are not familiar to configure a firewall exception, you can directly from BeanScape® add this rule
automatically.
On the BeanScape® menu select Tools, then Advanced Settings then click on validate to add BeanScape®
to the Firewall.
The BeanScape® server starts and creates the BeanDevice® mapping based.
9.5 HOW THE CONNECTION IS ESTABLISHED BETWEEN THE BEANGATEWAY® AND THE
BEANSCAPE® ?
BeanScape® BeanGateway®
Socket Connexion Request
ACK
Server Client
BeanScape® BeanGateway®
Time transmission through
NTP (Net Time protocol)
ACK
Step 3: •The BeanGateway® profile is retained on its flash memory. This profile
BeanGateway® contains are the informations about the BeanGateway® ID (NWK Add,
PAN ID, MAC ID, IP...) , versions ID (Hardware, embedded software,
Profile stack...), Radio Management parameters (Radio channel, TX Power, ....)
•The BeanGateway® profile is transmitted to the BeanScape®
Transmission
BeanScape® BeanGateway®
BeanGateway®
profile Transmission
ACK
BeanGateway®
BeanGateway ®
profile are
profile is
backuped on backuped on a
BeanScape Flash memory
Database
• The WSN mapping concerns all the Beandevice® profile. The WSN
Step 4: WSN mapping is backuped on the BeanGateway® flash memory. When a new
BeanDevice® joins a WSN, its profile is transmitted to the BeanGateway®
Mapping and the BeanScape®.
• The BeanScape® displays the WSN Mapping with the BeanDevice® profile;
transmission • WSN Mapping is backuped on the BeanScape® Database.
BeanScape® BeanGateway®
BeanDevice®
profile Transmission
ACK
BeanDevice® BeanDevice®
profile are profile are
backuped on backuped on a
BeanScape® Flash memory
Database
The WSN Time & Date is synchronized with your PC. The User must make sure that the Time & Date
on his computer is updated.
Click on the following weblink to see the video: BeanGateway® Ethernet/LAN Configuration, directly
connected to the Laptop/PC
Please check your Network settings before you make any changes.
By default, the BeanGateway® is configured with a static IP address: [Link]. This allows the user to quickly
connect the BeanGateway® to a PC.
If you want to set the BeanGateway® IP on your business network and get a dynamic IP address (via DHCP), you
can configure the BeanGateway® via a serial port or via the Ethernet.
Go on your BeanGateway® profile and click on Tools | BeanGateway Ethernet/LAN Config.
✓ DHCP Enabled: Check this case if you want to enable the DHCP. For further information about DHCP read the
Technical Note “BeanGateway® management on your Local Area Network infrastructure”.
✓ If DHCP is not activated, the user must configure the BeanGateway® IP parameters:
o IP Address: BeanGateway IP Address. The BeanGateway® IP address should have the following
form: “X.Y.Z.B“. With A, B, X, Y and Z numbers between 0 and 255
o Subnet Network mask: The subnet mask is set to "[Link]" by default
o Gateway IP Address: Subnet network mask
✓ DNS Enabled: Check this case if you want to enable the DNS. For further information about DNS read the
Technical Note “BeanGateway® management on your Local Area Network infrastructure”.
✓ The gateway IP address subnet is the default "X.Y.Z.1"
✓ Port: By default, the communication port used is «5313". This port is generally free, if not choose another
Socket Port.
For further information, please read the following technical note – TN_RF_009 – « BeanGateway®
management on LAN infrastructure »
For further information about the BeanGateway®, please read the BeanGateway® user manual.
Click on the BeanDevice® folder tree on the left side pane, you will obtain all the information about your
BeanDevice® connected to your network.
You can Rename, restart or remove the BeanDevice® quickly by using the right button of your mouse, without
using the advanced options.
For further information about your BeanDevice®, please read the BeanDevice® user manual.
This window lets you configure the logs, data cache and Ethernet/LAN link between the BeanDevice® and the
BeanGateway®.
✓ A second window will appear:
o Keep alive timeout is the duration between two keep alive transmissions in idle
condition. TCP keepalive period is required to be configurable and by default is set to no
less than 2 hours.
o Keep alive interval is the duration between two successive keep alive retransmissions, if
acknowledgement to the previous keep alive transmission is not received.
o Max retry is the number of retransmissions to be carried out before declaring that
remote end is not available.
Keepalive packet contains null data. In a TCP/IP over Ethernet network, a keepalive frame is of 60 bytes,
while acknowledge to this also null data frame and is of 54 bytes.
✓ Alarm automatic display: Check this box if you want to see an alarm window displayed automatically
when a window alarm threshold is exceeded.
✓ Alarm➔ Sound Effect: Check this box if you want to hear a sound effect when a threshold is exceeded.
• Maximum number of points: Set here the maximum number of points displayed on the BeanScape®
Wilow® graph
• Maximum number of packets: Set here the maximum number of packets displayed on the BeanScape®
Wilow® graph
• Max number of diagnostics: Set here the maximum number of diagnostics displayed on the BeanScape®
Wilow® graph
• Maximum streaming points: Set here the maximum number of points displayed in Streaming on the
BeanScape® Wilow® graph
Please note that the values backed up by the BeanScape® may affect the memory capacity of your
computer depending upon the size of every file.
10.7 G VALUE
Because there are slight variations in the G value about earth’s surface within the value of G dependent upon
location, user have the possibility to set the corresponding G value from BeanScape Configuration option.
A new window will appear, which contains the Custom User Configuration and the BeanScape Configuration,
• Custom User Configuration represent the settings that have relationship with the BeanGateway and the
BeanDevices.
Click on Replace to import user configuration, by choosing replace function the old Custom_DB will be replaced
with the new one.
By choosing Merge function the old Custom_DB will be merged with the new one.
Don’t try to change manually the XML file, there is a high risk to corrupt it.
A new window will pop up in which user can find several settings
12.1 FIREWALL
Click on Add button in order to add BeanScape on firewall, with that user will be sure that the firewall will not
interrupt the connection between BeanScape software and the BeanGateway.
Right after clicking on Add a notification message will be displayed on the screen saying that BeanScape was
added to firewall successfully.
In this section user can check if MATLAB is installed with BeanScape software otherwise he has the possibility to
download it.
Click on Check to check if the MATLAB function is installed or not.
If it’s already installed a pop-up window will appear telling that MATLAB is installed on your PC.
Otherwise if not user can download the MATLAB-MCR just by hitting the Download button.
Click on Check to check if the SQL Server was installed on your PC.
If the SQL Server is installed a pop-up notification will be displayed on the PC screen saying that the SQL Server is
already installed.
BeanScape® Multiview version offers a multi-user interface. It enables real time remote access from a
BeanScape® Client to the network configuration performed on BeanScape Server.
This new version of BeanScape software can be installed in two PCs, configured as a server in one of them and
configured as Client in the other.
The BeanGateway must be connected with an Ethernet cable (directly or via a switch) to the PC where BeanScape is
configured as Server.
After restarting BeanScape the new configuration will take place and you will figure out that the Server menu
become Client.
• Go to tools and click on Localize BSC srv to localize the BeanScape® server that you like to connect to.
• Click Localize
• Click validate
The user has access to all the profile details of the BeanDevice and the BeanGateway as well as all the
configuration tabs of the BeanDevice (data acquisition configuration, Datalogger, power mode management…)
and of the BeanGateway (Radio Config, System Config, Modbus, Multicasting…).
The BeanScape® configured as Client gives access only to the profile details of the BeanDevice and the
BeanGateway®.
To allow to the Client to change the configuration and to send OTACs you must Enable this option on BeanScape®
Configuration.
The BeanDevices® will be shown in the same way like on BeanScape® server, but in this case all the configuration
option will be disactivated if not allowed to the client.
The access to the BeanGateway options will be limited from a BeanScape Client.
14. APPENDIX
On the server side, hosting the BeanScape® Multiview, you should setup a VPN server, which let the distant Client
localize it remotely.
To configure an Incoming VPN connection, please follow the next steps.
3) Using the left pane, click the Change adapter settings link.
4)
On “Network Connections,” open the File menu pressing the Alt key, and select the New Incoming
Connection option.
5) Check the users you want to VPN access to your computer and click the Next button.
6) Check the users you want to VPN access to your computer and click the Next button.
10) In the networking software page, select Internet Protocol Version 4 (TCP/IPv4) option.
12) Under “IP address assignment,” click Specify IP addresses, and specify the number of clients allowed to
access using a VPN connection. (You will do this by specifying an IP address range, and it’s recommended
that you use high-order range of IP addresses to help avoid conflicts in the network with the IPs
distributed by your router.
15) Click the Close button to complete setting up the VPN server on Windows 10.
1) Open Start.
2) Search for Allow an app through Windows Firewall and click the top result to open the experience.
4) Scroll down and make sure Routing and Remote Access is allowed on Private and Public.
On the Client side, before installing BeanScape® Client, user have to setup a VPN connection to establish the link
with the distant BeanScape Multiview Server.
To create a new VPN connection:
1) Go to setting
3) On the Left panel, click on VPN then select “Add a VPN connection”
4) Tape the Public Ip of your VPN and use the Login parameters already created
If you are using a Public Dynamic IP, tape the DDNS address instead of the IP (see Case of Dynamic IP)
5) Go the Network Adapter Settings and Right click on the VPN Connection Profile
On Properties go to Networking tab and edit the Internet Protocol Version 4 Parameters by assigning to the VPN
Client the First IP address on the VPN Range.
In our example the VPN server address is [Link], the Client should be configured : [Link] to receive the
first IP of the range.
Go to Advanced and Disable using the Default gateway by the VPN Client
6) On the Security tab, Please make sure that following options are respected
1) On the BeanScape Client, Go to Tools and select BSC srv to localize the distant Multiview server.
2) Select the IP address assigned to your computer by the VPN connection and click on Localize
In case of Public Dynamic IP on the VPN server side, it is recommended to use NO-IP/Dynamic DNS. Using a DDNS
will solve the issue of dynamic IP and keep your VPN Client connected to the VPN server.
To configure your DDN:
1) Go to an online DDNS provider like [Link]
3) Create a Hostname
4) Install the NO-IP Agent on the Computer hosting the VPN server to update automatically the state of
Public IP
5) On the VPN Client Side use the DDNS address to configure your VPN connection
Auto-starting BeanScape® monitoring software is highly recommended for users who need to run test on times of
the day with no human intervention. For example, when you need to take temperature measures during the night
and no employee is available to open the software and run the server.
Here we provide a quick solution:
• Check “AutoStart BeanScape” box. This will start automatically the software.
By default, firewall blocks all unknown network traffic coming in to the network. To permit traffic through
the firewall we create exceptions (or rules) that allow certain traffic on the network. In our case the rules are
defined by the software which is BeanScape.
Usually when launching BeanScape for the first time your Windows OS will ask you to add an exception and to
allow the software to use your network resources, however in case this doesn’t occur or rejected, manually
adding BeanScape to exceptions list is possible through these following steps:
1. Use your Search bar at the windows launcher and look for “Allow an app through Windows
Firewall”
2. Look for BeanScape in the list and check its box, check Private if you are only willing to use
BeanScape in your LAN or Public for allowing remote access from outside the [Link] and
your BeanScape will be allowed in your network.
If you are not familiar to configure a firewall exception, you can directly from BeanScape® add this rule
automatically.
On the BeanScape® menu select Tools, then Advanced Settings then click on validate to add BeanScape®
to the Firewall.