📄 int8u ostaskcreateext.htm
字号:
<p class=NewSectionPara><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=NewSectionPara><b><span lang=EN-US>Notes/Warnings<o:p></o:p></span></b></p>
<p class=Descript><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=Descript><span lang=EN-US>The stack MUST be declared with the </span><b><span
lang=EN-US style='font-family:"Courier New"'>OS_STK</span></b><span lang=EN-US>
type.</span></p>
<p class=Descript><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=Descript><span lang=EN-US>A task MUST always invoke one of the
services provided by µC/OS-II to either wait for time to expire, suspend the
task or, wait an event to occur (wait on a mailbox, queue or semaphore).<span
style="mso-spacerun: yes"> </span>This will allow other tasks to gain
control of the CPU.</span></p>
<p class=Descript><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=Descript><span lang=EN-US>You should not use task priorities </span><b><span
lang=EN-US style='font-family:"Courier New"'>0</span></b><span lang=EN-US>, </span><b><span
lang=EN-US style='font-family:"Courier New"'>1</span></b><span lang=EN-US>, </span><b><span
lang=EN-US style='font-family:"Courier New"'>2, 3</span></b><span lang=EN-US>
and </span><b><span lang=EN-US style='font-family:"Courier New"'>OS_LOWEST_PRIO-3</span></b><span
lang=EN-US>, </span><b><span lang=EN-US style='font-family:"Courier New"'>OS_LOWEST_PRIO-2</span></b><span
lang=EN-US>, </span><b><span lang=EN-US style='font-family:"Courier New"'>OS_LOWEST_PRIO-1</span></b><span
lang=EN-US> and </span><b><span lang=EN-US style='font-family:"Courier New"'>OS_LOWEST_PRIO</span></b><span
lang=EN-US> because they are reserved for µC/OS-II’s use.<span
style="mso-spacerun: yes"> </span>This thus leaves you with up to 56
application tasks.</span></p>
<p class=Descript><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=NewSectionPara><b><span lang=EN-US>Example #1<o:p></o:p></span></b></p>
<p class=NewSectionPara><b><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></b></p>
<p class=Descript><span lang=EN-US>The task control block is extended (1) using
a ‘user defined’ data structure called </span><b><span lang=EN-US
style='font-family:"Courier New"'>TASK_USER_DATA</span></b><span lang=EN-US>
(2) which, in this case, contains the name of the task as well as other
fields.<span style="mso-spacerun: yes"> </span>The task name is
initialized with the </span><b><span lang=EN-US style='font-family:"Courier New"'>strcpy()</span></b><span
lang=EN-US> standard library function (3).<span style="mso-spacerun:
yes"> </span>Note that stack checking has been enabled (4) for this task
and thus, you are allowed to call </span><b><span lang=EN-US style='font-family:
"Courier New"'>OSTaskStkChk()</span></b><span lang=EN-US>.<span
style="mso-spacerun: yes"> </span>Also, we assume here that the stack
grown downward (5) on the processor used (i.e. </span><b><span lang=EN-US
style='font-family:"Courier New"'>OS_STK_GROWTH</span></b><span lang=EN-US> is
set to 1).<span style="mso-spacerun: yes"> </span>TOS stands for
‘Top-Of-Stack’ and BOS stands for ‘Bottom-Of_Stack’.</span></p>
<p class=Descript><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<div style='border:solid #999999 1.5pt;padding:1.0pt 1.0pt 15.0pt 1.0pt;
background:#F2F2F2;mso-shading:windowtext;mso-pattern:gray-5 auto'>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>typedef struct {<span
style="mso-spacerun:
yes">
</span>/* (2) User defined data structure */</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>char<span
style="mso-spacerun: yes"> </span>TaskName[20];</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>INT16U<span style="mso-spacerun: yes"> </span>TaskCtr;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>INT16U<span style="mso-spacerun: yes"> </span>TaskExecTime;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>INT32U<span style="mso-spacerun: yes"> </span>TaskTotExecTime;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>} TASK_USER_DATA;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>OS_STK<span style="mso-spacerun:
yes">
</span>*TaskStk[1024];</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>TASK_USER_DATA<span
style="mso-spacerun: yes"> </span>TaskUserData;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>void main(void)</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>{</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span><span style="mso-spacerun:
yes"> </span>INT8U err;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span><span style="mso-spacerun:
yes"> </span>OSInit();<span style="mso-spacerun:
yes">
</span>/* Initialize µC/OS-II<span style="mso-spacerun:
yes"> </span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>strcpy(TaskUserData.TaskName, "MyTaskName");<span
style="mso-spacerun: yes"> </span>/* (3) Name of task<span
style="mso-spacerun: yes"> </span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>err =
OSTaskCreateExt(Task, </span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>(void *)0, </span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>&TaskStk[1023],<span style="mso-spacerun:
yes">
</span>/* (5) Stack grows down (TOS) */</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>10,</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>10,</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>&TaskStk[0],<span style="mso-spacerun:
yes">
</span>/* (5) Stack grows down (BOS) */</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>1024, </span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>(void *)&TaskUserData,<span style="mso-spacerun:
yes"> </span>/* (1) TCB Extension<span
style="mso-spacerun:
yes"> </span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>OS_TASK_OPT_STK_CHK);<span style="mso-spacerun:
yes"> </span>/* (4) Stack
checking enabled */</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>OSStart();<span
style="mso-spacerun:
yes">
</span>/* Start Multitasking<span style="mso-spacerun:
yes"> </span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>}</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>void Task(void *pdata)</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>{</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -