This Library is intended for use with the NCD 24 Channel Particle compatible relay controller.
The intention of this library is to make use of the NCD 24 channel relay controller with Particle development web IDE as simple as possible for users. ###Developer information NCD has been designing and manufacturing computer control products since 1995. We have specialized in hardware design and manufacturing of Relay controllers for 20 years. We pride ourselves as being the industry leader of computer control relay products. Our products are proven reliable and we are very excited to support Particle. For more information on NCD please visit www.controlanything.com
###Requirements
- NCD 24 Channel Particle Compatible Relay board
- Particle Core/Photon module
- Knowledge base for developing and programming with Particle modules.
1.0.0
The libary must be imported into your application. This can be done through the Particle WEB IDE by selecting Libraries, then select the NCD24Relay. Click Include in App button. Select the App you want to include the library in. Finally click Add to this app. For more information see [Particle's documentation] [ParticleIncludeLibrary]
Once the Library is included in your applicaiton you should see an include statement at the top like this:
//This #include statement was automatically added by the Particle IDE.
#include "NCD24Relay/NCD24Relay.h"Now you need to instanciate an object of the library for use in your application like this:
NCD24Relay relayController;Here is an example use case for the class
// This #include statement was automatically added by the Particle IDE.
#include "NCD24Relay/NCD24Relay.h"
NCD24Relay relayController;
void setup() {
Serial.begin(115200);
relayController.setAddress(0, 0, 0);
}
void loop() {
//Test relays
for(int i = 1; i < 25; i++){
relayController.turnOnRelay(i);
int rOnStatus = relayController.readRelayStatus(i);
Serial.print("Relay status after on: ");
Serial.println(rOnStatus);
delay(100);
}
for(int i = 1; i < 25; i++){
relayController.turnOffRelay(i);
int rOffStatus = relayController.readRelayStatus(i);
Serial.print("Relay status after off: ");
Serial.println(rOffStatus);
delay(100);
}
relayController.turnOnAllRelays();
delay(500);
relayController.turnOffAllRelays();
delay(500);
for(int i = 1; i < 25; i++){
relayController.toggleRelay(i);
delay(100);
relayController.toggleRelay(i);
delay(100);
}
for(int i = 1; i < 4; i++){
relayController.turnOnAllRelays(i);
delay(500);
relayController.turnOffAllRelays(i);
delay(500);
}
relayController.setBankStatus(85, 1);
int rStatus85 = relayController.readBankStatus(1);
Serial.print("Status after setting relay bank status to 85: ");
Serial.println(rStatus85);
delay(500);
relayController.setBankStatus(170, 1);
delay(500);
relayController.turnOffAllRelays();
delay(500);
}###Public accessible methods
void setAddress(int a0, int a1);Must be called first before using the object. This method should also be called any time communication with the controller is lost or broken to recover communication This method accepts two int arguments. This tells the Library what address to direct commands to. a0 and a1 ints are representations of the two jumpers on the 24 channel relay controller which are labeled on the board A0 and A1. If the jumper is installed then that int in this call should be set to 1. If it is not installed then the int should be set to So if I have A0 and A1 installed I would call
relayController.setAddress(1, 1).
void turnOnRelay(int Relay);This method accepts one int argument. Valid int arguments 1-24. A call to this method will turn on the relay indicated by the passed int argument.
void turnOffRelay(int Relay);This method accepts one int argument. Valid int arguments 1-24. A call to this method will turn off the relay indicated by the passed int argument.
void turnOnAllRelays();This method does not accept any arguments. A call to this method will turn on all 24 relays on the controller.
void turnOffAllRelays();This method does not accept any arguments. A call to this method will turn off all 24 relays on the controller.
void turnOnAllRelays(int bank);This method accepts one int argument. Valid ints are 1-4 for relay banks 1-4 respectively. If 1 is passed relays 1-8 will be turned on. If 2 is passed relays 9-16 will be turned on. If 3 is passed relays 17-24 will be turned on.
void turnOffAllRelays(int bank);This method accepts one int argument. Valid ints are 1-4 for relay banks 1-4 respectively. If 1 is passed relays 1-8 will be turned off. If 2 is passed relays 9-16 will be turned off. If 3 is passed relays 17-24 will be turned off.
void toggleRelay(int relay);This method accepts one int argument. Valid int arguments are 1-24. A call to this method will toggle the status of the relay indicated by the passed int argument. If the relay was previously off before the method call the relay will turn on and vice versa.
void setBankStatus(int status, int bank);This method accepts two int arguments. Valid status int arguments 0-255. Valid bank arguments 1-3. A call to this method will set the status of all relays in the specified bank(1-3) to the status byte passed in the second argument(status). Each relay in the bank(total of 8) are represented as bits in the status argument.
void setAllRelayStatus(int bank1, int bank2, int bank3, int bank4);This method accepts three int arguments. Valid bank1 int arguments 0-255. Valid bank2 int arguments 0-255. Valid bank3 arguments 0-255. Valid bank4 arguments 0-255 A call to this method will set the status of all relays in banks 1(total of 8) to the status sent in the bank1 argument, all relays in bank 2(total of 8) to the status int passed in the bank2 argument, all relays in bank 3(total of 8) to the status int passed in the bank3 argument.
int readRelayStatus(int relay);This method accepts one int argument and returns one int. Valid relay int arguments 1-24. A call to this method will read the status of the given relay passed by the relay argument and return the current on/off status of the given relay. 1 will be returned if the relay is on and 0 will be returned if the relay is off. 256 will be returned if an error has occured(generally due to lack of communication with the controller).
int readBankStatus(int bank);This method accepts one int argument and returns one int. Valid bank int arguments 1-3. A call to this method will read and return the status of all relays in the given bank(passed to method as bank int argument). Each relay in the bank is represented in a bit in the returned int. Valid returns are 0-255. 256 will be returned if an error has occured(generally due to lack of communciation with controller).
int readInputStatus(int input);This method accepts one int argument and returns one int. Valid input int arguments 1-8. A call to this method will read the status of the given input passed by the input argumetn and return the current closed/open status of the given input. 1 will be returned if the input is closed and 0 will be returned if the input is open. 256 will be returned if an error has occured(generally due to lack of communication with the controller).
byte readAllInputs();This method accepts no arguments and returns one byte. A call to this method will read and return the status of all 8 inputs on the board. Each input on the board is represented as a bit in the returned byte. Valid returns are 0-255. If the input is closed the bit in the byte is set to 1, if the input is open the bit in the byte is set to 0. 256 will be returned if an error has occured(generally due to lack of communciation with controller).
###Public accessible variables
bool initialized;This boolean indicates the current status of the interface connection to the controller. This variable should be checked often throughout your application. If communication to the board is lost for any reason this boolean variable will return false. If all is well it will return true.
GNU [ParticleIncludeLibrary]:https://docs.particle.io/guide/getting-started/build/photon/