| name | fairino-fr5-integration |
| description | Use when working on FAIRINO FR5 6-axis robot integration in this repo: collecting official FR5 docs, mapping Unity UI inputs to the FAIRINO C# SDK, planning real-robot control and safety, documenting FR5 hardware/DH/protocol details, or building adapters around MoveJ/MoveL/ServoJ/ServoCart and status feedback. |
Trigger
์๋ ์์ฒญ์์ ์ฌ์ฉ:
FAIRINO FR5 ๋ฌธ์ ์ ๋ฆฌ
FR5 ์ค๊ธฐ ๋ก๋ด ์ฐ๊ฒฐ
Unity์์ FAIRINO ์ ์ด
Fairino C# SDK ๋ถ์ด๊ธฐ
FR5 ์ํ ํผ๋๋ฐฑ/ํ๋กํ ์ฝ ํ์ธ
Read First
docs/ref/product/robots/fairino-fr5-integration-reference.md
docs/ref/product/robots/robot-model-library-spec.md
docs/ref/product/content/open-robotics-reference-pack.md
docs/ref/architecture-mermaid.md
Do
- FAIRINO ๊ณต์ ์ถ์ฒ๋ง ์ฐ์ ์ฌ์ฉํ๋ค.
- FR5 ๊ด๋ จ ์๋ฃ๋ฅผ
hardware / installation / DH / drawings / C# SDK / status feedback / command protocol๋ก ๋๋ ์ ์ ๋ฆฌํ๋ค.
- Unity ์ชฝ ์ค๊ณ๋ฅผ
UI -> validation -> simulation -> adapter -> live robot ๊ณ์ธต์ผ๋ก ๋ถ๋ฆฌํ๋ค.
- ์ค๊ธฐ ์ ์ด ์์ฒญ์์๋ ๋จผ์
MoveJ ๊ธฐ๋ฐ์ ์์ ํ joint move path๋ฅผ ์ ์ํ๊ณ , ํ์ํ ๋๋ง MoveL, ServoJ, ServoCart๋ก ํ์ฅํ๋ค.
- ์ํ ๋๊ธฐํ ์์
์์๋
GetActualJointPosDegree, GetRobotRealTimeState, SetStatePeriod, GetStatePeriod ํ์ฉ ์ฌ๋ถ๋ฅผ ๊ฒํ ํ๋ค.
8083 status protocol๊ณผ 20004 feedback cycle์ ๊ฐ์ ๊ฒ์ผ๋ก ๋จ์ ํ์ง ๋ง๊ณ ๋ณ๋ ๊ฒ์ฆ ํญ๋ชฉ์ผ๋ก ๋จ๊ธด๋ค.
- ์ฐ๊ฒฐ ์ค๊ณ ์
SDK version, robot software version, hardware version, firmware version, control box type ํ์ธ ๋จ๊ณ๋ฅผ ๋ฃ๋๋ค.
- errcode ์ฒ๋ฆฌ์์๋ ๊ณต์ error code table๊ณผ
GetSafetyCode, MotionQueueClear, controller log download API ํ์ฉ ์ฌ๋ถ๋ฅผ ํจ๊ป ๊ฒํ ํ๋ค.
- ์ค์ ๋ก๋ด ์ ๋จ๊ณ์์๋
SimMachine, STEP model, DWG/drawings๋ฅผ ํ์ฉํ offline ๊ฒ์ฆ ๊ฒฝ๋ก๋ฅผ ์ฐ์ ์ ์ํ๋ค.
- ๋ฌธ์ํ ์ ์ ํํ ๊ณต์ URL์ ํจ๊ป ๋จ๊ธด๋ค.
Do Not
- ๋น๊ณต์ ๋ธ๋ก๊ทธ, ํฌ๋ผ, ์ฌ๋ฐฐํฌ ๋ฌธ์๋ฅผ source of truth๋ก ์ฑํํ์ง ์๋๋ค.
- ZIP/PDF/SDK ๋ฐ์ด๋๋ฆฌ๋ฅผ ์ ์ฅ์์ ๊ทธ๋๋ก ์ถ๊ฐํ์ง ์๋๋ค.
- Unity UI ์ด๋ฒคํธ์์ SDK๋ฅผ ์ง์ ํธ์ถํ๊ฒ ๋ง๋ค์ง ์๋๋ค.
- joint limit, payload, mode, connection state ๊ฒ์ฆ ์์ด ์ค์ ๋ก๋ด ๋ช
๋ น์ ๋ณด๋ด์ง ์๋๋ค.
- ์ผ๋ฐ ์ด์ UI์ firmware/OS upgrade ๊ธฐ๋ฅ์ ์์ง ์๋๋ค.
Validation
Output Template
[fairino-fr5-integration ์๋ฃ]
- ๋์: {FR5 ๋ฌธ์ํ / Unity ์ ์ด / SDK ์ฐ๊ฒฐ / ์ํ ํผ๋๋ฐฑ}
- ๊ณต์ ์ถ์ฒ: {์ฌ์ฉํ ๋งํฌ}
- ํ๋์จ์ด baseline: {payload / reach / repeatability / installation}
- SDK ๊ฒฝ๋ก: {MoveJ / MoveL / ServoJ / ServoCart / status APIs}
- ์ถ๊ฐ ๊ฐ์น: {SimMachine / STEP / DWG / version notes / errcode / logs}
- Unity ๊ตฌ์กฐ: {UI -> validation -> simulation -> adapter -> live robot}
- ์ฃผ์์ฌํญ: {8083 vs 20004, safety, repo binary policy}