# การแนะนำเบื้องต้น

### \*\* ดาวน์โหลดเวอร์ชันล่าสุดของ [Petoi Desktop APP](https://github.com/PetoiCamp/OpenCat/releases). \*\*

Petoi Desktop App เป็นเครื่องมือที่ทำให้ง่ายขึ้นสำหรับเพื่อกำหนดค่าเฟิร์มแวร์ ปรับเทียบหุ่นยนต์ และออกแบบการเคลื่อนไหวที่กำหนดเองสำหรับหุ่นยนต์ โมดูลฟังก์ชันที่สำคัญคือ [Firmware Uploader](https://docs.petoi.com/desktop-app/firmware-uploader), [Joint Calibrator](https://docs.petoi.com/desktop-app/calibrator) และ [Skill Composer](https://docs.petoi.com/desktop-app/skill-composer).

ซอร์สโค้ดเขียนด้วย Tkinker ใน Python3 และเป็นโอเพ่นซอร์ส\
<https://github.com/PetoiCamp/OpenCat/tree/main/pyUI>.

UI.py เป็นเป็นโปรแกรมทั่วไปที่เชื่อมต่อกับส่วนอื่นทั้งหมด:

* UI.py

-> FirmwareUploader.py

-> Calibrator.py

-> SkillComposer.py

![](https://3127300255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBR9bYMZnmeFFa1GJLvjM%2Fuploads%2FXuDP0vxjb5XX2tawDzpl%2FGUI.jpeg?alt=media\&token=0e639d51-f703-42e0-a8c0-875e5b74eb75)

translate.py มีการองรับหลายภาษาใน UI สามารถเปลี่ยน UI เป็นภาษาที่ต้องการใช้งานได้

ก่อนเรียกใช้แอป คุณต้องใช้อะแดปเตอร์ USB ที่ให้มาหรือดองเกิลบลูทูธเพื่อเชื่อมต่อกับหุ่นยนต์ Petoi

## เอ็กซีคิวเทเบิ้ลไฟล์โปรแกรม

คุณสามารถดาวน์โหลด [pre-compiled executables](https://github.com/PetoiCamp/OpenCat/releases) ของแอพเดสก์ท็อปเพื่อหลีกเลี่ยงอินเทอร์เฟซการเขียนโปรแกรม

หลังจากดาวน์โหลดเวอร์ชัน Mac แล้ว คุณต้องลากลงในโฟลเดอร์แอปพลิเคชัน

หากคุณเห็นข้อความขึ้นว่าไม่สามารถเปิด "Petoi Desktop App" ได้เนื่องจากไม่สามารถตรวจสอบผู้พัฒนาได้ คุณสามารถคลิกขวาที่ไอคอน กดปุ่ม **Shift** และคลิ๊ก **Open**.

![](https://3127300255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBR9bYMZnmeFFa1GJLvjM%2Fuploads%2FL46fcJu0vBlqoLeIpdwD%2Fright%20open.JPG?alt=media\&token=82004544-4dde-4d6d-91e2-1dd751efefcc)

## เรียกใช้งานแอพจากเทอร์มินัล

ในกรณีของปัญหาเอ็กซีคิวเทเบิ้ลไฟล์โปรแกรม หรือถ้าคุณต้องการแก้ไขซอร์สและทดสอบ คุณสามารถรันโค้ดจากเทอร์มินัลได้เช่นกัน

เทอร์มินัล เป็นอินเทอร์เฟซในตัวบนเครื่อง Mac หรือ Linux สภาพแวดล้อมที่เทียบเท่าบนเครื่อง Windows เรียกว่า Command-Line Tool (CMD) ขอแนะนำให้คุณติดตั้ง [Anaconda](https://www.anaconda.com/) เพื่อจัดการสภาพแวดล้อม Python ของคุณ นอกจากนี้ยังสามารถให้ Powershell เป็นเทอร์มินัลสำหรับเครื่อง Windows รุ่นเก่า

ขึ้นอยู่กับการกำหนดค่า Python ที่มีอยู่ของคุณ คุณอาจต้องอัปเกรดเป็น Python3 และติดตั้งไลบรารีต่อไปนี้:

* pyserial
* pillow

คุณสามารถติดตั้งได้โดยพิมพ์ `pip3 install pyserial pillow` ใน เทอร์มินัล หรือใช้ตัวจัดการแพ็คเกจใน Anaconda

ในการรันโค้ด:

1. ใน Terminal ใช้คำสั่ง cd เพื่อนำทางไปยังโฟลเดอร์ OpenCat/pyUI/ คุณสามารถใช้แป้น Tab เพื่อเติมชื่อพาธโดยอัตโนมัติ
2. หลังจากเข้าสู่โฟลเดอร์ pyUI/ ให้ป้อน ls และตรวจสอบให้แน่ใจว่าคุณเห็น UI.py และซอร์สโค้ด python อื่น ๆ ในรายการ
3. รัน `python3 UI.py`.

{% hint style="info" %}
สำหรับผู้ใช้ระบบ Linux หากคุณพบข้อความแสดงข้อผิดพลาด "\_tkinter.TclError: no display name and no $DISPLAY environment variable", คุณสามารถลง **python3-tk**, **tk-dev**,เป็นคำสั่งสำหรับ Ubuntu/Debian โดยใช้คำสั่งต่อไปนี้:

`apt install python3-tk`

`apt install tk-dev`

หลังจากการติดตั้งเสร็จสิ้น ให้รีบูตเครื่องคอมพิวเตอร์
{% endhint %}