Raspberry Pi 5 โมดูลประมวลผล PMIC พิเศษ 4

โคโลฟอน

2020-2023 Raspberry Pi Ltd (เดิมชื่อ Raspberry Pi (Trading) Ltd.) เอกสารชุดนี้ได้รับอนุญาตภายใต้ใบอนุญาต Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)

• วันที่สร้าง: 2024-07-09
• รุ่นที่สร้าง: githash: 3d961bb-clean

ประกาศข้อจำกัดความรับผิดชอบทางกฎหมาย

ข้อมูลทางเทคนิคและความน่าเชื่อถือสำหรับผลิตภัณฑ์ RASPBERRY PI (รวมถึงแผ่นข้อมูล) ตามที่แก้ไขเป็นครั้งคราว (“ทรัพยากร”) จัดทำโดย RASPBERRY PI LTD (“RPL”) “ตามที่เป็น” และการรับประกันโดยชัดแจ้งหรือโดยนัยใดๆ รวมถึงแต่ไม่จำกัดเฉพาะการรับประกันโดยนัยของความสามารถในการขายและความเหมาะสมสำหรับจุดประสงค์เฉพาะนั้นจะถูกปฏิเสธ ในขอบเขตสูงสุดตามที่กฎหมายที่ใช้บังคับอนุญาต ในกรณีใดๆ RPL จะไม่รับผิดชอบต่อความเสียหายใดๆ อันเกิดขึ้นโดยตรงหรือโดยอ้อม ไม่ว่าจะเป็นโดยบังเอิญ พิเศษ เป็นตัวอย่าง หรือเป็นผลสืบเนื่อง (รวมถึงแต่ไม่จำกัดเพียง การจัดหาสินค้าหรือบริการทดแทน การสูญเสียการใช้งาน ข้อมูล หรือผลกำไร หรือการหยุดชะงักทางธุรกิจ) ไม่ว่าจะเกิดขึ้นอย่างไรก็ตาม และจากทฤษฎีความรับผิดใดๆ ไม่ว่าจะอยู่ในสัญญา ความรับผิดที่ร้ายแรง หรือการละเมิด (รวมทั้งการประมาทเลินเล่อหรืออื่นใด) ที่เกิดขึ้นจากการใช้ทรัพยากรไม่ว่าในรูปแบบใดๆ แม้ว่าจะได้รับการแจ้งเตือนเกี่ยวกับความเป็นไปได้ของความเสียหายดังกล่าวก็ตาม RPL ขอสงวนสิทธิ์ในการปรับปรุง พัฒนา แก้ไข หรือปรับเปลี่ยนทรัพยากรหรือผลิตภัณฑ์ใดๆ ที่อธิบายไว้ในทรัพยากรได้ตลอดเวลาโดยไม่ต้องแจ้งให้ทราบล่วงหน้า ทรัพยากรมีไว้สำหรับผู้ใช้ที่มีทักษะและมีความรู้ด้านการออกแบบในระดับที่เหมาะสม ผู้ใช้จะต้องรับผิดชอบแต่เพียงผู้เดียวในการเลือกและใช้ทรัพยากรและการนำผลิตภัณฑ์ที่อธิบายไว้ในทรัพยากรไปใช้ ผู้ใช้ตกลงที่จะชดเชยและถือว่า RPL ไม่มีส่วนรับผิดต่อความรับผิด ค่าใช้จ่าย ความเสียหาย หรือการสูญเสียอื่นๆ ที่เกิดจากการใช้ทรัพยากร RPL ให้สิทธิ์แก่ผู้ใช้ในการใช้ทรัพยากรร่วมกับผลิตภัณฑ์ Raspberry Pi เท่านั้น ห้ามใช้ทรัพยากรในลักษณะอื่นใด ไม่อนุญาตให้ใช้สิทธิ์ในทรัพย์สินทางปัญญาของ RPL หรือบุคคลที่สามอื่นๆ กิจกรรมที่มีความเสี่ยงสูง ผลิตภัณฑ์ Raspberry Pi ไม่ได้รับการออกแบบ ผลิต หรือตั้งใจให้ใช้งานในสภาพแวดล้อมอันตรายที่ต้องมีประสิทธิภาพการทำงานที่ปลอดภัยจากความล้มเหลว เช่น ในการดำเนินงานของโรงงานนิวเคลียร์ ระบบนำทางหรือการสื่อสารของเครื่องบิน การควบคุมการจราจรทางอากาศ ระบบอาวุธ หรือแอปพลิเคชันที่สำคัญต่อความปลอดภัย (รวมถึงระบบช่วยชีวิตและอุปกรณ์ทางการแพทย์อื่นๆ) ซึ่งความล้มเหลวของผลิตภัณฑ์อาจนำไปสู่การเสียชีวิต การบาดเจ็บส่วนบุคคล หรือความเสียหายทางกายภาพหรือสิ่งแวดล้อมที่รุนแรง ("กิจกรรมเสี่ยงสูง") RPL ปฏิเสธการรับประกันโดยชัดแจ้งหรือโดยนัยใดๆ ว่าเหมาะสมสำหรับกิจกรรมเสี่ยงสูง และไม่รับผิดชอบต่อการใช้หรือรวมผลิตภัณฑ์ Raspberry Pi ไว้ในกิจกรรมเสี่ยงสูง ผลิตภัณฑ์ Raspberry Pi จัดทำขึ้นภายใต้ข้อกำหนดมาตรฐานของ RPL การที่ RPL จัดเตรียมทรัพยากรจะไม่ขยายหรือแก้ไขข้อกำหนดมาตรฐานของ RPL ในทางอื่นใด ซึ่งรวมถึงแต่ไม่จำกัดเฉพาะการปฏิเสธความรับผิดชอบและการรับประกันที่แสดงไว้ในข้อกำหนดเหล่านี้

ประวัติเวอร์ชันเอกสาร

ปล่อย	วันที่	คำอธิบาย
1.0	16 ธ.ค. 2022	• การเปิดตัวครั้งแรก
1.1	7 ก.ค. 2024	• แก้ไขการพิมพ์ผิดในคำสั่ง vcgencmd เพิ่ม Raspberry Pi 5. รายละเอียด

ขอบเขตของเอกสาร

เอกสารนี้ใช้กับผลิตภัณฑ์ Raspberry Pi ต่อไปนี้:

พายซีโร่

พาย 1

พาย 2

พาย 3

พาย 4

พาย 5

Pi 400

CM1

CM3

CM4

ปิโก้

ศูนย์

W

H

A

B

A+

B+

A

B

B

A+

B+

ทั้งหมด

ทั้งหมด

ทั้งหมด

ทั้งหมด

ทั้งหมด

ทั้งหมด

ทั้งหมด

*

*

*

*

การแนะนำ

อุปกรณ์ Raspberry Pi 4/5 และ Raspberry Pi Compute Module 4 ใช้วงจรรวมการจัดการพลังงาน (PMIC) เพื่อจ่ายพลังงานต่างๆtagเป็นสิ่งที่ส่วนประกอบต่างๆ บน PCB ต้องการ นอกจากนี้ พวกมันยังจัดลำดับพลังงานเพื่อให้แน่ใจว่าอุปกรณ์เริ่มทำงานตามลำดับที่ถูกต้อง ตลอดระยะเวลาการผลิตโมเดลเหล่านี้ มีการใช้อุปกรณ์ PMIC ที่แตกต่างกันหลายตัว PMICS ทั้งหมดให้ฟังก์ชันพิเศษที่เหนือกว่าของ voltagอุปทาน:

• ช่อง ADC สองช่องที่สามารถใช้งานบน CM4 ได้
• ในรุ่นแก้ไขหลังของ Raspberry Pi 4 และ Raspberry Pi 400 และ Raspberry Pi 5 ทุกรุ่น ADC จะเชื่อมต่อกับขั้วต่อไฟ USB-C บน CC1 และ CC2
• เซ็นเซอร์บนชิปที่ใช้ตรวจสอบอุณหภูมิของ PMIC ได้ ซึ่งมีจำหน่ายบน Raspberry Pi 4 และ 5 และ CM4

เอกสารนี้จะอธิบายวิธีการเข้าถึงฟีเจอร์ต่างๆ เหล่านี้ในซอฟต์แวร์

คำเตือน

ไม่มีการรับประกันว่าฟังก์ชันการทำงานนี้จะยังคงอยู่ใน PMIC เวอร์ชันต่อๆ ไป ดังนั้นควรใช้ด้วยความระมัดระวัง

คุณอาจต้องการอ้างอิงเอกสารต่อไปนี้ด้วย:

• แผ่นข้อมูล Raspberry Pi CM4: https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
• แผนผัง Raspberry Pi 4 ที่ลดลง: https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf

เอกสารนี้ถือว่า Raspberry Pi กำลังรันระบบปฏิบัติการ Raspberry Pi และได้รับการอัปเดตด้วยเฟิร์มแวร์และเคอร์เนลรุ่นล่าสุดแล้ว

การใช้คุณสมบัติ

เดิมทีฟีเจอร์เหล่านี้สามารถใช้งานได้โดยการอ่านรีจิสเตอร์บน PMIC โดยตรงเท่านั้น อย่างไรก็ตาม ที่อยู่ของรีจิสเตอร์จะแตกต่างกันไปขึ้นอยู่กับ PMIC ที่ใช้ (และขึ้นอยู่กับการแก้ไขบอร์ดด้วย) ดังนั้น Raspberry Pi Ltd จึงได้จัดเตรียมวิธีการรับข้อมูลนี้โดยไม่คำนึงถึงการแก้ไข โดยใช้เครื่องมือบรรทัดคำสั่ง vcgencmd ซึ่งเป็นโปรแกรมที่อนุญาตให้แอปพลิเคชันในพื้นที่ของผู้ใช้เข้าถึงข้อมูลที่จัดเก็บหรือเข้าถึงได้จากเฟิร์มแวร์ของอุปกรณ์ Raspberry Pi Ltd

คำสั่ง vcgencmd ที่ใช้ได้มีดังนี้:

สั่งการ	คำอธิบาย
vcgencmd วัดโวลต์ usb_pd	วัดปริมาตรtage บนพินที่ทำเครื่องหมาย usb_pd (ดูแผนผัง CM4 IO) CM4 เท่านั้น
vcgencmd วัดโวลต์ ain1	วัดปริมาตรtage บนพินที่มีเครื่องหมาย ain1 (ดูแผนผัง CM 4 IO) CM4 เท่านั้น
vcgencmd วัดอุณหภูมิ pmic	วัดอุณหภูมิของ PMIC die CM4 และ Raspberry Pi 4 และ 5

คำสั่งทั้งหมดเหล่านี้เรียกใช้จากบรรทัดคำสั่งของ Linux

การใช้คุณสมบัติจากโค้ดโปรแกรม

คุณสามารถใช้คำสั่ง vcgencmd เหล่านี้ในการเขียนโปรแกรมได้หากคุณต้องการข้อมูลภายในแอปพลิเคชัน ในทั้ง Python และ C สามารถใช้การเรียก OS เพื่อเรียกใช้คำสั่งและส่งกลับผลลัพธ์เป็นสตริง นี่คือตัวอย่างบางส่วนampรหัส Python ที่ใช้เรียกคำสั่ง vcgencmd ได้:

โค้ดนี้ใช้โมดูลย่อย Python เพื่อเรียกใช้คำสั่ง vcgencmd และส่งคำสั่ง measure_temp ที่กำหนดเป้าหมายไปที่ pmic ซึ่งจะวัดอุณหภูมิของไดย์ PMIC ผลลัพธ์ของคำสั่งจะถูกพิมพ์ไปยังคอนโซล

นี่คืออดีตที่คล้ายกันample ใน C:

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

บันทึก

การแยกโค้ดเหล่านี้มีให้เฉพาะในกรณีพิเศษเท่านั้นampและคุณอาจต้องปรับเปลี่ยนให้เหมาะกับความต้องการเฉพาะของคุณ เช่นampคุณอาจต้องการแยกวิเคราะห์เอาต์พุตของคำสั่ง vcgencmd เพื่อแยกค่าอุณหภูมิสำหรับใช้งานในภายหลัง

คำถามที่พบบ่อย

• ถาม: ฉันสามารถใช้คุณลักษณะเหล่านี้บน Raspberry Pi ทุกรุ่นได้หรือไม่
  • ตอบ ไม่ คุณลักษณะเหล่านี้มีให้ใช้งานสำหรับอุปกรณ์ Raspberry Pi 4, Raspberry Pi 5 และ Compute Module 4 โดยเฉพาะ
• ถาม: การใช้ฟีเจอร์เหล่านี้ในอนาคตจะปลอดภัยหรือไม่?
  • ตอบ: ไม่มีการรับประกันว่าฟังก์ชันการทำงานนี้จะยังคงอยู่ต่อไปในเวอร์ชัน PMIC ในอนาคต ดังนั้นควรใช้ความระมัดระวังเมื่อใช้ฟีเจอร์เหล่านี้

เอกสาร / แหล่งข้อมูล

Raspberry Pi Raspberry Pi 5 โมดูลประมวลผล PMIC พิเศษ 4 [พีดีเอฟ] คู่มือการใช้งาน Raspberry Pi 4, Raspberry Pi 5, โมดูลประมวลผล 4, Raspberry Pi 5 โมดูลประมวลผล PMIC พิเศษ 4, Raspberry Pi 5, โมดูลประมวลผล PMIC พิเศษ 4, โมดูลประมวลผล 4

อ้างอิง

• คู่มือการใช้งาน