> For the complete documentation index, see [llms.txt](https://docs.tricloudnexus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tricloudnexus.io/edge/nexus-modules/data-connector-modules/scenecontrollermodule/direct-commands/setlightingcontrollerip.md).

# SetLightingControllerIp

Calling this method commands the lighting controller to use a new IP address.

There are 2 ways to set the new IP address, depending on wether the current address is known or not:

* Set the new IP address using the existing IP address
* Reset the lighting controller to revert to a known IP address, to use that for setting a new IP

After running this command, the communication to the lighting controller will stop working, since the IP address and port has changed. The communication is restored when the new IP address has been configured in the module twin (either by deployment, or by changing the IP address manually).

### **Method Name:**

SetLightingControllerIp

### **Payload:**

The direct command takes the following properties:

* **newIpAddress**: New IP address to set (required)
* **useDefaultSettings**: Optional, and defaults to false. If this is true, the communication to the lighting controller will be done using the existing TCP connection, with the currently configured IP address and port. Otherwise, it is assumed that the lighting controller was reset, and that the default IP and port is used for communication.

#### **Reset of lighting controller (unknown current IP address)**

Factory default of the lighting controller sets the IP address is *192.168.0.2* on default port *40001*. While this is not always convenient, the IP address and port can be changed, using the following procedure:

1. Reset the PD3 controller, by pressing reset button, using something pointy (toothpick, etc.)
2. Recycle power on the PD3 controller by disconnecting it from the power supply for 5 seconds
3. Call direct command **SetLightingControllerIp** on SceneControllerModule with the following payload, where expected response is "ok":

```
   { 
        "newIpAddress": "xxx.xxx.xxx.xxx"
   }
```

4. Configure the LightingController in the Twin configuration (either manually or by deployment) to configure the new IP address.
5. Recycle power on the PD3 controller by disconnecting it from the power supply for 5 seconds
6. Test new IP calling direct command **CallLightingController** on SceneControllerModule with the following payload, where expected response starts with "@00O":

```
   { 
       "command": "@00M"
   }
```

#### **Changing already known IP address**

To set a new IP address of a lighting controller, where the current IP address is already known, do the following:

1. Call direct command **SetLightingControllerIp** on SceneControllerModule with the following payload, where expected response is "ok":

```
   { 
        "newIpAddress": "xxx.xxx.xxx.xxx",
        "useDefaultSettings": true
   }
```

2. Recycle power on the PD3 controller by disconnecting it from the power supply for 5 seconds
3. Reconfigure the LightingController in the Twin configuration (either manually or by deployment) to configure the new IP address.
4. Test new IP calling direct command **CallLightingController** on SceneControllerModule with the following payload, where expected response starts with "@00O":

```
   { 
       "command": "@00M"
   }
```