// Copyright (c) FIRST and other WPILib contributors. // Open Source Software; you can modify and/or share it under the terms of // the WPILib BSD license file in the root directory of this project. #include "hal/Relay.h" #include #include "DigitalInternal.h" #include "HALInitializer.h" #include "HALInternal.h" #include "PortsInternal.h" #include "hal/handles/IndexedHandleResource.h" using namespace hal; namespace { struct Relay { uint8_t channel; bool fwd; std::string previousAllocation; }; } // namespace static IndexedHandleResource* relayHandles; // Create a mutex to protect changes to the relay values static wpi::mutex digitalRelayMutex; namespace hal::init { void InitializeRelay() { static IndexedHandleResource rH; relayHandles = &rH; } } // namespace hal::init extern "C" { HAL_RelayHandle HAL_InitializeRelayPort(HAL_PortHandle portHandle, HAL_Bool fwd, const char* allocationLocation, int32_t* status) { hal::init::CheckInit(); initializeDigital(status); if (*status != 0) { return HAL_kInvalidHandle; } int16_t channel = getPortHandleChannel(portHandle); if (channel == InvalidHandleIndex || channel >= kNumRelayChannels) { *status = RESOURCE_OUT_OF_RANGE; hal::SetLastErrorIndexOutOfRange(status, "Invalid Index for Relay", 0, kNumRelayChannels, channel); return HAL_kInvalidHandle; } if (!fwd) { channel += kNumRelayHeaders; // add 4 to reverse channels } HAL_RelayHandle handle; auto port = relayHandles->Allocate(channel, &handle, status); if (*status != 0) { if (port) { hal::SetLastErrorPreviouslyAllocated(status, "Relay", channel, port->previousAllocation); } else { hal::SetLastErrorIndexOutOfRange(status, "Invalid Index for Relay", 0, kNumRelayChannels, channel); } return HAL_kInvalidHandle; // failed to allocate. Pass error back. } if (!fwd) { // Subtract number of headers to put channel in range channel -= kNumRelayHeaders; port->fwd = false; // set to reverse } else { port->fwd = true; // set to forward } port->channel = static_cast(channel); port->previousAllocation = allocationLocation ? allocationLocation : ""; return handle; } void HAL_FreeRelayPort(HAL_RelayHandle relayPortHandle) { // no status, so no need to check for a proper free. relayHandles->Free(relayPortHandle); } HAL_Bool HAL_CheckRelayChannel(int32_t channel) { // roboRIO only has 4 headers, and the FPGA has // separate functions for forward and reverse, // instead of separate channel IDs return channel < kNumRelayHeaders && channel >= 0; } void HAL_SetRelay(HAL_RelayHandle relayPortHandle, HAL_Bool on, int32_t* status) { auto port = relayHandles->Get(relayPortHandle); if (port == nullptr) { *status = HAL_HANDLE_ERROR; return; } std::scoped_lock lock(digitalRelayMutex); uint8_t relays = 0; if (port->fwd) { relays = relaySystem->readValue_Forward(status); } else { relays = relaySystem->readValue_Reverse(status); } if (*status != 0) { return; // bad status read } if (on) { relays |= 1 << port->channel; } else { relays &= ~(1 << port->channel); } if (port->fwd) { relaySystem->writeValue_Forward(relays, status); } else { relaySystem->writeValue_Reverse(relays, status); } } HAL_Bool HAL_GetRelay(HAL_RelayHandle relayPortHandle, int32_t* status) { auto port = relayHandles->Get(relayPortHandle); if (port == nullptr) { *status = HAL_HANDLE_ERROR; return false; } uint8_t relays = 0; if (port->fwd) { relays = relaySystem->readValue_Forward(status); } else { relays = relaySystem->readValue_Reverse(status); } return (relays & (1 << port->channel)) != 0; } } // extern "C"