การติดตั้งและเชื่อมต่อไลบรารี่กับ Arduino นั้นเป็นการดำเนินการที่ค่อนข้างธรรมดาไม่ช้าก็เร็วนักพัฒนาคนใดก็ย่อมต้องเผชิญกับมันอย่างหลีกเลี่ยงไม่ได้ โค้ดปลั๊กอินภายนอกในทุกภาษาการเขียนโปรแกรมใช้เพื่อประหยัดเวลา Arduino ก็ไม่มีข้อยกเว้น: เซ็นเซอร์ โมดูล หน้าจอ และมอเตอร์จำนวนมากจำเป็นต้องมีค่อนข้างมาก วงจรที่ซับซ้อนการโต้ตอบที่ยากต่อการนำไปใช้ในโค้ดของคุณ การดาวน์โหลดไลบรารี่ที่ต้องการทำได้ง่ายกว่าและเร็วกว่ามาก เชื่อมต่อด้วยตนเองหรือใช้งานอย่างรวดเร็ว อาร์ดูโน่ IDEแล้วใช้มันกับภาพร่างทั้งหมดของคุณ ในบทความนี้คุณจะได้พบกับ คำแนะนำสั้น ๆในการเชื่อมต่อและใช้งานไลบรารี

ไลบรารี่ใน Arduino คือ รหัสโปรแกรมใน ไฟล์ภายนอกซึ่งสามารถติดตั้งและเชื่อมต่อกับภาพร่างของคุณได้ ร้านห้องสมุด วิธีการต่างๆและโครงสร้างข้อมูลที่จำเป็นเพื่อทำให้การทำงานกับเซ็นเซอร์ ตัวบ่งชี้ โมดูล และส่วนประกอบอื่นๆ ง่ายขึ้น การใช้ไลบรารีทำให้การทำงานในโครงการง่ายขึ้นอย่างมาก เนื่องจากคุณสามารถมุ่งเน้นไปที่ตรรกะหลักของโปรแกรมโดยไม่ต้องเสียเวลากับสิ่งเล็กๆ น้อยๆ มากมาย ปัจจุบันมีการโพสต์ห้องสมุดจำนวนมากบนอินเทอร์เน็ตซึ่งสามารถดาวน์โหลดได้ง่ายและไม่เสียค่าใช้จ่ายใด ๆ สามารถพบได้บนเว็บไซต์ของเรา

จากมุมมอง ระบบไฟล์ไลบรารีเป็นไดเร็กทอรีที่ประกอบด้วย โฟลเดอร์เฉพาะ- ระหว่างการรวบรวมและการประกอบ โครงการอาร์ดูโน่ IDE จะรวมคลาส โครงสร้างข้อมูล และวิธีการจากไลบรารีที่รวมและใช้ในร่างไว้ในโค้ดของคุณโดยอัตโนมัติ ดังนั้นสิ่งเดียวที่เราต้องทำคือใส่คำแนะนำที่เหมาะสมลงในโค้ดของเรา หลังจากที่แน่ใจแล้ว ห้องสมุดที่จำเป็นติดตั้งแล้ว

วิธีค้นหารายการไลบรารีที่เชื่อมต่อกับ Arduino IDE

แต่ละไลบรารีที่ติดตั้งจะมีตัวอย่างอย่างน้อยหนึ่งตัวอย่างที่จะใช้งาน ใช้เพื่อแสดงความสามารถของอุปกรณ์ที่เชื่อมต่อกับ Arduino ดังนั้นที่สุด อย่างรวดเร็วรับรายการไลบรารี Arduino ที่ติดตั้งทั้งหมด - ใช้รายการตัวอย่างใน Arduino IDE เมื่อต้องการทำเช่นนี้ ให้เลือกไฟล์จากเมนูหลัก จากนั้นเปิดเมนูย่อยตัวอย่าง

อีกวิธีหนึ่งคือการใช้เมนู Sketch และเมนูย่อย - รวมไลบรารี ที่นั่นคุณสามารถดูรายชื่อห้องสมุดได้:

การเชื่อมต่อไฟล์ส่วนหัว h ด้วยตัวดำเนินการ #include

ในการเริ่มใช้งานไลบรารี คุณจะต้องรวมไฟล์ส่วนหัว h เข้ากับคำสั่ง include ที่จุดเริ่มต้นของโปรแกรม ตัวอย่างเช่น การรวมไลบรารี LiquidCrystal.h จะมีลักษณะดังนี้: #include

คุณสามารถดูได้ ตัวอย่างเต็มโดยใช้ห้องสมุดนั่นเอง

ไฟล์ที่จำเป็นในไลบรารี

แต่ละไลบรารีจะต้องมีไฟล์อย่างน้อย 2 ไฟล์ - ไฟล์ส่วนหัวที่มีนามสกุล .h และไฟล์ที่มี รหัสแหล่งที่มาพร้อมนามสกุล .cpp ไฟล์ส่วนหัวประกอบด้วยคำอธิบายคลาส ค่าคงที่ และตัวแปร ไฟล์ที่สองประกอบด้วยรหัสวิธีการ นอกจากไฟล์หลักสองไฟล์แล้ว มันอาจมี เอกสารข้อความ keywords.txt และโฟลเดอร์ตัวอย่างพร้อมโค้ดตัวอย่างการใช้งานไลบรารี ไฟล์ h และ cpp ไม่จำเป็นต้องอยู่ในรูท

การแก้ไขไฟล์ไม่สามารถทำได้ใน Arduino IDE; การเปลี่ยนแปลงทั้งหมดสามารถทำได้ในรูปแบบใดก็ได้ โปรแกรมแก้ไขข้อความหรือสภาพแวดล้อมการพัฒนา C++ นี่เป็นเพราะความจริงที่ว่าใน Arduino IDE เราไม่ทำงานกับไฟล์ cpp ตัวแก้ไขโค้ดไม่ได้ออกแบบมาสำหรับ C "บริสุทธิ์" แต่ใช้งานได้กับภาษา Arduino เท่านั้น

จะหาห้องสมุดที่ต้องการได้ที่ไหน

สามารถดาวน์โหลดไลบรารีที่จำเป็นได้ทางอินเทอร์เน็ต ไลบรารีส่วนใหญ่มีอยู่บน Github หลังจากดาวน์โหลดไลบรารี่แล้ว สิ่งสำคัญคือต้องเพิ่มไลบรารี่ลงในโฟลเดอร์ที่ถูกต้องเพื่อให้คอมไพเลอร์สามารถค้นหาและโหลดแบบร่างได้ โฟลเดอร์ที่บันทึกรหัสทั้งหมดจะถูกสร้างขึ้นบนคอมพิวเตอร์หลังจากนั้น การติดตั้ง Arduinoไอดี สำหรับ ระบบปฏิบัติการ โฟลเดอร์ลินุกซ์มีชื่อ "Scetchbook" และอยู่ใน /home/; บน Windows โฟลเดอร์ "Arduino" สามารถพบได้ในส่วน "เอกสารของฉัน"

ไลบรารีทั้งหมดที่ติดตั้งเพิ่มเติมจะอยู่ในโฟลเดอร์ "Libraries" สำหรับ Arduino เวอร์ชันก่อนหน้า คุณต้องสร้างโฟลเดอร์ด้วยตัวเอง แต่ตั้งแต่เวอร์ชัน 1.0.2 เป็นต้นไป โฟลเดอร์นั้นจะถูกเพิ่มโดยอัตโนมัติเมื่อติดตั้ง Arduino IDE

วิธีการติดตั้งไลบรารี่ คำแนะนำทีละขั้นตอน

เมื่อดาวน์โหลดไลบรารี่ลงในพีซีของคุณแล้ว คุณจะต้องเริ่มการติดตั้ง มีสองวิธีในการติดตั้งไลบรารี - การใช้งาน เครื่องมือ Arduino IDE และด้วยตนเอง

การเชื่อมต่อโดยใช้ Arduino IDE

ไลบรารีจะถูกดาวน์โหลดเป็นไฟล์ zip หากต้องการเปิดใช้งานโดยใช้วิธีนี้ ไม่จำเป็นต้องแตกไฟล์เก็บถาวร หากต้องการติดตั้ง คุณต้องไปที่เมนู Sketch – เชื่อมต่อไลบรารี – ไลบรารี Add.Zip

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

จากนั้นคุณจะต้องเลือกไฟล์ที่ดาวน์โหลดแล้วคลิก "เปิด"

ไลบรารีจะถูกติดตั้งและคุณสามารถใช้งานได้ ในการเริ่มใช้ไฟล์ตัวอย่าง - ตัวอย่าง คุณต้องรีสตาร์ทสภาพแวดล้อมการพัฒนา Arduino

การติดตั้งไลบรารีด้วยตนเองจากไฟล์ zip

ก่อนที่จะเริ่มการติดตั้ง คุณต้องออกจาก Arduino IDE ก่อน ไฟล์ zip ที่ดาวน์โหลดพร้อมไลบรารี่จะต้องแตกไฟล์ เป็นผลให้เราจะได้รับโฟลเดอร์ที่จะเก็บไฟล์ไลบรารีที่มีนามสกุล .cpp และ .h และไดเร็กทอรี โฟลเดอร์ผลลัพธ์จะต้องถูกวางในไลบรารี

ใน Windows OS โฟลเดอร์ไลบรารีสามารถพบได้ภายใต้เส้นทาง My Documents – Arduino – libraries บน Linux นี่จะเป็นโฟลเดอร์ไลบรารีที่มีภาพร่าง

ในตอนท้ายคุณต้องรีสตาร์ท Arduino IDE ไลบรารีที่ดาวน์โหลดจะพร้อมสำหรับการรวมผ่าน Sketch - Connect Library

ข้อผิดพลาดเมื่อเชื่อมต่อไลบรารี Arduino

ด้านล่างเป็นรายการ ข้อผิดพลาดที่เป็นไปได้เมื่อติดตั้งไลบรารี่และวิธีจัดการกับไลบรารี่:

• 'xxxx' ไม่ได้ตั้งชื่อประเภท - ข้อผิดพลาดที่คล้ายกันจะปรากฏขึ้นหากยังไม่ได้ติดตั้งไลบรารี ตั้งชื่อโฟลเดอร์หรือไลบรารีไม่ถูกต้อง ระบุ ที่อยู่ผิดตำแหน่งโฟลเดอร์หรือสภาพแวดล้อมยังไม่ได้ถูกรีสตาร์ท การพัฒนาอาดูโน่ไอดี
• ตำแหน่งโฟลเดอร์ไม่ถูกต้อง - หากข้อผิดพลาดนี้ปรากฏขึ้น คุณต้องตรวจสอบว่าไลบรารีอยู่ในโฟลเดอร์ที่สภาพแวดล้อมสามารถค้นหาได้หรือไม่
• ชื่อไลบรารีไม่ถูกต้อง - ข้อผิดพลาดจะปรากฏขึ้นหากชื่อหลัง #include ไม่ตรงกับชื่อไลบรารี
• ไลบรารีที่ไม่สมบูรณ์ - อาจปรากฏขึ้นหากไม่ได้ดาวน์โหลดทั้งหมด ไฟล์ที่จำเป็นและโฟลเดอร์
• การขึ้นต่อกันของไลบรารี - เนื่องจากไลบรารีประเภทนี้ใช้งานได้กับไลบรารีเพิ่มเติมเท่านั้น คุณจึงต้องรวมไลบรารีเหล่านี้ไว้ตั้งแต่แรก

ไลบรารี Arduino เป็นเครื่องมือที่สะดวกสำหรับการกระจายโค้ด ตัวอย่างเช่น สิ่งเหล่านี้อาจเป็นไดรเวอร์ฮาร์ดแวร์หรือฟังก์ชันที่ใช้บ่อย

คู่มือนี้จะอธิบายรายละเอียดวิธีการติดตั้งไลบรารีบนคอมพิวเตอร์ของคุณ

ไลบรารี Arduino มีสองประเภทหลัก: มาตรฐานและเพิ่มเติม

ไลบรารีมาตรฐาน

Arduino IDE มีชุดหนึ่ง ห้องสมุดมาตรฐานซึ่งใช้บ่อยมาก ไลบรารีเหล่านี้รองรับตัวอย่างทั้งหมดที่รวมอยู่ใน Arduino IDE ไลบรารีมาตรฐานรองรับฟังก์ชันสำหรับการทำงานกับอุปกรณ์ต่อพ่วงทั่วไป เช่น เซอร์โวมอเตอร์หรือหน้าจอ LCD

ไลบรารีมาตรฐานได้รับการติดตั้งในโฟลเดอร์ "Libraries" เมื่อติดตั้ง Arduino IDE หากคุณติดตั้ง IDE หลายเวอร์ชัน แต่ละเวอร์ชันจะมีชุดไลบรารีของตัวเอง ขอแนะนำอย่างยิ่งว่าอย่าเปลี่ยนไลบรารีมาตรฐานและติดตั้งไลบรารีเพิ่มเติมในโฟลเดอร์เดียวกัน

ห้องสมุดเพิ่มเติม

ห้องสมุดเพิ่มเติมจำนวนมากด้วย ฟังก์ชั่นที่สะดวกและไดรเวอร์ต่างๆ อุปกรณ์ต่อพ่วง- ห้องสมุดส่วนใหญ่โพสต์บน Arduino Playground, Github และ Google Code การเขียนไลบรารี่สำหรับ Arduino มักทำโดยผู้ผลิตเซ็นเซอร์ ทรานสดิวเซอร์ แผงวงจรพิมพ์และอื่น ๆ ตัวอย่างเช่น Adafruit มีไลบรารีมากกว่า 100 แห่งที่รองรับบอร์ด Arduino ทุกรุ่น

ติดตั้งไลบรารีเพิ่มเติมในโฟลเดอร์ Libraries ด้วยเหตุนี้จึงสามารถใช้ได้กับ Arduino IDE ทุกรุ่น หลังจากอัปเดตเวอร์ชันแล้ว คุณจะไม่ต้องติดตั้งใหม่อีก!

จะติดตั้งไลบรารีได้ที่ไหน

สิ่งสำคัญคือต้องติดตั้งไลบรารี่ในโฟลเดอร์ที่ถูกต้อง มิฉะนั้นคอมไพเลอร์จะไม่สามารถค้นหามันได้เมื่อคุณคอมไพล์และโหลดโค้ดของคุณ

โฟลเดอร์ที่เก็บทุกอย่างไว้ ภาพร่าง Arduinoจะถูกสร้างขึ้นโดยอัตโนมัติเมื่อคุณติดตั้ง IDE

บน Linux โฟลเดอร์เรียกว่า "Scetchbook" และโดยปกติจะอยู่ใน /home/<username>

บน Windows และ Macintosh โฟลเดอร์นี้เรียกว่า "Arduino" และอยู่ในโฟลเดอร์ Documents

โปรดทราบว่านี่เป็นสิ่งสำคัญ! ในโฟลเดอร์ "My Documents" จะมีการสร้างโฟลเดอร์อื่นชื่อ "Arduino" ขึ้นมาโดยอัตโนมัติ!

ไลบรารีเพิ่มเติมควรอยู่ในโฟลเดอร์ "Libraries" ซึ่งอยู่ภายใน "Scetchbook" หรือ "Arduino" นี่คือที่ที่ IDE จะค้นหาไลบรารีที่ติดตั้งเพิ่มเติม

จาก Arduino IDE 1.0.2 และใหม่กว่า โฟลเดอร์ "Libraries" จะถูกสร้างขึ้นโดยอัตโนมัติ สำหรับข้อมูลเพิ่มเติม รุ่นก่อนหน้าจะต้องสร้างขึ้นก่อนที่จะติดตั้งไลบรารีแรกของคุณ

เปิดเมนูและเลือก "ไฟล์ -> การตั้งค่า" ใน Arduino IDE

>

ค้นหาตำแหน่งของภาพร่างของคุณ ปกติจะเป็นโฟลเดอร์ "Arduino" ในโฟลเดอร์ "My Documents"

เมื่อคุณกำหนดเส้นทางแล้ว ให้นำทางไปยังโฟลเดอร์นั้นโดยใช้ File Explorer

หากไม่มีโฟลเดอร์ Libraries ให้สร้างโฟลเดอร์ใหม่

เปลี่ยนชื่อเป็น "ห้องสมุด"

การติดตั้งไลบรารี่บน Windows

หากต้องการติดตั้งไลบรารีบน Windows ให้ทำตามคำแนะนำด้านล่าง

ปิด Arduino IDE

ตรวจสอบให้แน่ใจว่า Arduino IDE ปิดอยู่ เนื่องจากไลบรารีจะถูกสแกนเมื่อมีการโหลด IDE เท่านั้น ไลบรารีใหม่จะไม่ทำงานจนกว่าคุณจะรีสตาร์ท IDE

ดาวน์โหลด ไฟล์ซิปจาก Github

คัดลอกโฟลเดอร์ที่คลายซิป

วางลงในโฟลเดอร์ไลบรารีของคุณ

มอบให้เธอ ชื่อที่ถูกต้อง- Arduino IDE ไม่รู้จักโฟลเดอร์ที่มีเครื่องหมายขีดกลางชื่อ ดังนั้นคุณจะต้องเปลี่ยนชื่อโฟลเดอร์ คุณสามารถใช้ใต้ขีดกลางได้

รีสตาร์ท Arduino IDE และตรวจสอบว่าไลบรารีปรากฏในรายการเมนูไฟล์ -> ตัวอย่างหรือไม่

หากต้องการตรวจสอบ ให้ดาวน์โหลดตัวอย่างรายการใดรายการหนึ่ง

ก่อนที่จะอัพโหลดตัวอย่างขึ้นบอร์ด ให้ตรวจสอบภาพร่างก่อน

การติดตั้งไลบรารี่บน Mac OSX

หากต้องการติดตั้งไลบรารีเพิ่มเติมบน Mac OSX อย่างถูกต้อง ให้ทำตามคำแนะนำด้านล่าง

ปิด Arduino IDE

ดาวน์โหลดไฟล์เก็บถาวรไลบรารีจาก Github

ค้นหาไฟล์เก็บถาวรที่ดาวน์โหลดมาในโฟลเดอร์ดาวน์โหลดบน Mac ของคุณ

แตกไฟล์และคัดลอกไลบรารีไปยังโฟลเดอร์ไลบรารีที่สร้างขึ้นเมื่อคุณติดตั้ง Arduino IDE

ตั้งชื่อที่ถูกต้องให้กับห้องสมุด เช่นเดียวกับในกรณีของ Windows โฟลเดอร์ที่มีขีดกลางจะไม่สามารถอ่านได้

รีสตาร์ท Arduino IDE ไลบรารีควรปรากฏในเมนูไฟล์ -> ตัวอย่าง

ดาวน์โหลดหนึ่งในตัวอย่าง

โปรดตรวจสอบว่าร่างถูกต้องก่อนที่จะอัปโหลดไปยัง Arduino ของคุณ

การติดตั้งไลบรารี่บน Linux

หากต้องการติดตั้งไลบรารีแบบกำหนดเองบน Linux ให้ทำตามคำแนะนำด้านล่าง

ปิด Ardino IDE อีกครั้ง

ดาวน์โหลดไฟล์เก็บถาวรด้วยไลบรารีที่เราต้องการ

เราบันทึกไฟล์เก็บถาวรไปที่ ฮาร์ดดิสพีซีของเรา

ค้นหาไฟล์เก็บถาวรที่ดาวน์โหลดมาในโฟลเดอร์ดาวน์โหลด

แตกไฟล์ไลบรารีและคัดลอกไปยังโฟลเดอร์ Sketchbook/Libraries

ตั้งชื่อโฟลเดอร์ให้ถูกต้อง ไม่รีบ!

รีสตาร์ท Arduino IDE และตรวจสอบว่าไลบรารีปรากฏในโฟลเดอร์เมนูไฟล์ -> ตัวอย่างหรือไม่

มาดาวน์โหลดหนึ่งในตัวอย่างกัน

เราตรวจสอบว่าไฟล์ตัวอย่างคอมไพล์โดยไม่มีข้อผิดพลาดหรือไม่

ข้อผิดพลาดทั่วไปเมื่อติดตั้งไลบรารี่สำหรับ Arduino

"xxxx" ไม่ได้ตั้งชื่อประเภท

นี่เป็นข้อผิดพลาดที่พบบ่อยที่สุดเมื่อทำงานกับไลบรารีภายนอก เหตุผลก็คือคอมไพเลอร์ไม่พบไลบรารี เหตุผลที่เป็นไปได้ข้อผิดพลาดนี้เกิดขึ้น:

• ไม่ได้ติดตั้งไลบรารี (ดูคำแนะนำการติดตั้งด้านบน)
• ตำแหน่งโฟลเดอร์ไม่ถูกต้อง
• ชื่อโฟลเดอร์ไม่ถูกต้อง
• ชื่อห้องสมุดไม่ถูกต้อง
• คุณลืมรีสตาร์ท Arduino IDE

ด้านล่างนี้เป็นวิธีแก้ไขปัญหาที่เป็นไปได้

ตำแหน่งโฟลเดอร์ไม่ถูกต้อง

IDE จะค้นหาเฉพาะไลบรารีมาตรฐานและไลบรารีเพิ่มเติมที่ติดตั้งในโฟลเดอร์ "Libraries" ไลบรารีที่อยู่ในตำแหน่งอื่นจะไม่ได้รับการเตรียมใช้งาน

โฟลเดอร์ไลบรารีควรอยู่ในรากของโฟลเดอร์ "Libraries" หากคุณสร้างโฟลเดอร์ย่อยเพิ่มเติม IDE จะไม่ตรวจพบไลบรารี

หมายเหตุ: ในพื้นที่เก็บข้อมูลออนไลน์บางแห่ง จะมีการโพสต์ไลบรารีด้วย ระดับเพิ่มเติมการซ้อนโฟลเดอร์ ตรวจสอบช่วงเวลานี้ ไฟล์ไลบรารีจะต้องอยู่ในโฟลเดอร์แรกโดยไม่มีโฟลเดอร์ย่อยเพิ่มเติม

ไม่ใช่ห้องสมุดที่สมบูรณ์

คุณไม่ควรเปลี่ยนชื่อไฟล์ในไลบรารีโดยใช้ ตัวพิมพ์ใหญ่, เส้นประ ฯลฯ

ชื่อโฟลเดอร์ไม่ถูกต้อง

IDE ตรวจไม่พบโฟลเดอร์ด้วย อักขระบางตัวในชื่อเรื่อง ขออภัย IDE ไม่รองรับขีดกลางซึ่งสร้างขึ้นในชื่อไฟล์บน Github ดังนั้นหลังจากดาวน์โหลดไฟล์เก็บถาวรแล้วให้เปลี่ยนชื่อโฟลเดอร์ ชื่อใหม่ต้องไม่มีขีดกลาง คุณสามารถแทนที่อักขระทั้งหมด ('-') ด้วย ('_') ได้

ชื่อห้องสมุดไม่ถูกต้อง

ชื่อที่คุณระบุในคำสั่ง #include ในแบบร่างของคุณจะต้องตรงกับชื่อของคลาสในไลบรารีทุกประการ (คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่!) หากชื่อไม่ตรงกัน IDE จะไม่เชื่อมต่อ ฟังก์ชั่นที่จำเป็น, ชั้นเรียน ฯลฯ ในตัวอย่างที่มาพร้อมกับไลบรารี ชื่อนั้นถูกต้อง ดังนั้นเพื่อหลีกเลี่ยงข้อผิดพลาดโดยไม่ตั้งใจ คุณสามารถคัดลอกและวางลงในโค้ดของคุณได้

ไลบรารีหลายเวอร์ชัน

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

ไลบรารี่ที่ต้องพึ่งพา

ห้องสมุดบางแห่งขึ้นอยู่กับห้องสมุดอื่น ตัวอย่างเช่น ไลบรารีการแสดงผลกราฟิกของ Adafruit ส่วนใหญ่จะขึ้นอยู่กับไลบรารี Adafruit GFX นั่นคือในการใช้ไลบรารีแรกคุณต้องติดตั้งไลบรารีที่สองก่อน

ห้องสมุด "พื้นฐาน"

ไลบรารีบางแห่งไม่สามารถใช้งานได้โดยตรง ตัวอย่างที่ดี, ห้องสมุด GFX ไลบรารีนี้ขับเคลื่อนจอแสดงผลส่วนใหญ่จาก Adafruit แต่ไม่สามารถใช้งานได้หากไม่มีไลบรารีไดรเวอร์สำหรับจอแสดงผลนั้น

ลืมปิด Arduino IDE

อย่าลืมว่า IDE จะค้นหาไลบรารีเมื่อทำการโหลด ก่อนใช้อันใหม่ ห้องสมุดที่ติดตั้งจำเป็นต้องรีบูต Arduino IDE

แสดงความคิดเห็นคำถามและแบ่งปัน ประสบการณ์ส่วนตัวด้านล่าง. แนวคิดและโครงการใหม่ๆ มักเกิดในการสนทนา!

เพื่อให้ทำงานกับ Arduino ได้ง่ายและมีประสิทธิภาพมากขึ้น คุณสามารถใช้ไลบรารีเพิ่มเติมได้ ไลบรารี Arduino เป็นส่วนหนึ่งของโปรแกรมที่จะดำเนินการ งานเฉพาะ- ด้วยไลบรารี คุณสามารถดำเนินการที่ซับซ้อนได้โดยใช้โค้ดเพียงไม่กี่บรรทัด เนื่องจากมีคนอื่นเขียนโค้ดบางส่วนให้คุณแล้ว

ใน Arduino IDE ส่วนต่อประสานที่ใช้งานง่ายสำหรับการทำงานกับไลบรารี Arduino โดยตรงจากเมนูโปรแกรม คุณสามารถดาวน์โหลด ติดตั้ง และเชื่อมต่อไลบรารีจำนวนมากเข้ากับภาพร่างของคุณได้ สำหรับไลบรารี Arduino ส่วนใหญ่ คุณสามารถดูตัวอย่างการใช้งานได้ สิ่งนี้จะช่วยให้คุณเข้าใจวิธีการทำงานของห้องสมุด ตัวอย่างสามารถแก้ไขได้เพื่อให้เหมาะกับความต้องการของคุณและนำไปใช้ในการติดตั้งอุปกรณ์ของคุณเอง

มีไลบรารีมาตรฐานที่ติดตั้งด้วย Arduino IDE บางส่วนจะรวมอยู่ในร่างโดยอัตโนมัติด้วยซ้ำ (เช่น อนุกรม)

ดาวน์โหลดไลบรารีมาตรฐาน Arduino

คุณสามารถดาวน์โหลดไลบรารีมาตรฐานได้จากเว็บไซต์ Arduino อย่างเป็นทางการ

คุณจะพบคำอธิบายและตัวอย่างการใช้ไลบรารีมาตรฐาน คุณยังสามารถดาวน์โหลดไลบรารี่มาตรฐานทั้งหมดได้ในที่เดียว ไฟล์เก็บถาวรนี้ไม่เพียงแต่ประกอบด้วยไลบรารีมาตรฐานเท่านั้น แต่ยังมีไลบรารียอดนิยมเพิ่มเติมสำหรับ Arduino อีกด้วย

ด้านล่างนี้คือ คำอธิบายโดยละเอียดและตัวอย่างการใช้ไลบรารีมาตรฐาน Arduino

• — ห้องสมุดเพื่อแลกเปลี่ยนข้อมูลผ่าน พอร์ตอนุกรม(ยูอาร์ที).
• — ไลบรารีสำหรับการควบคุมเซอร์โวที่ง่ายและแม่นยำ
• — ไลบรารีสำหรับการทำงานกับอินเทอร์เฟซการสื่อสาร TWI/I2C ลดความซับซ้อนในการแลกเปลี่ยนข้อมูลกับอุปกรณ์ เซนเซอร์ และโพรบ
• อินเตอร์เน็ตไร้สาย— การเชื่อมต่ออินเทอร์เน็ตด้วย ใช้อินเตอร์เน็ตไร้สายโล่.
• ทีเอฟ— จำเป็นสำหรับการวาดภาพข้อความ รูปภาพ และรูปภาพ จอแสดงผลแบบทีเอฟอาร์ดูโน่.
• สเต็ปเปอร์— ห้องสมุดสำหรับควบคุมสเต็ปเปอร์มอเตอร์
• ลิควิดคริสตัล- สำหรับ อาร์ดูโน่ทำงานพร้อมหน้าจอคริสตัลเหลว (LCD)
• อีเทอร์เน็ต— เพื่อเชื่อมต่ออินเทอร์เน็ตโดยใช้ .
• เอสดี— ห้องสมุดสำหรับเขียนและอ่านข้อมูลจากการ์ดหน่วยความจำ SD
• จีเอสเอ็ม— ไลบรารีสำหรับเชื่อมต่อ Arduino กับ เครือข่ายจีเอสเอ็ม- จำเป็นสำหรับการจัดส่งและ รับ SMSและการโทรรวมถึงการเข้าถึงอินเทอร์เน็ตโดยใช้ GPRS ใช้กับ.
• อีพรอม— ไลบรารีสำหรับการอ่านและเขียนไปยังหน่วยความจำแบบไม่ลบเลือนของ Arduino

ขอให้เป็นวันที่ดี, ผู้อ่านที่รักและผู้ใช้พอร์ทัลถังขยะ! คุณเคยสงสัยบ้างไหมว่าไลบรารีคืออะไรและทำไมจึงจำเป็นในการเขียนโปรแกรม Arduino? ไม่ว่าในกรณีใด คุณจะพบคำตอบสำหรับคำถามทั้งสองนี้ในบทความนี้

มันคืออะไร?

ไลบรารีในการเขียนโปรแกรมคือชุดของรูทีนหรืออ็อบเจ็กต์ที่ใช้ในการพัฒนาซอฟต์แวร์

หากเราพิจารณาสถานการณ์ด้วยภาษา Arduino นี่คือชุดองค์ประกอบโค้ดที่ติดตั้งแยกต่างหากจากสภาพแวดล้อมการพัฒนาและให้บริการเพื่อโต้ตอบกับโมดูลหรือเซ็นเซอร์ใด ๆ

เพื่อความชัดเจนยิ่งขึ้นฉันจะยกตัวอย่าง คุณได้เชื่อมต่อเซอร์โวกับ Arduino แล้ว เพื่อที่จะโต้ตอบกับมัน คุณต้องรวมไลบรารี่ในตัวด้วย เซอร์โว.เอช- เสร็จสิ้นที่จุดเริ่มต้นของการร่างภาพของคุณโดยใช้คำสั่ง # รวมถึงServo.h.
ห้องสมุด เซอร์โว.เอชรวมถึงชุดคำสั่งสำหรับ การควบคุมที่สะดวกเซอร์โวไดรฟ์

เซอร์โว

ด้านล่างนี้เป็นตัวอย่างโค้ดพร้อมคำอธิบาย

#รวม // #include คำสั่งรวมไลบรารีด้วย
เซอร์โว ไมเซอร์โว; // ประกาศตัวแปรชื่อ myservo ประเภท Servo
การตั้งค่าเป็นโมฆะ () // ขั้นตอนมาตรฐานติดตั้ง
{
myservo.แนบ(10); // command.attach ผูกเซอร์โวเข้ากับพอร์ต 10 (อย่างอื่นที่เป็นไปได้)
}
เป็นโมฆะวน()
{
myservo.write(0); // command.write หมุนเพลาเซอร์โวไปยังมุมที่ต้องการ (ได้ตั้งแต่ 0 ถึง 180)

myservo.write(180); // หมุนเพลา 180 องศา
ล่าช้า (2000); // หยุดชั่วคราว 2 วินาที
}

สิ่งที่คุณต้องเน้นจากโค้ดนี้:

• ใช้ // เพื่อระบุความคิดเห็นบรรทัดเดียว หากจำเป็น ความคิดเห็นหลายบรรทัดจากนั้นเราวางมันลงใน /*… */
• โดยใช้คำสั่ง #รวมคุณสามารถเชื่อมต่อห้องสมุดใดก็ได้
• ทีม .แนบ()และ .เขียน()เป็นของห้องสมุด เซอร์โว.เอช.
• ทีม ล่าช้า()ใช้ไม่ได้กับห้องสมุด เซอร์โว.เอชเธอเป็นของ คำสั่งมาตรฐาน ภาษาอาดูโน่.
• ก่อนคำสั่งใดๆ ชื่อจะถูกเขียนไว้ ประเภทตัวแปร เซอร์โว
• ตัวแปรหนึ่งใช้กับเซอร์โวเพียงตัวเดียวเท่านั้น

มีห้องสมุดมากมายและคุณสามารถดาวน์โหลดได้ทางอินเทอร์เน็ตหากคุณเริ่มค้นหาโมดูลที่คุณต้องการ โดยวิธีการภาษา การเขียนโปรแกรม Arduinoเรียกว่า Wiring และเป็นเวอร์ชันที่เรียบง่ายของ C ++

จะติดตั้งไลบรารี่ได้อย่างไร?

หากต้องการนำไลบรารี่ไปใช้กับโค้ด คุณต้องติดตั้งไลบรารี่ และต้องดาวน์โหลดไลบรารีก่อน ไลบรารีที่คุณดาวน์โหลดจะอยู่ในรูปแบบของไฟล์เก็บถาวรซึ่งจะต้องแตกไฟล์ออกไป การติดตั้งเพิ่มเติม- ถัดไป จะต้องย้ายโฟลเดอร์ไลบรารีไปยังโฟลเดอร์ Arduino/libraries การติดตั้งโดยละเอียดคุณสามารถดูภาพหน้าจอด้านล่าง

หากการติดตั้งสำเร็จ ใน Arduino IDE คุณจะสามารถค้นหาภาพร่างตัวอย่างจากไลบรารีที่ติดตั้งได้

สิ่งสำคัญคือต้องบอกว่าก่อนที่จะใช้ไลบรารีที่ติดตั้งใหม่ Arduino IDE จะต้องรีบูต

ประเภทของห้องสมุด

ไลบรารี Arduino ทั้งหมดสามารถแบ่งออกเป็นหลายประเภท:

• ไลบรารีมาตรฐาน (ในตัว) คือไลบรารีที่สร้างขึ้นใน Arduino IDE พวกเขาไม่ต้องการ การติดตั้งแยกต่างหากและสามารถใช้งานได้ทันทีหลังจากติดตั้ง Arduino IDE
• ไลบรารีเพิ่มเติมคือไลบรารีที่ไม่ได้สร้างไว้ใน Arduino IDE สามารถพบได้บนอินเทอร์เน็ตเช่นบน Github การพัฒนาห้องสมุดเหล่านี้ดำเนินการโดยผู้ผลิตเซ็นเซอร์เป็นหลัก
• ไลบรารีที่ขึ้นต่อกัน - ไลบรารีเหล่านี้ถูกจัดประเภทเป็นไลบรารีเพิ่มเติม ห้องสมุดที่ไม่สามารถทำงานได้หากไม่มีห้องสมุดอื่นเรียกว่าห้องสมุดที่ขึ้นต่อกัน

เหตุใดจึงต้องมีห้องสมุด?

ไลบรารีในภาษาการเขียนโปรแกรม Arduino จำเป็นเพื่อทำให้โค้ดง่ายขึ้นและใช้งานได้ โมดูลต่างๆ- โดยพื้นฐานแล้ว คำสั่งเดียวจากไลบรารีจะซ่อนโค้ดหลายบรรทัดที่เขียนโดยผู้สร้างไลบรารี ตามทฤษฎีแล้ว โมดูลส่วนใหญ่สามารถควบคุมได้โดยไม่ต้องใช้ไลบรารี อย่างไรก็ตาม การเขียนแบบร่างสำหรับสิ่งนี้จะต้องใช้เวลาและความพยายามอย่างมาก แต่ถึงกระนั้น คุณก็ไม่น่าจะสามารถควบคุมจอ LCD ได้หากไม่ได้รับความช่วยเหลือจากห้องสมุด

นั่นคือเหตุผลที่จอแสดงผลถือเป็นหนึ่งในโมดูลที่ยากที่สุดสำหรับผู้เริ่มต้น จากนั้นเรามาดูตัวอย่างแบบร่างสำหรับควบคุมการแสดงผล เพราะมันเกี่ยวข้องกับสองไลบรารีในคราวเดียว

จอแสดงผลแอลซีดีด้วยโปรโตคอล I2C

อย่างไรก็ตาม เราจะพิจารณาไม่ใช่การแสดงข้อความธรรมดา แต่เป็นการแสดงด้วยโปรโตคอล I2C โปรโตคอล I2C เป็นกระดานดำขนาดเล็ก ด้านหลังจอแสดงผล (ภาพที่สอง) บอร์ดนี้พร้อมด้วยไลบรารีที่เกี่ยวข้อง ได้รับการออกแบบมาเพื่อลดบรรทัดโค้ดและลดจำนวนสายในการเชื่อมต่อ โดยจำกัดไว้เพียงสี่บรรทัด

#รวม // เชื่อมต่อไลบรารีเพื่อทำงานกับ I2C
#รวม // เชื่อมต่อไลบรารีเพื่อทำงานกับการแสดงข้อความ

จอแอลซีดี LiquidCrystal_I2C (0x27, 16, 2);
/* เพื่อให้จอแสดงผลใช้งานได้ คุณต้องค้นหาที่อยู่ของมัน แต่เราจะไม่พิจารณาสิ่งนี้ในบทความนี้ 16 - จำนวนเซลล์ต่อบรรทัด 4 - จำนวนบรรทัด พารามิเตอร์เหล่านี้สามารถเปลี่ยนแปลงได้ขึ้นอยู่กับจอแสดงผล -

การตั้งค่าเป็นโมฆะ ()

{
จอแอลซีดี.เริ่มต้น(); //เปิดจอแสดงผล
จอแอลซีดีแบ็คไลท์ (); // เปิดใช้งานแบ็คไลท์
lcd.print("สวัสดีชาวโลก!"); // ข้อความที่ส่งออก
}

เป็นโมฆะวน()
{
// เราไม่ได้เขียนอะไรที่นี่
}

ฉันแน่ใจว่าคุณได้พบคำสั่งที่เกี่ยวข้องกับห้องสมุดแล้ว LiquidCrystal_I2C.h.นี้ .begin .แบ็คไลท์และ .พิมพ์- ในภาพร่างนี้คือห้องสมุด ไวร์.เอชจำเป็นสำหรับ การดำเนินการที่ถูกต้องโปรโตคอล I2C

บรรทัดล่าง

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

เอกสารนี้อธิบายการสร้างไลบรารีสำหรับ Arduino คำอธิบายจะเริ่มต้นด้วยการเขียนภาพร่างการส่งรหัสมอร์สโดยใช้ไฟ LED จากนั้นจะแสดงวิธีการแปลงร่างให้เป็นไลบรารี ซึ่งจะช่วยให้ผู้ใช้รายอื่นสามารถใช้โค้ดที่สร้างขึ้น อัปเดตและขยายได้อย่างง่ายดาย

ร่างการสร้างรหัสมอร์ส:

พินอินท์ = 13; การตั้งค่าเป็นโมฆะ() ( pinMode(pin, OUTPUT); ) void loop() ( dot(); dot(); dot(); dash(); dash(); dash(); dot(); dot(); dot(); ล่าช้า (3000); ) โมฆะ dot () ( digitalWrite (พิน, สูง); digitalWrite (พิน, ต่ำ); ล่าช้า (250); ) โมฆะขีด () ( digitalWrite (พิน, สูง) ) ); ล่าช้า (1,000); digitalWrite (พิน, ต่ำ);

ภาพร่างนี้สร้างสัญญาณ SOS โดยการกะพริบ LED บนพิน 13

แบบร่างประกอบด้วยโค้ดจำนวนหนึ่งที่จะต้องถ่ายโอนไปยังห้องสมุด ประการแรก สิ่งเหล่านี้คือฟังก์ชัน จุด()และ เส้นประ()ซึ่งควบคุมการกระพริบของไฟ LED ประการที่สอง มันเป็นตัวแปร ledPin, กำหนดพอร์ต I/O ที่จะใช้ และสุดท้าย การเรียกใช้ฟังก์ชัน พินโหมด()ซึ่งตั้งค่าโหมดเอาท์พุตบนพอร์ต I/O ที่ใช้งาน .

กระบวนการแปลงร่างให้เป็นห้องสมุด

ไลบรารีประกอบด้วยสองไฟล์: ไฟล์ส่วนหัว (ที่มีนามสกุล .h) และไฟล์การใช้งาน (ที่มีนามสกุล .cpp) ไฟล์ส่วนหัวมีคุณสมบัติของไลบรารีเช่น รายการทุกสิ่งที่อยู่ในนั้น ไฟล์ส่วนหัวที่สร้างขึ้นจะถูกเรียกว่า Morse.h สำหรับ ทำงานต่อไปด้วยไฟล์ส่วนหัว คุณต้องดูเนื้อหาของไฟล์การใช้งาน

ไฟล์ส่วนหัวประกอบด้วยคลาสที่มีการประกาศฟังก์ชันและตัวแปรที่ใช้:

คลาสมอร์ส (สาธารณะ: มอร์ส (int pin); void dot (); void dash (); ส่วนตัว: int _pin; );

ชั้นเรียนใน ในกรณีนี้นี่คือชุดของฟังก์ชันและตัวแปรที่รวมอยู่ในที่เดียว ฟังก์ชั่นและตัวแปรสามารถเป็นแบบสาธารณะ ( สาธารณะ), ซึ่งหมายความว่า การเข้าถึงทั่วไปถึงพวกเขาทุกคนที่ใช้ห้องสมุดหรือส่วนตัว ( ส่วนตัว) ซึ่งหมายความว่าสามารถเข้าถึงได้ภายในชั้นเรียนเท่านั้น แต่ละชั้นเรียนก็มี ฟังก์ชั่นพิเศษ Constructor ซึ่งใช้ในการสร้างอินสแตนซ์ของคลาส Constructor มีชื่อเหมือนกับคลาส แต่ไม่มีประเภทการส่งคืน

นอกจากนี้ไฟล์ส่วนหัวยังมีอีกหลายไฟล์ บรรทัดเพิ่มเติม- ประการแรก นี่คือคำสั่ง #รวมซึ่งทำให้เข้าถึงได้ ประเภทมาตรฐานและ ภาษาถาวรการเขียนโปรแกรม Arduino (คำสั่งเริ่มต้นจะถูกเพิ่มลงในแต่ละภาพร่าง แต่ไม่ใช่ในไลบรารี) คำสั่งมีลักษณะดังนี้ (และอยู่เหนือการประกาศคลาส):

#รวม "WProgram.h"

ใน Arduino เวอร์ชัน 1.0 ขึ้นไป คุณต้องเพิ่ม:

#รวมArduino.h

เป็นเรื่องปกติที่จะใส่เนื้อหาของไฟล์ส่วนหัวไว้ในโครงสร้างต่อไปนี้:

#ifndef Morse_h #define Morse_h // #include สั่งการและโค้ดอยู่ที่นี่ #endif

สิ่งนี้จะป้องกัน การเชื่อมต่อใหม่ห้องสมุดของเรา หากมีผู้รวมห้องสมุดไว้สองครั้งพร้อมคำสั่งโดยไม่ตั้งใจ #รวม.

ในตอนต้นของรหัสห้องสมุด เป็นเรื่องปกติที่จะแสดงความคิดเห็นเกี่ยวกับวัตถุประสงค์ ผู้แต่ง วันที่ และใบอนุญาตสำหรับห้องสมุด

ไฟล์ส่วนหัวที่เสร็จแล้วประกอบด้วย:

/* Morse.h - ห้องสมุดสำหรับกระพริบรหัสมอร์ส สร้างโดย David A. Mellis, 2 พฤศจิกายน 2550 เผยแพร่สู่สาธารณสมบัติ */ #ifndef Morse_h #define Morse_h #include "WProgram.h" คลาสมอร์ส ( สาธารณะ: Morse(int pin); void dot(); void dash(); private: int _pin; ); #เอ็นดิฟ

มาดูไฟล์การใช้งาน Morse.cpp กัน

มีหลายคำสั่งที่ตอนต้นของโค้ด #รวม- คำสั่งเหล่านี้อนุญาตให้เข้าถึงมาตรฐาน ฟังก์ชั่น Arduinoและคุณสมบัติในไฟล์ไลบรารี่ส่วนหัว:

#รวม "WProgram.h" #รวม "Morse.h"

ถัดไปในโค้ดคือตัวสร้าง มันถูกใช้เพื่อสร้างอินสแตนซ์ สร้างชั้นเรียน- ในกรณีนี้ ผู้ใช้ระบุหมายเลขพอร์ต I/O ที่ใช้ผ่านพารามิเตอร์ พอร์ตถูกตั้งค่าเป็นโหมดเอาต์พุต และหมายเลขจะถูกจัดเก็บไว้ในตัวแปรส่วนตัวเพื่อใช้ในฟังก์ชันอื่นๆ:

มอร์ส::มอร์ส(int pin) ( pinMode(pin, OUTPUT); _pin = pin; )

รหัส มอร์ส:: หมายถึงฟังก์ชันที่อยู่ในคลาสมอร์ส . ช่องว่างที่จุดเริ่มต้นของชื่อตัวแปร _ เข็มหมุด — ได้รับการยอมรับการกำหนดสำหรับตัวแปรส่วนตัว โดยทั่วไป ชื่ออาจเป็นอะไรก็ได้ แต่ตามแบบแผนการตั้งชื่อที่เป็นที่ยอมรับ เป็นเรื่องปกติที่จะใช้คำนำหน้า “_” สำหรับตัวแปรส่วนตัว นอกจากนี้ยังทำให้สามารถแยกแยะความแตกต่างจากอาร์กิวเมนต์ของฟังก์ชันได้ (ในกรณีนี้ เข็มหมุด).

โมฆะมอร์ส :: dot () ( digitalWrite (_pin, สูง); ล่าช้า (250); digitalWrite (_pin, LOW); ล่าช้า (250); ) โมฆะ Morse :: dash () ( digitalWrite (_pin, สูง); ล่าช้า ( 1,000); digitalWrite (_พิน, ต่ำ);

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

/* Morse.cpp - ไลบรารีสำหรับกระพริบรหัสมอร์ส สร้างโดย David A. Mellis, 2 พฤศจิกายน 2550 เผยแพร่สู่สาธารณสมบัติ */ #include "WProgram.h" #include "Morse.h" Morse::Morse(int pin) ( pinMode(pin, OUTPUT); _pin = pin; ) โมฆะ Morse::dot() ( digitalWrite(_pin, HIGH ); ล่าช้า (250); digitalWrite (_pin, LOW); โมฆะ Morse :: dash () ( digitalWrite (_pin, สูง); ล่าช้า (1,000); digitalWrite (_pin, LOW); ล่าช้า (250 ; )

การใช้ห้องสมุด

ขั้นแรกคุณต้องสร้างโฟลเดอร์ มอร์สในโฟลเดอร์ย่อย ห้องสมุดไดเร็กทอรีแผ่นจดบันทึก ประการที่สอง คุณต้องคัดลอกไฟล์ Morse.h และ Morse.cpp ไปยัง soz โฟลเดอร์นี้- หลังจากเปิดตัว โปรแกรมอาดูโน่บนเมนู ร่าง > นำเข้าไลบรารีห้องสมุดมอร์สจะตั้งอยู่ ห้องสมุดจะรวบรวมพร้อมภาพร่างที่ใช้ หากมีปัญหาเกิดขึ้นเมื่อรวบรวมไลบรารี คุณต้องตรวจสอบว่าไฟล์มีนามสกุล .cpp และ .h (ไม่ควรมีนามสกุล .pde และ .txt เพิ่มเติมใดๆ)

ร่างเริ่มต้นที่เขียนใหม่โดยใช้ไลบรารีที่สร้างขึ้นจะมีลักษณะดังนี้:

#รวม มอร์ส มอร์ส(13); การตั้งค่าเป็นโมฆะ() ( ) void loop() ( morse.dot(); morse.dot(); morse.dot(); morse.dash(); morse.dash(); morse.dash(); morse.dot (); morse.dot();

ความแตกต่างเล็กน้อยจากร่างต้นฉบับ:

ขั้นแรก มีการเพิ่มคำสั่ง #รวมจนถึงจุดเริ่มต้นของร่าง สิ่งนี้จะกำหนดความพร้อมใช้งานของห้องสมุด Morse และการเชื่อมต่อ ไลบรารีที่ไม่ได้ใช้สามารถลบออกได้โดยการลบคำสั่ง #รวม.

ประการที่สอง อินสแตนซ์ของคลาสมอร์สถูกสร้างขึ้น เรียกว่า มอร์ส:

มอร์ส มอร์ส(13);

เมื่อดำเนินการบรรทัดนี้ (ก่อนดำเนินการฟังก์ชัน ติดตั้ง()) ตัวสร้างสำหรับคลาสมอร์สถูกเรียกและรับอาร์กิวเมนต์ที่กำหนดในตัวอย่าง (13)

ในกรณีนี้คือฟังก์ชัน ติดตั้ง()ไม่มีสิ่งใดเลยเพราะว่า การเรียกใช้ฟังก์ชัน pinMode() เกิดขึ้นภายในไลบรารี (เมื่อสร้างอินสแตนซ์ของคลาส)

ประการที่สาม สำหรับการเรียกใช้ฟังก์ชัน จุด()และ เส้นประ()ต้องเพิ่มคำนำหน้า มอร์ส- - ชื่อของอินสแตนซ์ที่ใช้ คลาสมอร์สสามารถมีได้หลายอินสแตนซ์ โดยแต่ละอินสแตนซ์มีหมายเลขพอร์ตของตัวเองจัดเก็บไว้ในตัวแปรท้องถิ่น _เข็มหมุด- การเรียกใช้ฟังก์ชันบนอินสแตนซ์เฉพาะจะกำหนดว่าจะใช้ตัวแปรใดในระหว่างการโทร รับสองบรรทัดต่อไปนี้:

มอร์ส มอร์ส(13); มอร์ส มอร์ส2(12);

ภายในการโทร morse2.dot(), ตัวแปร _เข็มหมุดจะมีค่าเป็น 12

ขออภัย การเน้นโค้ดอัตโนมัติใช้ไม่ได้กับไลบรารีปลั๊กอิน เพื่อให้แบ็คไลท์ทำงานได้คุณต้องสร้างไฟล์ชื่อ คีย์เวิร์ด.txt- ตัวอย่าง:

มอร์ส KEYWORD1 ขีดกลาง KEYWORD2 จุด KEYWORD2

ตรงข้ามแต่ละบรรทัดซึ่งคั่นด้วยแท็บคือคำสงวน และอีกครั้งที่คั่นด้วยแท็บคือประเภทของคำ ชั้นเรียนตรงกัน คำสงวน KEYWORD1 และสีส้ม ฟังก์ชั่นคือ KEYWORD2 และมีสีน้ำตาล หากต้องการจดจำคำศัพท์ คุณต้องรีสตาร์ทสภาพแวดล้อมการพัฒนา Arduino

ขอแนะนำให้แนบไลบรารีที่สร้างขึ้นพร้อมตัวอย่างการใช้งานเสมอ มีการสร้างโฟลเดอร์สำหรับสิ่งนี้ ตัวอย่างในไดเร็กทอรี มอร์ส- จากนั้นร่าง SOS ที่สร้างขึ้นก่อนหน้านี้จะถูกคัดลอกไปยังโฟลเดอร์นี้ (ไฟล์ภาพร่างสามารถดูได้จากเมนู ร่าง > ShowSketchFolder- หลังจากรีสตาร์ท Arduino ในเมนู ไฟล์ > Sketchbook > ตัวอย่างจะมีจุดหนึ่ง ห้องสมุด-มอร์สมีตัวอย่าง คุณควรเพิ่มความคิดเห็นเกี่ยวกับวิธีที่ดีที่สุดในการใช้ห้องสมุด