/** @file ConnectionSTREAMing.cpp @author Lime Microsystems @brief Implementation of STREAM board connection (streaming API) */ #include "ConnectionSTREAM.h" #include "fifo.h" #include #include #include #include #include #include #include #include #include "ErrorReporting.h" #include "Logger.h" using namespace lime; using namespace std; /** @brief Configures FPGA PLLs to LimeLight interface frequency */ int ConnectionSTREAM::UpdateExternalDataRate(const size_t channel, const double txRate_Hz, const double rxRate_Hz, const double txPhase, const double rxPhase) { lime::fpga::FPGA_PLL_clock clocks[2]; if (channel == 2) { clocks[0].index = 0; clocks[0].outFrequency = rxRate_Hz; clocks[1].index = 1; clocks[1].outFrequency = txRate_Hz; return lime::fpga::SetPllFrequency(this, 4, 30.72e6, clocks, 2); } const float txInterfaceClk = 2 * txRate_Hz; const float rxInterfaceClk = 2 * rxRate_Hz; mExpectedSampleRate = rxRate_Hz; const int pll_ind = (channel == 1) ? 2 : 0; clocks[0].index = 0; clocks[0].outFrequency = rxInterfaceClk; clocks[1].index = 1; clocks[1].outFrequency = rxInterfaceClk; clocks[1].phaseShift_deg = rxPhase; if (lime::fpga::SetPllFrequency(this, pll_ind+1, rxInterfaceClk, clocks, 2)!=0) return -1; clocks[0].index = 0; clocks[0].outFrequency = txInterfaceClk; clocks[1].index = 1; clocks[1].outFrequency = txInterfaceClk; clocks[1].phaseShift_deg = txPhase; if (lime::fpga::SetPllFrequency(this, pll_ind, txInterfaceClk, clocks, 2)!=0) return -1; return 0; } /** @brief Configures FPGA PLLs to LimeLight interface frequency */ int ConnectionSTREAM::UpdateExternalDataRate(const size_t channel, const double txRate_Hz, const double rxRate_Hz) { const float txInterfaceClk = 2 * txRate_Hz; const float rxInterfaceClk = 2 * rxRate_Hz; const int pll_ind = (channel == 1) ? 2 : 0; int status = 0; uint32_t reg20; const double rxPhC1[] = { 91.08, 89.46 }; const double rxPhC2[] = { -1 / 6e6, 1.24e-6 }; const double txPhC1[] = { 89.75, 89.61 }; const double txPhC2[] = { -3.0e-7, 2.71e-7 }; const std::vector spiAddr = { 0x021, 0x022, 0x023, 0x024, 0x027, 0x02A, 0x400, 0x40C, 0x40B, 0x400, 0x40B, 0x400}; const int bakRegCnt = spiAddr.size() - 4; auto info = GetDeviceInfo(); bool phaseSearch = false; if (!(mStreamers.size() > channel && (mStreamers[channel]->rxRunning || mStreamers[channel]->txRunning))) if (this->chipVersion == 0x3841 && stoi(info.gatewareRevision) >= 7 && stoi(info.gatewareVersion) >= 2) //0x3840 LMS7002Mr2, 0x3841 LMS7002Mr3 if(rxInterfaceClk >= 5e6 || txInterfaceClk >= 5e6) phaseSearch = true; mExpectedSampleRate = rxRate_Hz; std::vector dataWr; std::vector dataRd; if (phaseSearch) { dataWr.resize(spiAddr.size()); dataRd.resize(spiAddr.size()); //backup registers dataWr[0] = (uint32_t(0x0020) << 16); ReadLMS7002MSPI(dataWr.data(), ®20, 1, channel); dataWr[0] = (1 << 31) | (uint32_t(0x0020) << 16) | 0xFFFD; //msbit 1=SPI write WriteLMS7002MSPI(dataWr.data(), 1, channel); for (int i = 0; i < bakRegCnt; ++i) dataWr[i] = (spiAddr[i] << 16); ReadLMS7002MSPI(dataWr.data(),dataRd.data(), bakRegCnt, channel); } if(rxInterfaceClk >= 5e6) { if (phaseSearch) { const std::vector spiData = { 0x0E9F, 0x07FF, 0x5550, 0xE4E4, 0xE4E4, 0x0086, 0x028D, 0x00FF, 0x5555, 0x02CD, 0xAAAA, 0x02ED}; //Load test config const int setRegCnt = spiData.size(); for (int i = 0; i < setRegCnt; ++i) dataWr[i] = (1 << 31) | (uint32_t(spiAddr[i]) << 16) | spiData[i]; //msbit 1=SPI write WriteLMS7002MSPI(dataWr.data(), setRegCnt, channel); } lime::fpga::FPGA_PLL_clock clocks[2]; clocks[0].index = 0; clocks[0].outFrequency = rxInterfaceClk; clocks[1].index = 1; clocks[1].outFrequency = rxInterfaceClk; if (this->chipVersion == 0x3841) clocks[1].phaseShift_deg = rxPhC1[1] + rxPhC2[1] * rxInterfaceClk; else clocks[1].phaseShift_deg = rxPhC1[0] + rxPhC2[0] * rxInterfaceClk; if (phaseSearch) clocks[1].findPhase = true; status = lime::fpga::SetPllFrequency(this, pll_ind+1, rxInterfaceClk, clocks, 2); } else status = lime::fpga::SetDirectClocking(this, pll_ind+1, rxInterfaceClk, 90); if(txInterfaceClk >= 5e6) { if (phaseSearch) { const std::vector spiData = {0x0E9F, 0x07FF, 0x5550, 0xE4E4, 0xE4E4, 0x0484}; WriteRegister(0x000A, 0x0000); //Load test config const int setRegCnt = spiData.size(); for (int i = 0; i < setRegCnt; ++i) dataWr[i] = (1 << 31) | (uint32_t(spiAddr[i]) << 16) | spiData[i]; //msbit 1=SPI write WriteLMS7002MSPI(dataWr.data(), setRegCnt, channel); } lime::fpga::FPGA_PLL_clock clocks[2]; clocks[0].index = 0; clocks[0].outFrequency = txInterfaceClk; clocks[0].phaseShift_deg = 0; clocks[1].index = 1; clocks[1].outFrequency = txInterfaceClk; if (this->chipVersion == 0x3841) clocks[1].phaseShift_deg = txPhC1[1] + txPhC2[1] * txInterfaceClk; else clocks[1].phaseShift_deg = txPhC1[0] + txPhC2[0] * txInterfaceClk; if (phaseSearch) { clocks[1].findPhase = true; WriteRegister(0x000A, 0x0200); } status = lime::fpga::SetPllFrequency(this, pll_ind, txInterfaceClk, clocks, 2); } else status = lime::fpga::SetDirectClocking(this, pll_ind, txInterfaceClk, 90); if (phaseSearch) { //Restore registers for (int i = 0; i < bakRegCnt; ++i) dataWr[i] = (1 << 31) | (uint32_t(spiAddr[i]) << 16) | dataRd[i]; //msbit 1=SPI write WriteLMS7002MSPI(dataWr.data(), bakRegCnt, channel); dataWr[0] = (1 << 31) | (uint32_t(0x0020) << 16) | reg20; //msbit 1=SPI write WriteLMS7002MSPI(dataWr.data(), 1, channel); WriteRegister(0x000A, 0); } return status; } int ConnectionSTREAM::ResetStreamBuffers() { //USB FIFO reset LMS64CProtocol::GenericPacket ctrPkt; ctrPkt.cmd = CMD_USB_FIFO_RST; ctrPkt.outBuffer.push_back(0x00); return TransferPacket(ctrPkt); } int ConnectionSTREAM::ReadRawStreamData(char* buffer, unsigned length, int epIndex, int timeout_ms) { const unsigned char ep = 0x81; fpga::StopStreaming(this, epIndex); ResetStreamBuffers(); WriteRegister(0x0008, 0x0100 | 0x2); WriteRegister(0x0007, 1); fpga::StartStreaming(this, epIndex); int totalBytesReceived = ReceiveData(buffer,length, epIndex, timeout_ms); fpga::StopStreaming(this, epIndex); AbortReading(ep); return totalBytesReceived; } /** @brief Function dedicated for receiving data samples from board @param stream a pointer to an active receiver stream */ void ConnectionSTREAM::ReceivePacketsLoop(Streamer* stream) { //at this point FPGA has to be already configured to output samples const uint8_t chCount = stream->mRxStreams.size(); const auto link = stream->mRxStreams[0]->config.linkFormat; const uint32_t samplesInPacket = (link == StreamConfig::STREAM_12_BIT_COMPRESSED ? 1360 : 1020)/chCount; const unsigned char ep = 0x81; const int chipID = stream->mChipID; float latency=0; for (int i = 0; i < chCount; i++) latency += stream->mRxStreams[i]->config.performanceLatency/chCount; const unsigned tmp_cnt = (latency * 6)+0.5; const uint8_t packetsToBatch = (1< handles(buffersCount, 0); vectorbuffers(buffersCount*bufferSize, 0); vector chFrames; try { chFrames.resize(chCount); } catch (const std::bad_alloc &ex) { ReportError("Error allocating Rx buffers, not enough memory"); return; } int activeTransfers = 0; for (int i = 0; iBeginDataReading(&buffers[i*bufferSize], bufferSize, ep); ++activeTransfers; } int bi = 0; unsigned long totalBytesReceived = 0; //for data rate calculation auto t1 = chrono::high_resolution_clock::now(); auto t2 = t1; std::mutex txFlagsLock; condition_variable resetTxFlags; //worker thread for reseting late Tx packet flags std::thread txReset([](ILimeSDRStreaming* port, atomic *terminate, mutex *spiLock, condition_variable *doWork) { uint32_t reg9; port->ReadRegister(0x0009, reg9); const uint32_t addr[] = {0x0009, 0x0009}; const uint32_t data[] = {reg9 | (5 << 1), reg9 & ~(5 << 1)}; while (not terminate->load()) { std::unique_lock lck(*spiLock); doWork->wait(lck); port->WriteRegisters(addr, data, 2); } }, this, &stream->terminateRx, &txFlagsLock, &resetTxFlags); int resetFlagsDelay = 128; uint64_t prevTs = 0; while (stream->terminateRx.load() == false) { if(stream->generateData.load()) { if(activeTransfers == 0) //stop FPGA when last transfer completes fpga::StopStreaming(this, chipID); stream->safeToConfigInterface.notify_all(); //notify that it's safe to change chip config const int batchSize = (this->mExpectedSampleRate/chFrames[0].samplesCount)/10; IStreamChannel::Metadata meta; for(int i=0; imRxStreams[ch]->Write((const void*)chFrames[ch].samples, chFrames[ch].samplesCount, &meta); if(samplesPushed != chFrames[ch].samplesCount) lime::warning("Rx samples pushed %i/%i", samplesPushed, chFrames[ch].samplesCount); } } this_thread::sleep_for(chrono::milliseconds(100)); } int32_t bytesReceived = 0; if(handles[bi] >= 0) { if (this->WaitForReading(handles[bi], 1000) == true) bytesReceived = this->FinishDataReading(&buffers[bi*bufferSize], bufferSize, handles[bi]); --activeTransfers; totalBytesReceived += bytesReceived; if (bytesReceived != int32_t(bufferSize)) //data should come in full sized packets for(auto value: stream->mRxStreams) value->underflow++; } bool txLate=false; for (uint8_t pktIndex = 0; pktIndex < bytesReceived / sizeof(FPGA_DataPacket); ++pktIndex) { const FPGA_DataPacket* pkt = (FPGA_DataPacket*)&buffers[bi*bufferSize]; const uint8_t byte0 = pkt[pktIndex].reserved[0]; if ((byte0 & (1 << 3)) != 0 && !txLate) //report only once per batch { txLate = true; if(resetFlagsDelay > 0) --resetFlagsDelay; else { lime::info("L %llu", (unsigned long long)pkt[pktIndex].counter); resetTxFlags.notify_one(); resetFlagsDelay = packetsToBatch*buffersCount; stream->txLastLateTime.store(pkt[pktIndex].counter); for(auto value: stream->mTxStreams) value->pktLost++; } } uint8_t* pktStart = (uint8_t*)pkt[pktIndex].data; if(pkt[pktIndex].counter - prevTs != samplesInPacket && pkt[pktIndex].counter != prevTs) { int packetLoss = ((pkt[pktIndex].counter - prevTs)/samplesInPacket)-1; #ifndef NDEBUG printf("\tRx pktLoss: ts diff: %li pktLoss: %i\n", pkt[pktIndex].counter - prevTs, packetLoss); #endif for(auto value: stream->mRxStreams) value->pktLost += packetLoss; } prevTs = pkt[pktIndex].counter; stream->rxLastTimestamp.store(prevTs); //parse samples vector dest(chCount); for(uint8_t c=0; cmRxStreams[ch]->Write((const void*)chFrames[ch].samples, samplesCount, &meta, 100); if(samplesPushed != samplesCount) stream->mRxStreams[ch]->overflow++; } } // Re-submit this request to keep the queue full if(not stream->generateData.load()) { if(activeTransfers == 0) //reactivate FPGA and USB transfers fpga::StartStreaming(this, chipID); for(int i=0; iBeginDataReading(&buffers[bi*bufferSize], bufferSize, ep); bi = (bi + 1) & (buffersCount-1); ++activeTransfers; } } else { handles[bi] = -1; bi = (bi + 1) & (buffersCount-1); } t2 = chrono::high_resolution_clock::now(); auto timePeriod = std::chrono::duration_cast(t2 - t1).count(); if (timePeriod >= 1000) { t1 = t2; //total number of bytes sent per second double dataRate = 1000.0*totalBytesReceived / timePeriod; #ifndef NDEBUG printf("Rx: %.3f MB/s\n", dataRate / 1000000.0); #endif totalBytesReceived = 0; stream->rxDataRate_Bps.store((uint32_t)dataRate); } } AbortReading(ep); for (int j = 0; j= 0) { this->WaitForReading(handles[bi], 1000); this->FinishDataReading(&buffers[bi*bufferSize], bufferSize, handles[bi]); } bi = (bi + 1) & (buffersCount-1); } resetTxFlags.notify_one(); txReset.join(); stream->rxDataRate_Bps.store(0); } /** @brief Functions dedicated for transmitting packets to board @param stream an active transmit stream */ void ConnectionSTREAM::TransmitPacketsLoop(Streamer* stream) { //at this point FPGA has to be already configured to output samples const uint8_t maxChannelCount = 2; const uint8_t chCount = stream->mTxStreams.size(); const auto link = stream->mTxStreams[0]->config.linkFormat; const unsigned char ep = 0x01; double latency=0; for (int i = 0; i < chCount; i++) latency += stream->mTxStreams[i]->config.performanceLatency/chCount; const unsigned tmp_cnt = (latency * 6)+0.5; const uint8_t buffersCount = 16; // must be power of 2 const uint8_t packetsToBatch = (1< handles(buffersCount, 0); vector bufferUsed(buffersCount, 0); vector samples[maxChannelCount]; vector buffers; try { for(int i=0; iterminateTx.load() != true) { if (bufferUsed[bi]) { unsigned bytesSent = 0; if (this->WaitForSending(handles[bi], 1000) == true) { bytesSent = this->FinishDataSending(&buffers[bi*bufferSize], bufferSize, handles[bi]); } if (bytesSent != bufferSize) { for (auto value : stream->mTxStreams) { value->overflow++; } } else { totalBytesSent += bytesSent; } bufferUsed[bi] = false; } int i=0; while(iterminateTx.load() != true) { IStreamChannel::Metadata meta; FPGA_DataPacket* pkt = reinterpret_cast(&buffers[bi*bufferSize]); bool badSamples = false; for(int ch=0; chmTxStreams[ch]->Read(samples[ch].data(), maxSamplesBatch, &meta, popTimeout_ms); if (samplesPopped != maxSamplesBatch) { badSamples = true; stream->mTxStreams[ch]->underflow++; stream->txDataRate_Bps.store(0); #ifndef NDEBUG printf("popping from TX, samples popped %i/%i\n", samplesPopped, maxSamplesBatch); #endif break; } } if (badSamples) continue; if(stream->terminateTx.load() == true) //early termination break; pkt[i].counter = meta.timestamp; pkt[i].reserved[0] = 0; //by default ignore timestamps const int ignoreTimestamp = !(meta.flags & IStreamChannel::Metadata::SYNC_TIMESTAMP); pkt[i].reserved[0] |= ((int)ignoreTimestamp << 4); //ignore timestamp vector src(chCount); for(uint8_t c=0; cBeginDataSending(&buffers[bi*bufferSize], bufferSize, ep); bufferUsed[bi] = true; t2 = chrono::high_resolution_clock::now(); auto timePeriod = std::chrono::duration_cast(t2 - t1).count(); if (timePeriod >= 1000) { //total number of bytes sent per second float dataRate = 1000.0*totalBytesSent / timePeriod; stream->txDataRate_Bps.store(dataRate); totalBytesSent = 0; t1 = t2; #ifndef NDEBUG printf("Tx: %.3f MB/s\n", dataRate / 1000000.0); #endif } bi = (bi + 1) & (buffersCount-1); } // Wait for all the queued requests to be cancelled AbortSending(ep); for (int j = 0; jWaitForSending(handles[bi], 1000); this->FinishDataSending(&buffers[bi*bufferSize], bufferSize, handles[bi]); } bi = (bi + 1) & (buffersCount-1); } stream->txDataRate_Bps.store(0); }