Workbook SmartStruxure Lite - Ver 1.2.0
Workbook SmartStruxure Lite - Ver 1.2.0
Workbook SmartStruxure Lite - Ver 1.2.0
TM
SmartStruxure LITE
1. Introduction ............................................................................................................... 5
2. Introduction to SmartStruxure Lite - Summary ....................................................... 6
Exercises - Equipment (per station)................................................................................ 7
2.1 Connect to the MPM .................................................................................................................. 8
2.2 MPM Configuration .................................................................................................................. 10
2.3 Configuration - Analog Input..................................................................................................... 11
2.4 Configuration - Other Variables ................................................................................................ 13
2.5 Export of the Default Database ................................................................................................ 15
2.6 Export of the Configuration Database ...................................................................................... 16
2.7 Factory Reset with the Bootloader ........................................................................................... 17
2.8 Firmware Upgrade ................................................................................................................... 18
2.9 Upload of the Configuration Database ..................................................................................... 19
2.10 Import of the Default Database ................................................................................................ 20
2.11 Create an User Account ........................................................................................................... 21
2.12 MPM settings ........................................................................................................................... 22
2.13 Setting up a ZigBee PRO Network ........................................................................................... 23
2.14 Forming a ZigBee MPM Network ............................................................................................. 26
2.15 Forming a CANbus Network..................................................................................................... 29
2.16 Deployment of EnOcean Devices ............................................................................................ 31
2.17 The Building Expert Interface - Part 1 ...................................................................................... 35
2.18 The Building Expert Interface - Part 2 ...................................................................................... 40
2.19 Graphical Programming ........................................................................................................... 44
2.20 Lua-Scripting ............................................................................................................................ 47
2.21 Analyzing Devices with the DolphinView analyzing tool ........................................................... 49
2.22 Exchange of Data between MPMs ........................................................................................... 52
2.23 MPM Monitor in StruxureWare Building Operation ................................................................... 55
2.24 EcoStruxure Web Services and SmartStruxure Lite ................................................................. 59
Extra Exercises ................................................................................................................................ 61
2.25 Troubleshooting - The Log File ................................................................................................ 62
2.26 Troubleshooting - Find the IP Address ..................................................................................... 63
2.27 Implement the Spanish language pack .................................................................................... 64
2.28 Modbus I/O-module - Binary signals ........................................................................................ 65
2.29 Modbus I/O-module - Analog signals ....................................................................................... 67
Structure
This Workbook includes a number of exercises. These
exercises will provide a brief overview of the tasks with specific
instructions for completing them.
Emphasized Text
Throughout the manual the following specially marked texts may occur.
Warning
Caution
Important
Note
Tip
Tasks:
Steps:
Set the IP address of the PC:
1. Connect the Ethernet cable between the PC and the MPM device
2. Open the Control Panel in the PC, select Network and sharing center
3. Select Change adapter settings, select Properties
4. Select the IP interface - Double click
5. Click on the Internet Protocol version 4, click on Properties
6. Type the IP address 10.50.80.10
7. Type the Subnet mask 255.0.0.0, keep the other settings to the default.
Follow the instruction slavishly for the user name and the password. If the password is
forgotten it can't be resolved for the present database (project) without contacting the
Product Support Services (PSS) for assistance.
Tasks:
- Check all Configurations and Settings in MPM
Steps:
1. Check the BACnet Configuration
2. Check the Communication Configuration
3. Check the CANbus Configuration (Settings)
4. Check the Controller Configuration (Settings). Which Version (firmware) __________
has the controller, please write it down in the workbook?
5. Check the EnOcean Configuration (Settings), please don't change anything.
Which Base ID has the controller __________, how many times more could the
Base ID be changed, look at Set Id Left: __________ ?
6. Check the Ethernet Configuration (Settings)
7. Check the Modbus Configuration (Settings)
8. Check the SNTP Configuration (Settings)
9. Check the ZigBee Configuration (Settings)
Tasks:
- Create an analog input
- Connect the analog input to a pre-configured thermistor type/range
- Create a customized Analog Input Configuration type/range
- Connect the analog input to the customized analog input configuration
- Change the calibration objects
Steps:
Create an analog input:
1. Create an Analog input, Add objects, select AI1.
2. Click on the created object in the Object column, name it Temperature MPM - Save.
3. Configure the input type to Ohms - Save.
4. A resistance value is represented in the Explorer/Object view as in the configuration
window, approx at 1900 ohm's.
Starting point:
- AO4 should be added as an object and have the value set to 10 V (it is the source of
power to the binary output LED)
Tasks:
- Adding different types of variables; Analog Output, Binary Output, Analog Value,
Binary value and a Multi State value
AI1 - AI6 and BI1 - BI6 are sharing the same physical inputs. In the exercise
below is the first BI selected to be BI2, because AI1 (equivalent to BI1) is
already used for a temperature value in the previous exercise. A physical
binary input is considered as 0, off or false when the input voltage is below 2
VDC. If the input voltage is above 2 VDC is it considered as 1, on or true.
Steps:
4. Select Add Objects, filter Analog Output, select AO1, Add Objects.
5. Rename the object to AHU01 Heating Output.
6. Set Value to 10 V - Save.
7. Check the output value in the Object pane, also check the LED representing the
analog output AO1.
8. Set the Value to 0 V - Save.
9. Select Add Objects, filter Analog Output, select AO2, Add Objects.
10. Rename the object to AHU01 Cooling Output.
11. Set Value to 10 V - Save.
12. Check the output value in the Object pane, also check the LED representing the
analog output AO2.
13. Set the Value to 0 V - Save.
14. Select Add Objects, filter Binary Output, select BO1, Add Objects.
15. Rename the object to Heating.
16. Set Value to 1 - Save.
23. Select Add Objects, filter Analog Value, select AV99, Add Objects.
24. Name it to AHU01 Setpoint Temperature.
25. Set Units to Degree Celsius - Save.
26. Set Value to 20 - Save.
27. Check the analog value in the Object pane.
28. Select Add Objects, filter Binary Input, select BI2, Add Objects.
29. Name it to Extended Operation - Save.
30. Check the input with the panel switch no. 1, turn it on and off.
31. Check the binary value in the Object pane (1).
32. This binary input signal is sensed as a voltage, either 0 VDC or 10 VDC. It is powered
from an output terminal block on the MPM.
40. Select Add Objects, filter Multi State Value, select MV1, Add Objects.
41. Name it to Operation Mode Room 123 - Save.
42. Create six states (click in the State text area), example only will not be used in any
exercise,
1 Unocc Heat, 2 Stand-By Heat, 3 Occ Heat, 4 Occ Cool, 5 Stand-By Cool, 6 Unocc
Cool, - Save.
43. Highlight different Present values & Save and check the value in the Object pane (1).
Tasks:
Steps:
Tasks:
Steps:
Tasks:
- Factory Reset with the Bootloader
Steps:
Tasks:
- Upgrading to the latest firmware of the MPM device
- Upgrading to the latest firmware of the MPM device
Steps:
7. Select the Firmware Upgrade button and select the firmware file to be downloaded.
8. Answer Yes in the next dialog "Proceed with the firmware..".
9. The controller restarts automatically, restart the browser and log in to the MPM
(controller) after about 15 minutes.
Tasks:
- Upload of the MPM configuration database
Steps:
Tasks:
Steps:
Tasks:
- Create and define a new role
- Create a new user
- Check the permissions
Steps:
Is it possible to do any configurations with the new analog input, change the Gain for
example?
11. Continue with the Engineering role for all coming exercises!
Tasks:
- Rename the MPM-device
- Change the device Instance number
- Date and time settings
Steps:
Note
The time and date settings may change back year 2000 after a power up, the reason in
such case is probably the internal battery that has lost its power, this happens with MPMs
that aren't power continously. After 6 month of no power supply the power of the battery
is emptied.
Tasks:
- Assigning ZigBee Stack Profile
- Assigning a Security profile
- Set the Node Type (done before)
- Set the Short Network ID
- Set the Channel
- Set the External Network ID
- Check the Communication Configuration
- Add a Zone controller the network with the required settings
Steps:
14. Secondly, open the object ZigBee Room Controller Configuration in the
Explorer/Object view for the above added and configured device.
Comment:
If there is a problem to join the network, change to another PAN ID (+1) for the
devices, change to the same PAN ID in the MPM. This will reset the internal ZigBee
addresses
15. Thirdly, click the Bind button, in the representation of the SER8350, in the MPM. A
discovery dialog opens, wait for the initialization to be ready. Highlight the device you
want to bind in, click on the button Bind device to confirm the bind process, SAVE.
17. Save database to flash, all configurations such as Controller status, configuration
changes, updates, and Lua scripts will be saved. It's a good habit to save from time to
time
Tasks:
- Configure the settings in in the MPM Manager
- Connect to the MPM Gateway
- Download the latest firmware to the MPM Gateway
- Configure the settings in the MPM Gateway
- Add a ZigBee controller to the MPM Gateway
- Check the ZigBee MPM network
To form a ZigBee network, each MPM (Manager) needs to be configured with 3 common
ZigBee settings: the ZigBee channel number, as well as the ZigBee extended and short
network IDs. Once those settings are matching, the MPM's (Managers) will be part of the
same network.
Steps:
Configure the settings in the MPM Manager:
1. Connect to the first MPM (Manager) at IP 10.50.80.3 and login.
2. Click the ZBC1 ZigBee Configuration object.
3. Set the following settings in the first MPM:
10. Save the configuration by using the Save database to flash command.
Tasks:
- Configure the CANbus interface in the CDR-Floor-01 (Passive Mode):
- Configure the CANbus interface in the Router-Floor-02 (Monitor Mode):
- Change values in the connected SER8300 device to the CDR-Floor-01 MPM device:
- Heat up the sensor and check the updating period:
- Configure both the MPMs as Monitors with different communication interfaces:
Steps:
29. Backup all four (4) databases (default as config), save the files in the course folder
Backup.....
Tasks:
- EnOcean settings in the MPM
- Add two (one) switches to the MPM
- Installation of the DolphinView EnOcean analyzing tool
- Add a relay to the MPM
- Connect switches to the relay
- Add a thermostat to the MPM
Steps:
There are different procedures depending on the firmware version of the MPM, earlier
versions than 2.15 follow step 17 and skip step 18. From version 2.15 follow step 18 and
skip step 17.
To synchronize a Manager with a remote EnOcean relay, you must activate the learn
process on the physical relay and use the virtual switch from the Object Detail View panel to
15. Connect a lamp or light source to the hardware relay and then apply power to the relay.
16. Press on the hardware relay LRN button, usually located on the side of the relay. The
connected light source will start blinking, indicating the relay is in learn mode.
17. Press the virtual switch, in the ON position (green) 3 times within a short period of
time inside the Object Detail View panel. The blinking will be interrupted for about 1
second when the relay receives the telegram sent from the MPM device.
18. Activate the Teach command for the EnOcean relay object, click on the TeachIn
command in the dialog.
19. Wait until the light stops blinking, indicating the relay has completed the learn sequence.
This may take up to 30 seconds
20. Test the functionality, turn on and off the light source from the MPM by changing the
switch virtually.
Tasks:
- Create an Alarm Event
- Graphic Handling
- Section Grid Handling
- Creating Trend logs
- Dashboard Handling
Steps:
Create an Alarm Event:
1. Information - An Event could describe an error condition or an alarm that other objects
need to be notified about.
2. Create an Event object in the Explorer/Object view. Select Add Objects, select Event
as the filter, add the first available Event object (EV1), click on Add Objects to confirm
the selected object.
3. Highlight the created object in the Explorer/Object view. Rename the object to Room 01
Alarm High Temp.
4. Connect the temperature value RoomTemp (AV41) as the Object Property Reference.
The chosen reference is the temperature value from the Room 01 controller (Room01-
SER8301).
5. Keep the Low Limit value to the default 0.
6. Set the High Limit value to 26 C.
7. Set the Time Delay to 5 seconds.
8. Skip the Email Destination address. SAVE the configuration.
9. Push the Play button to activate the alarm.
10. Highlight the Room 01 Alarm High Temp object in the Explorer/Object view and notice
the actual value. The value should be 0 if the present room temperature is below High
Limit of 26 C. Heat up the sensor above 26 C and notice the alarm value (Event State)
in the view (the temp sensor is located in the bottom left corner behind the cover, closely
to the left of the PIR connection). 0 means normal state, 3 means alarm above the High
Limit state and 4 means alarm beneath the Low Limit state.
11. There are at least four different solutions to be notified about an alarm, the first and the
second is via the web interface, the Explorer/Object view and via a graphical view in the
MPM, the third method is an alarm notification by Email and the fourth by an output.
44. Add a new text (copy and paste is possible) directly below the first text and type Settings
Temperature - SER8301Room01.
45. Font size: 20
46. Add a Value Table directly below the latest created text (it could required to narrow the
columns if the check boxes aren't visible).
47. Check the following check boxes: OccHeatSetpoint (AV28), OccCoolSetpoint (AV27),
UnoccHeatSetpoint (AV56) and UnoccCoolSetpoint (AV55).
48. Keep the default checked boxes in the bottom left corner.
49. Add a another text directly below the Value Table and type Occupied Heating Setpoint.
50. Font size: 20
51. Add a Graph Onyx Themed Slider directly below the latest created text.
52. Value: OccHeatSetpoint (AV28),
53. Lower Limit: 15, Midpoint: 20, Upper Limit: 25, Internal Count: 1, keep the default
colors.
58. Copy and paste the text below the ..slider, rename the text to Unoccupied Heating
Setpoint.
59. Add a Graph Onyx Themed Slider directly below the latest created text.
60. Value: UnoccHeatSetpoint (AV56).
61. Lower Limit: 10, Midpoint: 15, Upper Limit: 20, Internal Count: 1, keep the default
colors.
62. Copy and paste the text below the ..slider, rename the text to Unoccupied Cooling
Setpoint.
63. Add the last Graph Onyx Themed Slider directly below the text.
64. Value: UnoccCoolSetpoint (AV55).
65. Lower Limit: 24, Midpoint: 27, Upper Limit: 30, Internal Count: 1, keep the default
colors.
66. Create a temperature representation according to the picture below with the according
reference objects.
Tasks:
- Calendars
- Schedules
- PID Controller
- Import and Export of objects
Steps:
Calendars:
1. Create two (2) Calendar objects in the Explorer/Object view. Select Add Objects, select
Calendar as the filter, add both availble Calendar objects (Cal1 and 2), click on Add
Objects to confirm the selected objects.
2. Rename the first calendar object to Calendar Reccurence (CAL1) and the second to
Calendar Year 2014 (CAL2).
3. Add the four (4) reccurence dates, 1st January, 1st May, 25th December and the 31st
December to the first calendar (CAL1).
4. Add the date range 20th to 21st of April, year 2014 (Easter period) to the second
calendar (CAL2).
PID Controller:
18. Add a PID Controller object in the Explorer/Object view. Select Add Objects, select the
first available PID Controller object (CO1).
19. Rename the object to AHU01-Controller, Save.
20. Select the following reference, variables and settings:
21. Controlled Variable (input): AHU01 Temperature (AI4).
22. Setpoint Reference: AHU01 Setpoint Temperature (AV99).
23. Manipulated Variable (output): AHU01 Heating_Cooling (AV100).
24. Setpoint: 20 C (controlled by the variable AHU01 Setpoint Temperature).
25. Bias: Keep the default (50).
26. Action: Reverse
27. Proportional Band: 20
28. Proportional Deadband: 0
29. Integral Reset Rate: 0
30. Integral Reset Band: 0
31. Derivative Gain: 0
32. Derivative Sample Time 10 (can't be changed)
33. Save all settings.
Proportional Settings
34. Start the PID Controller by the Play button.
35. Set the value of AHU01 Temperature to 20 C by the potentiometer.
Integral Settings
45. Set the value of AHU01 Temperature to 15 C by the potentiometer and the setpoint to
20 C.
46. Set the Integral Reset Rate to 10 %/min.
47. Set the Bias to 50, Save
48. Calculate the theoretical Bias and output Value(s) from controller and write down the
present values according to the table below. The practical exercise starts when the Play
button is activated. See the starting point for the exercise in the table below, if needed
adjust the settings without the Integral function until the starting point is reached. In
practise activate the Play button about 7 - 8 seconds before the exercise starts, it takes
those seconds for the controller to properly be up to date with all values.
49. What is your conclusion of the PID Controller exercises, please write it down?
Tasks:
- Create analog values to use as constant variables
- Create a Lua Program for graphical programming
- Connect a PID controller output to two analog output signals with graphical
programming
Steps:
Connect a PID controller output to two analog output signals with graphical
programming:
5. Click on the created Lua Program object below the Script tab in the Object view in,
select Edit.
6. Open the Graphical Program window by selecting the Graphical Editor.
7. Build the graphical application according to picture on the next page in this workbook,
select either Alternative 1, 2 or 3 as your application.
8. The Tools to use are hidden default, click on the arrows in the upper left corner.
Graphical Programming
Alternative 1
Alternative 3
Tasks:
- Create a Lua Program object
- Import a Lua Program
- Edit a Lua Program
- Make your own changes
Be aware of:
- Use the documentation about Lua scripting in the course folder in the memory
stick or in the PC
Steps:
Lua Program - Building Automation:
1. Create a Lua Program object, select PG1, Add Objects
2. Rename the object to Lua Script - Building Automation, Save
6. Check the functionality in the Output view, click on the Output button.
Tasks:
- Prepare the DolphinView for analyzing
- Set the EnOcean Equipment Profile (EEP) for the devices
- Exporting node statistics
- Checking the signal strength
Steps:
Prepare the DolphinView for analyzing:
1. Open the DolphinView application in the PC.
2. Click the Connect button in the top bar or use the F5 button.
3. Activate (when authorized by the trainer) all your EnOcean devices and watch the
DolphinView Telegram Log window, starting with group 1 (bench 1). The trainer tells
each group when to start the activation.
4. On the left side in the Node List view all devices that have sent a message since the
logging started will pop up.
5. Rename the devices to the function they have in the Node Properties view below the
Node List view.
6. Add your devices to the Workspace by a double click on each device.
8. Create an ID filter in the Telegram Log view. Click on the ID column header in the
Telegram Log view, tick in the check box, Selected Node, and click Apply Filter.
9. Activate a certain node by clicking on the node in the Node List view, the historical
(since the application was started, or since the last Cleared log) communication for the
selected node will show up.
16. After how many meters was the last signal received for the Off button (data 70)?
(15 m)
Tasks:
- Create a Lua Script for an exchange of values from the Monitor to the Passive node
- Create Analog Values in the Passive node
- Create a Lua Script in the Passive node for an average calculation of zone
temperatures from both the Monitor and the Passive node
MPM-
SE8301 MPM
GW
Lua script in the Monitor device Lua script in the Passive device
-- Exchange of data from the Monitor MPM -- Average temperature calculation of 3 zones
device to the MPM Passive device
Create a Lua Script for an exchange of values from the Monitor to the Passive node:
1. Add a Lua Program in the CDR-Floor-01 device; name it Lua Script - Data
Exchange.
Comment: The use of the above transfer of signals should not be used too much, maximum
3 - 5 points in this format, it will create a big load that affects the total performance. A script
with COV functionality should be used instead if there are many signals to handle, it will
minimize the traffic load and the performance.
Create a Lua Script in the Passive node for an average calculation of zone
temperatures from both the Monitor and the Passive node:
5. Add a Lua Program in the Router-Floor-02 device; name it Lua Script - Average
Calculation.
Tasks:
- Set the protocol to BACnet IP
- Create the interface in StruxureWare Building Operation
- Discovering and select the BACnet devices
- Check the MPM values in StruxureWare Building Operation
Steps:
Set the protocol to BACnet IP:
1. Open the BACnet Configuration object in the MPM, make sure that the protocol is set
to BACnet IP
Tasks:
- Connect a SmartStruxure Lite system to a StruxureWare Building Operation using
ExoStruxure Web Services
Software:
- SBO Enterprise Server
- SBO WorkStation
- StruxureWare Building Operation (web server)
Steps:
Create a folder in the SBO WorkStation:
1. Start the SBO Enterprise Server (if the IP address was configured after the SBO
Enterprise Server was started, Stop the Service and Start the Service again).
2. Log on to the SBO WorkStation.
3. Create a folder on the root level in the WorkStation, name it EWS.
Tasks:
- Troubleshooting - The Log File
- Troubleshooting - Find the IP Address
- Language pack (Spanish)
- Modbus I/O module - Binary Signals
- Modbus I/O module - Analog Signals
Tasks:
- Open the the log file "log.dat" in the root folder
Steps:
Analyze the content of the log file:
1. Open the log.dat by the following command; 10.50.80.3/root/log.dat (in this case the
default IP address, for commissioned MPMs on site the IP address is probably not using
the default P address as in this example).
2. "Analyze" the content of the file, go through the whole content of the file.
3. When was the latest successful upload of the config.db?
4. When was the latest firmware upgrade executed?
5. How many firmware versions have been used in this specific MPM?
Tasks:
- Find the IP address of an unknown IP address of an commissioned MPM device.
Steps:
Find the IP address of the MPM devices:
1. Open the Bootloader mode.
2. Create a copy of configuration database by the command 10.50.80.2/root/config.db.
3. Open the file with Notepad, search for the acronym ETH1_Ip. The IP address is found
directly after the acronym ETH1_Ip.
Tasks:
- Implement a Spanish language pack in the MPM.
Steps:
Edit and upload the languages.json file:
1. Open a copy of the languages.json file with Notepad and edit the file, i.e. delete the
other languages, keep the Spanish part according to the below highlighted text. The
original file is located at the root level of the language pack in the firmware package.
{
"es": {
"label": "Espaol",
"translations": "/root/data/baswi-es.po"
}
}
Tasks:
- Create binary values and import of a Lua Script used for a Modbus I/O module.
Steps:
Create binary values and import a Lua Script:
1. Create the following binary values according to the table below.
2. Create a Lua Program object, select PG4, name it to Lua Script - Modbus IO Binary.
3. Import a Lua Script named Lua Script - Modbus IO Binary (PG4) to the above Lua
Program object.
Tasks:
- Create analog values and import of a Lua Script used for a Modbus I/O module.
Tasks:
- Create analog values in the MPM representing values in the actuator
- Import a pre-made Lua program for the actuator SAB02
- Prepare the actuator
- Learn and pair the actuator and the MPM
- Control the valve position of the actuator
- Control the temperature setpoint to the actuator
One group at the time is working with the pairing to avoid communication
conflicts. A "property" is used to highlight who or whom in charge.
Steps:
Stop the other Lua programs:
1. Check the Total CPU Load and the Lua PG CPU Load.
2. Stop the Lua PG1 and PG2 from Execution.
3. Check the Total CPU Load and the Lua PG CPU Load again, is there a difference. You
may need to wait a short period before you could see a change.
5. Add a Lua Program Object (PG2) in the MPM; name the object to Lua Script -
Actuator SAB02_01.
8. All values in the Explorer/Object view should have the value 0 represented by ME.AV91
to ME.AV95, i.e. from the Actuator ID to Actuator Temperature Setpoint.
9. Start the program application Actuator SAB02_01, select Edit, the application opens up a
new window. Open up the Output view as well. Lay down all other applications running
in the PC and select the Windows command "Show windows side by side" by right
clicking next to the PC time in the right bottom corner.
10. All analog values ME.AV91 - ME.AV95 should have the value 0 (zero) before the
matching scenario starts between the actuator and the MPM (server).
15. Push the Learn button once more, the LEDs are flashing with increased frequency,
please mount the valve within this flashing (if the valve exist). After a successful second
press the actuator enters normal operating mode. For sending a renewal Learn telegram
only a short press at the button is needed.
Caution
Be patient. Working with EnOcean devices requires time, time to wait for response, which
is a consequence of the energy harvesting approach. The communication between
devices is hold to a minimum.