/* * © 2020, Chris Harlow. All rights reserved. * * This file is part of Asbelos DCC API * * This is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * It is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with CommandStation. If not, see . */ /********************************************************************** DCC++ BASE STATION supports optional OUTPUT control of any unused Arduino Pins for custom purposes. Pins can be activited or de-activated. The default is to set ACTIVE pins HIGH and INACTIVE pins LOW. However, this default behavior can be inverted for any pin in which case ACTIVE=LOW and INACTIVE=HIGH. Definitions and state (ACTIVE/INACTIVE) for pins are retained in EEPROM and restored on power-up. The default is to set each defined pin to active or inactive according to its restored state. However, the default behavior can be modified so that any pin can be forced to be either active or inactive upon power-up regardless of its previous state before power-down. To have this sketch utilize one or more Arduino pins as custom outputs, first define/edit/delete output definitions using the following variation of the "Z" command: : creates a new output ID, with specified PIN and IFLAG values. if output ID already exists, it is updated with specificed PIN and IFLAG. note: output state will be immediately set to ACTIVE/INACTIVE and pin will be set to HIGH/LOW according to IFLAG value specifcied (see below). returns: if successful and if unsuccessful (e.g. out of memory) : deletes definition of output ID returns: if successful and if unsuccessful (e.g. ID does not exist) : lists all defined output pins returns: for each defined output pin or if no output pins defined where ID: the numeric ID (0-32767) of the output PIN: the arduino pin number to use for the output STATE: the state of the output (0=INACTIVE / 1=ACTIVE) IFLAG: defines the operational behavior of the output based on bits 0, 1, and 2 as follows: IFLAG, bit 0: 0 = forward operation (ACTIVE=HIGH / INACTIVE=LOW) 1 = inverted operation (ACTIVE=LOW / INACTIVE=HIGH) IFLAG, bit 1: 0 = state of pin restored on power-up to either ACTIVE or INACTIVE depending on state before power-down; state of pin set to INACTIVE when first created 1 = state of pin set on power-up, or when first created, to either ACTIVE of INACTIVE depending on IFLAG, bit 2 IFLAG, bit 2: 0 = state of pin set to INACTIVE uponm power-up or when first created 1 = state of pin set to ACTIVE uponm power-up or when first created Once all outputs have been properly defined, use the command to store their definitions to EEPROM. If you later make edits/additions/deletions to the output definitions, you must invoke the command if you want those new definitions updated in the EEPROM. You can also clear everything stored in the EEPROM by invoking the command. To change the state of outputs that have been defined use: : sets output ID to either ACTIVE or INACTIVE state returns: , or if turnout ID does not exist where ID: the numeric ID (0-32767) of the turnout to control STATE: the state of the output (0=INACTIVE / 1=ACTIVE) When controlled as such, the Arduino updates and stores the direction of each output in EEPROM so that it is retained even without power. A list of the current states of each output in the form is generated by this sketch whenever the status command is invoked. This provides an efficient way of initializing the state of any outputs being monitored or controlled by a separate interface or GUI program. **********************************************************************/ #include "Outputs.h" #include "EEStore.h" #include "StringFormatter.h" #include "IODevice.h" /////////////////////////////////////////////////////////////////////////////// // Static function to print all output states to stream in the form "" void Output::printAll(Print *stream){ for (Output *tt = Output::firstOutput; tt != NULL; tt = tt->nextOutput) StringFormatter::send(stream, F("\n"), tt->data.id, tt->data.active); } // Output::printAll /////////////////////////////////////////////////////////////////////////////// // Object method to activate / deactivate the Output state. void Output::activate(uint16_t s){ s = (s>0); // Make 0 or 1 data.active = s; // if s>0, set status to active, else inactive // set state of output pin to HIGH or LOW depending on whether bit zero of iFlag is set to 0 (ACTIVE=HIGH) or 1 (ACTIVE=LOW) IODevice::write(data.pin, s ^ data.invert); // Update EEPROM if output has been stored. if(EEStore::eeStore->data.nOutputs > 0 && num > 0) EEPROM.put(num, data.flags); } /////////////////////////////////////////////////////////////////////////////// // Static function to locate Output object specified by ID 'n'. // Return NULL if not found. Output* Output::get(uint16_t n){ Output *tt; for(tt=firstOutput;tt!=NULL && tt->data.id!=n;tt=tt->nextOutput); return(tt); } /////////////////////////////////////////////////////////////////////////////// // Static function to delete Output object specified by ID 'n'. // Return false if not found. bool Output::remove(uint16_t n){ Output *tt,*pp=NULL; for(tt=firstOutput;tt!=NULL && tt->data.id!=n;pp=tt,tt=tt->nextOutput); if(tt==NULL) return false; if(tt==firstOutput) firstOutput=tt->nextOutput; else pp->nextOutput=tt->nextOutput; free(tt); return true; } /////////////////////////////////////////////////////////////////////////////// // Static function to load configuration and state of all Outputs from EEPROM void Output::load(){ struct OutputData data; Output *tt; for(uint16_t i=0;idata.nOutputs;i++){ EEPROM.get(EEStore::pointer(),data); // Create new object, set current state to default or to saved state from eeprom. tt=create(data.id, data.pin, data.flags, data.setDefault ? data.defaultValue : data.active); if (tt) tt->num=EEStore::pointer() + offsetof(OutputData, oStatus); // Save pointer to flags within EEPROM EEStore::advance(sizeof(tt->data)); } } /////////////////////////////////////////////////////////////////////////////// // Static function to store configuration and state of all Outputs to EEPROM void Output::store(){ Output *tt; tt=firstOutput; EEStore::eeStore->data.nOutputs=0; while(tt!=NULL){ EEPROM.put(EEStore::pointer(),tt->data); tt->num=EEStore::pointer() + offsetof(OutputData, oStatus); // Save pointer to flags within EEPROM EEStore::advance(sizeof(tt->data)); tt=tt->nextOutput; EEStore::eeStore->data.nOutputs++; } } /////////////////////////////////////////////////////////////////////////////// // Static function to create an Output object Output *Output::create(uint16_t id, VPIN pin, int iFlag, int v){ Output *tt; if (pin > VPIN_MAX) return NULL; if(firstOutput==NULL){ firstOutput=(Output *)calloc(1,sizeof(Output)); tt=firstOutput; } else if((tt=get(id))==NULL){ tt=firstOutput; while(tt->nextOutput!=NULL) tt=tt->nextOutput; tt->nextOutput=(Output *)calloc(1,sizeof(Output)); tt=tt->nextOutput; } if(tt==NULL) return tt; tt->num = 0; // make sure new object doesn't get written to EEPROM until store() command tt->data.id=id; tt->data.pin=pin; tt->data.flags=iFlag; if(v==1){ // sets status to 0 (INACTIVE) is bit 1 of iFlag=0, otherwise set to value of bit 2 of iFlag if (tt->data.setDefault) tt->data.active = tt->data.defaultValue; else tt->data.active = 0; } IODevice::write(tt->data.pin, tt->data.active ^ tt->data.invert); return(tt); } /////////////////////////////////////////////////////////////////////////////// Output *Output::firstOutput=NULL;