336c2915d45c06a79a0779b86c0305bbb12198b7
[processor-sdk/performance-audio-sr.git] / pasdk / test_dsp / framework / audioStreamOutIo.c
2 /*
3 Copyright (c) 2018, Texas Instruments Incorporated - http://www.ti.com/
4 All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 *
13 * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the
16 * distribution.
17 *
18 * Neither the name of Texas Instruments Incorporated nor the names of
19 * its contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 *
34 */
35 /*
36  *  ======== audioStreamOutIo.c ========
37  */
39 #include <string.h> // for memset
40 #include <xdc/runtime/Log.h>
41 #include <xdc/runtime/System.h>
42 #include <xdc/std.h>
44 #include "mcasp_cfg.h"
45 #include "ioConfig.h"    //TODO: remove this header
46 #include "ioBuff.h"
47 #include "ioPhy.h"
48 #include "ioData.h"
50 #include "pafsio_ialg.h"
51 #include "stdasp.h"
52 #include "asperr.h"
54 #include "audioStreamProc_common.h"
55 #include "audioStreamOutProc.h"
56 #include "audioStreamOutIo.h"
58 #define DEC_OUTNUMBUF_MAP(X) \
59       pP->poutNumBufMap[z]->map[(X) >= pP->poutNumBufMap[z]->length ? 0 : (X)]
61 #define STRIDE_WORST_CASE 32  // 4-byte (32-bit) word, 2 slots, 4 serializers
63 extern Ptr hMcaspTxChan;
64 extern Int d10Initialized;
67 // -----------------------------------------------------------------------------
68 // ASOT Decoding Function Helper - SIO Driver Change
69 //
70 //   Name:      PAF_ASOT_setCheckRateX
71 //   Purpose:   Decoding Function for reinitiating output.
72 //   From:      AST Parameter Function -> decodeInfo1
73 //              AST Parameter Function -> decodeInfo2
74 //   Uses:      See code.
75 //   States:    x
76 //   Return:    Error number in standard form (0 on success).
77 //   Trace:     None.
78 //
80 /* 0: set, 1: check, unused for now. --Kurt */
81 Int asopSetCheckRateX(
82     const PAF_ASOT_Params *pP, 
83     const PAF_ASOT_Patchs *pQ, 
84     PAF_ASOT_Config *pAsotCfg, 
85     Int check
86 )
87 {
88     PAF_AST_Config *pAstCfg;
89     PAF_AST_IoOut  *pOut;
90     float rateX;
91     PAF_SampleRateHz rateO /* std */, rateI /* inv */;
92     Int z;                              /* output counter */
93     Int zx;                             /* output re-counter */
94     Int getVal;
95     int inputRate, inputCount, outputRate, outputCount;
96     Int zMD;
97     Int zMI;
98     Int zMS;
99     Int zE, zX;
101     pAstCfg = pAsotCfg->pAstCfg; // get pointer to AST common (shared) configuration
102     pOut = pAsotCfg->pIoOut; // get pointer to ASOT IO configuration
103     
104     zMD = pAstCfg->masterDec;
105     zMS = pAstCfg->masterStr;
106     zMI = pP->zone.master;
108     inputRate = pAstCfg->xInp[zMI].inpBufStatus.sampleRateStatus;
109     inputCount = pAstCfg->xDec[zMD].decodeStatus.frameLength;
110     rateI = pAstCfg->xStr[zMS].pAudioFrame->fxns->sampleRateHz(pAstCfg->xStr[zMS].pAudioFrame, 
111         inputRate, PAF_SAMPLERATEHZ_INV);
113     for (z=OUTPUT1; z < OUTPUTN; z++) 
114     {
115         if (pOut[z].hIoPhy && (pAstCfg->xOut[z].outBufStatus.clock & 0x01)) 
116         {
117             // determine associated encoder
118             zE = z;
119             for (zX = ENCODE1; zX < ENCODEN; zX++) 
120             {
121                 if (pP->outputsFromEncodes[zX] == z) 
122                 {
123                     zE = zX;
124                     break;
125                 }
126             }
128             outputRate = pAstCfg->xEnc[zE].encodeStatus.sampleRate;
129             outputCount = pAstCfg->xEnc[zE].encodeStatus.frameLength;
130             rateO = pAstCfg->xStr[zMS].pAudioFrame->fxns->sampleRateHz(pAstCfg->xStr[zMS].pAudioFrame, 
131                 outputRate, PAF_SAMPLERATEHZ_STD);
132             if ((rateI > 0) && (rateO > 0))
133             {
134                 rateX = rateO /* std */ * rateI /* inv */;
135             }
136             else if (inputCount != 0)
137             {
138                 rateX = (float)outputCount / inputCount;
139             }
140             else
141             {
142                 return ASPERR_INFO_RATERATIO;
143             }
145 #if 0 // FL, New IO: add similar thing to be figured out     
146             getVal = SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_SET_RATEX, (Arg)&rateX);
147             if (getVal == DOBERR_RATECHANGE) 
148             {
149                 for (zx=OUTPUT1; zx < OUTPUTN; zx++)
150                 {
151                     if (pAstCfg->xOut[zx].hTxSio)
152                     {
153                         SIO_idle(pAstCfg->xOut[zx].hTxSio);
154                     }
155                 }
157                 // this forces an exit from the calling state machine which will
158                 // eventually call startOutput which calls setCheckRateX for all outputs
159                 // and so it is ok, in the presence of a rate change on any output, to
160                 // exit this loop /function early.
161                 return ASPERR_INFO_RATECHANGE;
162             }
163             else if (getVal != SYS_OK)
164             {
165                 return ((getVal & 0xff) | ASPERR_RATE_CHECK);
166             }
167 #endif // FL, New IO
168         }
169     }
171     return 0;
172 } //asopSetCheckRateX
174 // -----------------------------------------------------------------------------
175 // ASOT Decoding Function Helper - SIO Driver Start
176 //
177 //   Name:      PAF_ASOT_startOutput
178 //   Purpose:   Decoding Function for initiating output.
179 //   From:      AST Parameter Function -> decodeInfo1
180 //   Uses:      See code.
181 //   States:    x
182 //   Return:    Error number in standard or SIO form (0 on success).
183 //   Trace:     Message Log "trace" in Debug Project Configuration reports:
184 //              * State information as per parent.
185 //              * SIO control errors.
186 //
187 Int asopStartOutput(
188     const PAF_ASOT_Params *pP,
189     const PAF_ASOT_Patchs *pQ,
190     PAF_ASOT_Config *pAsotCfg
193     PAF_AST_Config *pAstCfg;
194     PAF_AST_IoOut  *pOut;
195     Int as;                     /* Audio Stream Number (1, 2, etc.) */
196     Int z;                      /* output counter */
197     Int nbufs;
198     Int zE, zS, zX;
199     Int zMD;
200     PAF_SIO_IALG_Obj    *pObj;
201     PAF_SIO_IALG_Config *pAlgConfig;
204     pAstCfg = pAsotCfg->pAstCfg; // get pointer to common (shared) configuration
205     pOut = pAsotCfg->pIoOut; // get pointer to ASOT IO configuration
206     as = pAstCfg->as;
207     zMD = pAstCfg->masterDec;
209     for (z=OUTPUT1; z < OUTPUTN; z++)
210     {
211         if (pOut[z].hIoPhy)
212         {
213             // determine associated encoder and stream
214             zE = z;
215             zS = z;
216             for (zX = ENCODE1; zX < ENCODEN; zX++)
217             {
218                 if (pP->outputsFromEncodes[zX] == z)
219                 {
220                     zE = zX;
221                     zS = pP->streamsFromEncodes[zE];
222                     break;
223                 }
224             }
226             // FL, New IO: add similar thing to be figured out
227 // Need to Revisit: Starting Clocks here seems logical & also manages the McASP without spurious underruns .
228 #if 0
229             // if device selected and valid then enable stat tracking if
230                         // required and start clocking
231                         if ((pAstCfg->xOut[z].outBufStatus.sioSelect < 0) && (pAstCfg->xOut[z].hTxSio))
232                         {
233                                 TRACE_VERBOSE0("PAF_ASOT_startOutput: start SIO clocks");
234                                 errme = SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_OUTPUT_START_CLOCKS, 0);
235                                 if (errno)
236                                 {
237                                         TRACE_VERBOSE2("PAF_ASOT_startOutput: errme 0x%x, errno 0x%x", errme, errno);
238                                         SIO_idle(pAstCfg->xOut[z].hTxSio);
239                                         if (!errno)
240                                         {
241                                                 errno = ASPERR_DEVOUT + errme;
242                                         }
243                                 }
244                         }
245 #endif            
247             // Set sample count so that DOB knows how much data to send
248             pAstCfg->xOut[z].outBufConfig.lengthofFrame =
249                 pAstCfg->xEnc[zE].encodeInStruct.pAudioFrame->sampleCount;
251             if (pAstCfg->xOut[z].outBufStatus.markerMode == PAF_OB_MARKER_ENABLED)
252             {
253                 pObj = (PAF_SIO_IALG_Obj *) pAstCfg->xOut[z].outChainData.head->alg;
254                 pAlgConfig = &pObj->config;
255                 memset(pAstCfg->xOut[z].outBufConfig.base.pVoid, 0xAA,
256                     pAlgConfig->pMemRec[0].size);
257             }
259             // The index to DEC_OUTNUMBUF_MAP will always come from the primary/master
260             // decoder. How should we handle the sourceProgram for multiple decoders?
261             // Override as needed
262             nbufs = DEC_OUTNUMBUF_MAP(pAstCfg->xDec[zMD].decodeStatus.sourceProgram);
263             if (pAstCfg->xOut[z].outBufStatus.numBufOverride[pAstCfg->xDec[zMD].decodeStatus.sourceProgram] > 0)
264             {
265                 nbufs = pAstCfg->xOut[z].outBufStatus.numBufOverride[pAstCfg->xDec[zMD].decodeStatus.sourceProgram];
266             }
267             //JXTODO: add similar thing to be figured out
268             //SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_SET_NUMBUF, nbufs);
270             //JXTODO: data transfer start to be moved to output task state machine
271             /*if (errno = SIO_issue(pAstCfg->xOut[z].hTxSio,
272                 &pAstCfg->xOut[z].outBufConfig, sizeof(pAstCfg->xOut[z].outBufConfig), 0))
273             {
274                 SIO_idle(pAstCfg->xOut[z].hTxSio);
275                 TRACE_TERSE2("PAF_ASOT_startOutput: AS%d: SIO_issue failed (0x%x)", as+zS, errno);
276                 return errno;
277             } */
279             //JXTODO: add similar thing to be figured out
280 #if 0
281             if (!(pAstCfg->xOut[z].outBufStatus.audio & 0xf0) &&
282                 (errno =  SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_UNMUTE, 0)))
283             {
284                 errno = (errno & 0xff) | ASPERR_MUTE;
285                 /* convert to sensical errno */
286                 TRACE_TERSE2("as1-f2: PAF_ASOT_startOutput: AS%d: SIO control failed (unmute) 0x%x", as+zS, errno);
287                 return errno;
288             }
289             else
290             {
291                 pAstCfg->xOut[z].outBufStatus.audio
292                     = (pAstCfg->xOut[z].outBufStatus.audio & 0xf0) | PAF_OB_AUDIO_SOUND;
293             }
294 #endif
295             TRACE_VERBOSE1("PAF_ASOT_startOutput: AS%d: output started", as+zS);
296         }
297     }
299     return 0;
300 } /* asopStartOutput */
302 // -----------------------------------------------------------------------------
303 // ASOT Decoding Function Helper - SIO Driver Stop
304 //
305 //   Name:      PAF_ASOT_stopOutput
306 //   Purpose:   Decoding Function for terminating output.
307 //   From:      AST Parameter Function -> decodeProcessing
308 //              AST Parameter Function -> decodeComplete
309 //   Uses:      See code.
310 //   States:    x
311 //   Return:    Error number in standard or SIO form (0 on success).
312 //   Trace:     Message Log "trace" in Debug Project Configuration reports:
313 //              * SIO control errors.
314 //
315 Int asopStopOutput(
316     const PAF_ASOT_Params *pP, 
317     const PAF_ASOT_Patchs *pQ, 
318     PAF_ASOT_Config *pAsotCfg
321     PAF_AST_Config *pAstCfg;
322     PAF_AST_IoOut  *pOut;
323     Int as;                     /* Audio Stream Number (1, 2, etc.) */
324     Int z;                      /* output counter */
325     Int errno = 0, getVal;
326     Int zS, zX;
327     PAF_SIO_IALG_Obj    *pObj;
328     PAF_SIO_IALG_Config *pAlgConfig;
330     pAstCfg = pAsotCfg->pAstCfg; // get pointer to AST common (shared) configuration
331     pOut = pAsotCfg->pIoOut; // get pointer to ASOT IO configuration
332     as = pAstCfg->as;
333     (void)as;  // clear compiler warning in case not used with tracing disabled
335     for (z=OUTPUT1; z < OUTPUTN; z++) 
336     {
337         if (pOut[z].hIoPhy) 
338         {
339             // determine associated encoder and stream
340             zS = z;
341             (void)zS;
342             for (zX = ENCODE1; zX < ENCODEN; zX++) 
343             {
344                 if (pP->outputsFromEncodes[zX] == z) 
345                 {
346                     zS = pP->streamsFromEncodes[zX];
347                     break;
348                 }
349             }
351 #if 0 // FL, New IO: add similar thing to be figured out            
352             // Mute output before audio data termination in the usual case,
353             // where such termination is due to decode error or user command.
354             // Identification of this as the usual case is provided by the
355             // "decode processing" state machine.
356             if (!(pAstCfg->xOut[z].outBufStatus.audio & 0xf0) &&
357                 ((pAstCfg->xOut[z].outBufStatus.audio & 0x0f) == PAF_OB_AUDIO_SOUND) &&
358                 (getVal = SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_MUTE, 0))) 
359             {
360                 if (!errno) 
361                 {
362                     errno = (getVal & 0xff) | ASPERR_MUTE;
363                     /* convert to sensical errno */
364                 }
365                 TRACE_VERBOSE1("asopStopOutput:  AS%d: SIO control failed (mute)", as+zS);
366             }
368             TRACE_TIME((&TIME_MOD, "... + %d = %d (stopOutput -- begin PAF_SIO_CONTROL_IDLE)", dtime(), TSK_time()));
369             
370             // Terminate audio data output, truncating (ignore) or flushing
371             // (play out) final samples as per (1) control register set by
372             // the user and (2) the type of audio data termination:
374 #if 0
375             // This form is not used because driver support for truncating
376             // data is not supported for internal clocks, although it is
377             // for external clocks.
378             getVal = SIO_ctrl(pC->xOut[z].hTxSio, PAF_SIO_CONTROL_IDLE,
379                 pC->xOut[z].outBufStatus.flush
380                 & (pC->xOut[z].outBufStatus.audio & 0x0f) == PAF_OB_AUDIO_FLUSH
381                 ? 1 : 0);
382             /* UNTESTED */
383 #else
384             // This form should be used when driver support for truncating
385             // data is supported for both internal and external clocks.
386             getVal = SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_IDLE,
387                 pAstCfg->xOut[z].outBufStatus.flush ? 1 :
388                 (pAstCfg->xOut[z].outBufStatus.audio & 0x0f) == PAF_OB_AUDIO_FLUSH
389                 ? 1 : 0);
390             /* TESTED */
391 #endif
393             TRACE_TIME((&TIME_MOD, "... + %d = %d (stopOutput -- after PAF_SIO_CONTROL_IDLE)", dtime(), TSK_time()));
395             if (!errno)
396             {
397                 errno = getVal;
398             }
400             // Mute output after audio data termination in a special case,
401             // where such termination is due to processing of a final frame
402             // or user command. Identification of this as a special case is
403             // provided by the "decode processing" state machine.
404             if (!(pAstCfg->xOut[z].outBufStatus.audio & 0xf0) &&
405                 ((pAstCfg->xOut[z].outBufStatus.audio & 0x0f) == PAF_OB_AUDIO_FLUSH) &&
406                 (getVal = SIO_ctrl(pAstCfg->xOut[z].hTxSio, PAF_SIO_CONTROL_MUTE, 0)))
407             {
408                 if (!errno) 
409                 {
410                     errno = (getVal & 0xff) | ASPERR_MUTE;
411                     /* convert to sensical errno */
412                 }
413                 TRACE_VERBOSE1("as1-f2: asopStopOutput:  AS%d: SIO control failed (mute)", as+zS);
414             }
416             pAstCfg->xOut[z].outBufStatus.audio &= ~0x0f;
417 #endif // FL, New IO
419             // zero output buffers
420             pObj = (PAF_SIO_IALG_Obj *) pAstCfg->xOut[z].outChainData.head->alg;
421             pAlgConfig = &pObj->config;
422             memset (pAstCfg->xOut[z].outBufConfig.base.pVoid, 0, pAlgConfig->pMemRec[0].size);
423         } //pAstCfg->xOut[z].hTxSio
424     }//OUTPUT
426     return errno;
427 } //asopStopOutput
429 // FL, New IO: this function is currently a stub
430 // FL, New IO: need to McASP/EDMA configuration using SAP configuration from Output shortcut
431 // Select Output devices
432 Int asopSelectDevices(PAF_AST_IoOut *pOut)
434     if((pOut->hIoBuff == NULL) || (pOut->hIoPhy == NULL) || (!d10Initialized)) {
435         return -1;
436     }
438     pOut->hMcaspChan = hMcaspTxChan;
440     return 0;
443 /*===========================================================================
444  * Initialize I/O components for output processing
445 ============================================================================*/
446 Int asopIoCompsInit(
447     PAF_AST_OutBuf *pOutBuf, 
448     PAF_AST_IoOut *pOutIo
451     // Initialize I/O BUFF and I/O PHY components for output task
452     ioBuffParams_t ioBuffParams;
453     ioPhyParams_t  ioPhyParams;
455     ioBuffParams.base         = pOutBuf->outBufConfig.base.pVoid;
456     ioBuffParams.size         = pOutBuf->outBufConfig.allocation/STRIDE_WORST_CASE*STRIDE_WORST_CASE;
457     ioBuffParams.sync         = IOBUff_READ_SYNC;
458     ioBuffParams.nominalDelay = OUTPUT_FRAME_SIZE * (NUM_PRIME_XFERS+1);
459     if(ioBuffInit(pOutIo->hIoBuff, &ioBuffParams) != IOBUFF_NOERR) 
460     {
461         return -1;   // to remove magic number
462     }
464     ioPhyParams.ioBuffHandle    = pOutIo->hIoBuff;
465     ioPhyParams.xferFrameSize   = OUTPUT_FRAME_SIZE;
466     ioPhyParams.mcaspChanHandle = hMcaspTxChan;
467     ioPhyParams.ioBuffOp        = IOPHY_IOBUFFOP_READ;
468     if(ioPhyInit(pOutIo->hIoPhy, &ioPhyParams) != IOPHY_NOERR) 
469     {
470         return -1;   // to remove magic number
471     }
473     pOutIo->phyXferSize = ioPhyParams.xferFrameSize;
475     return 0;
476 } /* asopIoCompsInit */
479 /*======================================================================================
480  *  I/O physical layer prime operation required by McASP LLD
481  *====================================================================================*/
482 Void asopIoPhyPrime(
483     PAF_AST_IoOut *pOut
486     Int32        count;
488     pOut->numPrimeXfers = NUM_PRIME_XFERS;
490     for (count = 0; count < pOut->numPrimeXfers; count++)
491     {
492         ioPhyXferSubmit(pOut->hIoPhy);
493     }
494 } /* asipIoPhyPrime */
497 /*======================================================================================
498  *  This function starts an I/O PHY transfer for output
499  *====================================================================================*/
500 Void asopPhyTransferStart(
501     PAF_AST_IoOut *pOut
504     if(mcaspCheckOverUnderRun(pOut->hMcaspChan)) 
505     {
506         mcaspTxReset();
507         mcaspTxCreate();
508         pOut->hMcaspChan = hMcaspTxChan;
509     }
510     else 
511     {
512         if(ioPhyXferSubmit(pOut->hIoPhy) == IOPHY_ERR_BUFF_UNDERFLOW) 
513         {
514             // Output buffer underflows!
515             System_abort("\nOutput buffer underflows!\n");
516         }
517         else {
518             // Output buffer operates normally
519             ;
520         }
521     }
524 // Write output buffers with encoded data
525 Int asopWriteOpBuffers(
526     PAF_OutBufConfig *pOpBufCfg, 
527     PAF_AST_IoOut *pOut
530     PAF_UnionPointer pntr;
531     void *buff1, *buff2;
532     size_t size1, size2;
533     int status;
535     pntr = pOpBufCfg->pntr; // get output buffer pointer
536     
537     status = ioBuffGetWritePtrs(pOut->hIoBuff, pOut->phyXferSize,
538         &buff1, &size1, &buff2, &size2);
539     if (status == IOBUFF_ERR_OVERFLOW) 
540     {
541         /* skip processing since output buffer overflows */
542         return IOBUFF_ERR_OVERFLOW;   // to use a different error code
543     }
545     // Copy data to output buffer to be transmitted by McASP
546     memcpy(buff1, &pntr.pSmInt[0], size1);
547     Cache_wbInv(buff1, size1, Cache_Type_ALL,TRUE);
549     ioBuffWriteComplete(pOut->hIoBuff, buff1, size1);
551     if (buff2 != NULL) 
552     {
553       memcpy(buff2, &pntr.pSmInt[size1], size2);
554       Cache_wbInv(buff2, size2, Cache_Type_ALL,TRUE);
556       ioBuffWriteComplete(pOut->hIoBuff, buff2, size2);
557     }
559     return 0;
562 // Check if at least one Output device SIO selection changed
563 Int checkOutDevSelUpdate(
564     const PAF_ASOT_Params *pP, 
565     PAF_ASOT_Config *pAsotCfg,
566     Int *pOutDevSelUpdate
569     PAF_AST_Config *pAstCfg;
570     Int outDevSelUpdate;
571     Int z;
572     
573     pAstCfg = pAsotCfg->pAstCfg; // get pointer to AST common (shared) configuration
575     outDevSelUpdate = 0;
576     for (z=OUTPUT1; z < OUTPUTN; z++) 
577     {
578         if (pAstCfg->xOut[z].outBufStatus.sioSelect >= 0)
579         {
580             outDevSelUpdate = 1;
581             break;
582         }
583     }
584     
585     *pOutDevSelUpdate = outDevSelUpdate;
587     return 0;
590 /* nothing past this point */