Tip / Sign in to post questions, reply, level up, and achieve exciting badges. Know more

Legacy microcontrollers Forum Discussions

MurbiesWalto
Level 1
First question asked Welcome!
Level 1

I am trying to understand this Assembly macro that sets the stack pointer to the location of a Task Stack of a RTOS. There are a few Assembly commands that I don't know and where I can't find that much information of.

This code points the User stack pointer to the stack of a Micrium Task (uC/OS III RTOS). But these tasks are only allowed to lay into near memory, and that is probably because of these assembly functions.

That's why I'm trying to find out what exactly is happening here. And why the stack can only be in near memory. After that I would like to find out if I can rewrite this to support tasks stacks outside of the near memory.

This assembly code is running on a XE169 chip (C166 Family):

LOAD_USRSTK_PTR .MACRO
    EXTP    #PAG _OSTCBHighRdyPtr,#02h    ; R4/R5 = OSTCBHighRdyPtr
    MOV     R4,POF _OSTCBHighRdyPtr
    MOV     R5,POF (_OSTCBHighRdyPtr+2)

    EXTP    R5,#01h                       ; user stack ptr = OSTCBHighRdyPtr->OSTCBStkPtr
    MOV     R15,[R4]
.ENDM

This is how far I've found out what each line of code does:

LOAD_USRSTK_PTR .MACRO

Start of macro with the name LOAD_USRSTK_PTR

EXTP    #PAG _OSTCBHighRdyPtr,#02h

Begin Extended Page Sequence, the next 2 instructions are part of the Extended Page Sequence

What does the #PAG _OSTCBHighRdyPtr part in this instruction mean, does this get the Page part of of the address where OSTCBHighRdyPtr is pointing to.

MOV     R4,POF _OSTCBHighRdyPtr

Write _OSTCBHighRdyPtr into Register 4. What does POF mean in this instruction, does it get the value of the pointer and store that in Register 4?

MOV     R5,POF (_OSTCBHighRdyPtr+2)

Write the value of at 2 addresses further as the address of OSTCBHighRdyPtr to Register 5. What does POF mean in this instruction Is it in this case copying the ExtPtr address? because this address is 4 bytes long, and the Register only 2 bytes?

EXTP    R5,#01h                       ; user stack ptr = OSTCBHighRdyPtr->OSTCBStkPtr

Begin Extended Page Sequence. Next 1 instruction is part of the Extended Page Sequence. R5 = Register 5 what exactly is done with this register

MOV     R15,[R4]

Move the value of Register 4 into Register 15, R15 is the User Stack Pointer

.ENDM

End of Macro

The _OSTCBHighRdyPtr is a pointer to a struct, the (beginning) of this struct looks like this:

struct os_tcb {
    CPU_STK      *StkPtr;         /* Pointer to current top of stack                  */
    void         *ExtPtr;         /* Pointer to user definable data for TCB extension */
    CPU_CHAR     *NamePtr;        /* Pointer to task name                             */
    CPU_STK      *StkLimitPtr;    /* Pointer used to set stack 'watermark' limit      */
    ....
}

CPU_STK is a typedef of unsigned short __near.

The sizes of the items in this struct are:

StkPtr = 2 bytes (in near memory thus 2 bytes is enough)
ExtPtr = 4 bytes
NamePtr = 4 bytes
StkLimitPtr = 2 bytes (in near memory thus 2 bytes is enough)
0 Likes
2 Replies
Vasanth
Moderator
Moderator 250 sign-ins 500 solutions authored First question asked
Moderator

Hi,

Unfortunately the support the for XE16 family is minimal. We would recommend you to contact the local FAE if you already were in contact with during the acquisition of the part.

Best Regards,
Vasanth

0 Likes
OliverG
Level 1
First question asked 5 sign-ins First reply posted
Level 1

Hello MurbiesWalto.

Regarding "What does POF mean in this instruction ... ?": [1] 3.7.3, page 106, states "POF ... page offset ... Returns the page offset of the operand (operand & 0x3FFF)".

References:
[1] https://www.tasking.com/support/c166/c166_user_guide_v2.4.pdf

Regards
Oliver.

0 Likes