• State Resolved
  • Locked Locked
  • Replies 6 replies
  • Subscribers 100 subscribers
  • Views 554 views
  • Users 0 members are here
Support feedback
Options
Options
Related

This thread has been locked.

If you have a related question, please click the "Ask a related question" button in the top right corner. The newly created question will be automatically linked to this question.

Where to find documentation?

Brian Flinn
Expert 1180 points


Where would one find documentation on scripting .tcf files on things such as the following ?

prog.module("GBL").C64PLUSMAR192to223 = 0xFFFF ;

bios.setMemDataNoHeapSections  <<< ?

prog, SDRAM);
bios.setMemCodeSections
bios.setMemDataHeapSections

etc. documented ? I've looked in SPRU007H, PPRU423H etc and do not find. .
Thanks
Brian
  • 0
    TI__Mastermind 18320 points

    Brian,

    The SPRU007 doc is probably the best scripting doc in place for BIOS 5.x and since the focus for documentation is now in SYS/BIOS 6, I don't think there will be anything further added.

    But if you have specific questions, perhaps the E2E community can help you out.

    Dave

  • 0 in reply to David Friedland
    Expert 1180 points

    OK   I guess then one of my "specific questions" would be where is the definition of

    prog.module("GBL").C64PLUSMAR192to223 = 0xFFFF ;

    to be found?

    Thanks

  • 0 in reply to Brian Flinn
    TI__Mastermind 37985 points

    Brian,
    if you are asking where to find about the object 'prog' and its function 'module', see Section "Tconf Object Model Reference", specifically 5.5 Program Class, in SPRU007.
    If you are looking for the documentation for the module GBL on C64 devices, see Section "Application Program Interface", 2.8 GBL Module, in SPRU403.

    The function bios.setMemCodeSections and others are meant to be internal, and they are not documented.

     

  • 0 in reply to Sasha Slijepcevic
    Intellectual 620 points

    Sasha Slijepcevic said:
    The function bios.setMemCodeSections and others are meant to be internal, and they are not documented.

    I find this to be very strange, considering these methods are used in example code distributed by TI to help users get started using DSPLink. How am I supposed to understand how to use this stuff. I find it very challenging when things that are meant to make tasks easier just make them harder.

    Is there any chance someone can give an answer in response to this post?  That would be a fairly simple solution that would aid many people without having to write up a new SPRXXXXX.pdf document.

     

     

  • 0 in reply to Judson Wilson
    TI__Mastermind 37985 points

    The functions bios.setMemCodeSections, bios.setMemDataNoHeapSections and bios.setMemDataHeapSections can be used to set all config parameters that require a memory segment to a specific memory segment.

    Some config parameters that require a data memory segment also require that the selected memory segment has a heap enabled. The function bios.setMemDataHeapSections() will set all such parameters to the memory segment passed as a parameter. Therefore, that memory segment must have a heap enabled, otherwise the call will fail.
    The function bios.setMemDataNoHeapSections() will set all config parameters that require a data memory segment, but do not require a memory segment with a heap enabled.
    The function bios.setMemCodeSections() will set all config parameters that require a code memory segment.

    For example, the following code will set all config parameters that require a memory segment to IRAM or DDR (assuming there are such segments defined in the platform):
    bios.setMemCodeSections (prog, bios.IRAM);
    bios.setMemDataNoHeapSections (prog, bios.DDR);
    bios.setMemDataHeapSections (prog, bios.DDR);

  • 0 in reply to Sasha Slijepcevic
    Intellectual 620 points

    Thank you! Very useful description.