Module Change

From OpenMotics
Jump to: navigation, search

How to enable Large Installation mode

Large installation mode is specially used when output modules are used in Roller/Shutter mode. We advise to always enable Large Installation mode (even when no output modules in Roller/Shutter are used) and do this before adding modules.

Step 1

Set the right value in the eeprom to enable Large Installation mode:

eeprom write 0 27 0

Step 2

Activate the eeprom changes:

eeprom activate

After this step, you can add your modules. Once modules are added, you'll see the modules that are added and you can also see that Large installation mode is enabled

error list

This is the feedback you'll get on the console in maintenance mode:

[openmotics]$ error list
i2c errors: 0/0 1:1
00 I 073.027.055.110 0 No Errors
01 I 073.229.202.148 0 No Errors
02 I 073.107.214.173 0 No Errors
03 I 073.026.052.105 0 No Errors
04 I 073.117.235.214 0 No Errors
05 I 073.083.166.076 0 No Errors
06 I 073.203.150.045 0 No Errors
00 D 068.190.125.251 0 No Errors
01 O 079.020.040.081 0 No Errors
02 O 079.245.235.214 0 No Errors
03 O 079.208.161.067 0 No Errors
Large Installation enabled
00 R 082.121.242.229 Roller/Shutter
01 R 082.084.169.082 Roller/Shutter
[openmotics]$

How to add modules using the CLI commands in Maintenance mode

It's very simple to add modules using the maintenance mode on cloud.openmotics.com. Open maintenance mode, connect to your system by typing connect.

Step 1

We'll put the BUS in discovery mode:

module discover start

Step 2

Press the the init button of the modules you want to add. You'll see the modules being added on the maintenance interface.

Step 3

End the discovery mode:

module discover stop

How to remove the last added Input type module

Following modules are categorized as Input type module: - Input Module - Sensor/temperature Module - Can Control Module

Step 1

First check the number of input type modules that are configured:

input number modules read

For example, the result of this instruction is 5

Step 2

Change the number of input type modules:

input number modules write 4        ; change the number of modules to 4 so the last module in our example will be deleted

How to remove the last added Output type module

Following modules are categorized as Output type module: - Output Module - Output Module in Roller/Shutter mode but the installation is not in Large Installation mode - Dim Control Module

Step 1

First check the number of output type modules that are configured:

output number modules read

For example, the result of this instruction is 5

Step 2

Change the number of input type modules:

output number modules write 4       ; change the number of modules to 4 so the last module in our example will be deleted

How to remove the last added Output module configured as Roller/Shutter in Large Installation mode

Step 1

First check the number of output modules configured as Roller/shutter in Large Installation mode that are configured:

eeprom read 0 3

For example, the result of this instruction is 3

Step 2

Change the number of input type modules:

eeprom write 0 3 2                 ; change the number of modules to 2 so the last module in our example will be deleted

Step 3

Activate the changes:

eeprom activate

How to switch Output modules configured as Roller/Shutter in Large Installation mode

When you want to change position of a Roller/shutter module (when large installation mode is enabled), you have to switch the ID's from 1 position to another. Each module has an ID composed of 4 bytes(ID0..ID3). This ID is kept in the eeprom of the master.

What typically is done, when you want to change the position or replace a module, is to switch the ID's of a module. Take the following example: - We've 2 Roller/Shutter modules and the 1st one is broken - We don't want to redo any configuration but just want to replace that module and keep the same config.

To perform the above example, let's do the following steps in Maintenance mode:

Step 1

Check first the module ID's and write them down. In this stage, the old module can already be disconnected and the new module must be connected. Use the below instruction:

error list

Below you'll find the feedback you'll get with this instruction.

[openmotics]$ error list
i2c errors: 0/0 1:1
00 I 073.027.055.110 0 No Errors
01 I 073.229.202.148 0 No Errors
02 I 073.107.214.173 0 No Errors
03 I 073.026.052.105 0 No Errors
04 I 073.117.235.214 0 No Errors
05 I 073.083.166.076 0 No Errors
06 I 073.203.150.045 0 No Errors
00 D 068.190.125.251 0 No Errors
01 O 079.020.040.081 0 No Errors
02 O 079.245.235.214 0 No Errors
03 O 079.208.161.067 0 No Errors
Large Installation enabled
00 R 082.121.242.229 Roller/Shutter
01 R 082.084.169.082 Roller/Shutter
[openmotics]$  

Write down the ID numbers of each module in large installation. You can see that i've 2 Roller shutter modules in large installation mode and i want to change the first module. For the first module, I will write down 82 for ID0 (which will not change because this is the type of module), 121 for ID1, 242 for ID2 and 229 for ID3.

Step 2

In this step, we will add the new module. Please make sure that the Output module is in Roller/Shutter mode. Just press for 10 seconds on the init button and only 4 output leds should flicker, if all 8 are flickering, press 10 seconds again when the flickering was done, you should only see 4 leds flickering.

module discover start

Now you can press the init button on the new module and you'll see the message appear that a new module has been added. You will now have 3 modules in Large installation mode. You can verify this with:

error list

Write down the ID's of the 3rd module. We'll take in our example for the 3rd module following ID's: 082.023.046.093

Step 3

We will now remove the 3rd module from the master, this is done in the following way:

eeprom read 0 3             ; Read the number of Roller/Shutter modules from the eeprom, in our example the result will be 3
eeprom write 0 3 2          ; Set the number of Roller/Shutter modules in Large installation mode on 2

Step 4

Put the ID of module 3 on the place of module 1. The detail of the eeprom positions can be found in the Large Installation page.

eeprom write 33 173 82      ; Write ID0 for module 0 (33 is for the first module, 34 for the second etc)
eeprom write 33 174 23      ; Write ID1 for module 0 (33 is for the first module, 34 for the second etc)
eeprom write 33 175 46      ; Write ID2 for module 0 (33 is for the first module, 34 for the second etc)
eeprom write 33 176 93      ; Write ID3 for module 0 (33 is for the first module, 34 for the second etc) 

Step 5

Activate the changes you've made:

eeprom activate