Long last wanted: XEQ_Auto-Complete finally done

[Monte Dalrymple]

(07-25-2017 02:47 PM)Sylvain Cote Wrote:  Hello Monte,

I have created the following scenarios to clear up my (non?) understanding of the port assignment using PPLUG.
Please do the correction where they are needed.

Example 1 : one set of applications spent over 2 non-bank-switched images that will normally use one port on the back

1. location: the 2 images are at 0x840 and 0x841
2. expected: 0x840 at page 8 bank 0 & 0x841 at page 9 bank 0
3. command: "+840 8" PPLUG
   

Example 2 : one set of applications spent over 4 non-bank-switched images that will normally use two ports on the back

1. location: the 4 images are at 0x840, 0x841, 0x842 and 0x843
2. expected: 0x840 at page 8 bank 0, 0x841 at page 9 bank 0, 0x842 at page A bank 0 & 0x843 at page B bank 0
3. command: "%840 8" PPLUG
   

Example 3 : one set of applications spent over 2 bank-switched images that will normally use one half-port on the back

1. location: the 2 images are at 0x840, 0x841
2. expected: 0x840 at page 8 bank 0 & 0x841 at page 8 bank 1
3. command: "*840 8" PPLUG
   

Example 4 : one set of applications spent over 4 bank-switched images that will normally use one half-port on the back

1. location: the 4 images are at 0x840, 0x841, 0x842 and 0x843
2. expected: 0x840 at page 8 bank 0, 0x841 at page 8 bank 1, 0x842 at page 8 bank 2 & 0x843 at page 8 bank 3
3. command: "*840 8" PPLUG
   

Example 5 : two sets of applications spent over 7 bank-switched images that will normally use one port on the back

1. location 1: the app 1 has 3 images are at 0x840, 0x841 and 0x842
2. location 2: the app 2 has 4 images are at 0x843, 0x844, 0x845 and 0x846
3. expected 1: 0x840 at page 8 bank 0, 0x841 at page 8 bank 1 & 0x842 at page 8 bank 2
4. expected 2: 0x843 at page 9 bank 0, 0x844 at page 9 bank 1, 0x845 at page 9 bank 2 & 0x846 at page 9 bank 3
   is it ?
5. command 1: "*840 8" PPLUG
6. command 2: "*843 9" PPLUG
   or
7. command: "/840 8" PPLUG
   

Question for #5: how do you find how many images are part of the same image set ?

Thank you!

Best regards,

Sylvain

Examples 1, 2 and 4 are correct.

Example 3 is a subset of Example 4, and the two pages at 0x842 and 0x843 will still
be loaded, even though they are never referenced by the code at 0x840 and 0x841.

Example 5 is partially correct. When using two "*" types everything will work. But if
you want to use the "/" type, the second page needs to start at 0x844.

The type code tells the PPLUG exactly how the MMU should be programmed, and
the order and count is fixed. Recall that each page/bank combination has an MMU
entry that must be programmed. Using your example, with starting address 0x840,
this is how the MMU registers are programmed: (page/bank)

"-" : P1/B1 gets 0x840, P1/B2 gets 0x840, P1/B3 gets 0x840, P1/B4 gets 0x840

"+" : P1/B1 gets 0x840, P1/B2 gets 0x840, P1/B3 gets 0x840, P1/B4 gets 0x840
P2/B1 gets 0x841, P2/B2 gets 0x841, P2/B3 gets 0x841, P2/B4 gets 0x841

"$" : P1/B1 gets 0x840, P1/B2 gets 0x840, P1/B3 gets 0x840, P1/B4 gets 0x840
P2/B1 gets 0x841, P2/B2 gets 0x841, P2/B3 gets 0x841, P2/B4 gets 0x841
P3/B1 gets 0x842, P3/B2 gets 0x842, P3/B3 gets 0x842, P3/B4 gets 0x842

"%" : P1/B1 gets 0x840, P1/B2 gets 0x840, P1/B3 gets 0x840, P1/B4 gets 0x840
P2/B1 gets 0x841, P2/B2 gets 0x841, P2/B3 gets 0x841, P2/B4 gets 0x841
P3/B1 gets 0x842, P3/B2 gets 0x842, P3/B3 gets 0x842, P3/B4 gets 0x842
P4/B1 gets 0x843, P4/B2 gets 0x843, P4/B3 gets 0x843, P4/B4 gets 0x843

"+* : P1/B1 gets 0x840, P1/B2 gets 0x841, P1/B3 gets 0x842, P1/B4 gets 0x843

"/" : P1/B1 gets 0x840, P1/B2 gets 0x841, P1/B3 gets 0x842, P1/B4 gets 0x843
P2/B1 gets 0x844, P2/B2 gets 0x845, P2/B3 gets 0x846, P2/B4 gets 0x847

All of these options work with PPLUG, but only "-" and "*" work with PLUG, because
the partial-key code that I use for all prompting functions doesn't handle the
other keypresses.

Hope this clarifies things. I guess I need to expand the section in the manual.

Monte