osMotorStart.htm
2.06 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<HTML>
<HEAD>
<TITLE>HTML 文書</TITLE>
<META NAME="GENERATOR" CONTENT="mitu">
</HEAD>
<BODY>
<P>
<B><FONT FACE="Arial">osMotorStart(3P)<BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
osMotorStart, osMotorStop
<P>
→ 振動パックの作動／停止<BR>
<P>
<B>構文<BR>
</B>
<P>
#include <ultra64.h><BR>
<P>
<B>s32 osMotorStart(OSPfs *pfs);<BR></B>
<P>
<B>s32 osMotorStop(OSPfs *pfs);<BR></B>
<P>
<B>説明<BR>
</B>
<P>
osMotorStartは、モータ作動関数です。OSPfs構造体pfsを引数とします。この関数の呼び出しを行うことによって、モータが動きます。
<BR>
<P>
内部的には、振動パックに単にデータを送っているだけであり、振動パックのステータスのチェックなどは高速化のために行っていません。そのため、振動パックを抜き差しした場合には、もう一度、<A HREF="osmotorinit.htm">osMotorInit</A>,(3P) の呼び出しを行わないと動作しません。また、当然ながらSIのアクセスをしており、そのためのSIのメッセージ待ちを内部で行っていますので、これを考慮した呼び出しが必要です。
<BR>
<P>
エラーコードとして PFS_ERR_CONTRFAILが返ってきた場合、通信が失敗しています。つまり、モータを作動させることができていません。通信上のエラーが発生する可能性が少なからずありますので、エラーコードを見て、本当に動作したかどうか確認する必要があります。
<BR>
<P>
osMotorStopは、モータ停止関数です。OSPfs構造体pfsを引数とします。この関数を呼ぶことによって、モータが止まります。内部的には、osMotorStartと同様の処理を行っています。
<BR>
<P>
注意点としては、振動パック動作中、振動パックとコネクタ間で接触不良になる
可能性があります。こういった場合、正しく動作できたかどうか、ソフト的には判
断ができないません。つまり、関数osMotorStart()（あるいは、関数osMotorStop()）
の呼び出しに成功したにもかかわらず、実際には振動パックが動いてない（止まっ
ていない）場合があります。
<BR>
<P>
特に、振動パックが動きっぱなしで止まらないという状況を避けるため、振動パッ
クを必ず止めるべきところでは、関数osMotorStop()を１fr.程度ごとに３回連続で
コールするようにしてください。
<BR>
<P>
<B>参照<BR>
</B>
<A HREF="osContInit.htm">osContInit</A>(3P),
<A HREF="osMotorInit.htm">osMotorInit</A>(3P),
</BODY>
</HTML>