หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>โค้ดแหล่งที่มา AI
ดาวน์โหลด

i2cdevice

I2CDevice เป็นเฟรมเวิร์ก Python ที่มีจุดประสงค์เพื่อจัดการกับรูปแบบการโต้ตอบอุปกรณ์ SMBUS/I2C ทั่วไป

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

มันทำได้โดยการแยกคำอธิบายโดยละเอียดของการลงทะเบียนฮาร์ดแวร์และวิธีที่พวกเขาควรจะถูกจัดการเป็นภาษานิยามที่มีโครงสร้าง

โครงการนี้ไม่ได้มีจุดมุ่งหมายที่จะช่วยให้คุณสร้าง API สาธารณะสำหรับอุปกรณ์ Python- ที่ควรสร้างขึ้นบนพื้นฐานของพื้นฐานที่นำเสนอที่นี่

ใช้ไลบรารีนี้

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

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

คุณสมบัติ

  • ชั้นเรียนสำหรับการอธิบายอุปกรณ์การลงทะเบียนและฟิลด์บิตแต่ละตัวภายในการลงทะเบียนในรูปแบบที่แมปอย่างใกล้ชิดกับแผ่นข้อมูล
  • การแปลค่าจากหมายเลขโลกแห่งความเป็นจริง (เช่น 512ms ) เพื่อลงทะเบียนค่า (เช่น 0b111 ) และกลับมาอีกครั้ง
  • อ่านรีจิสเตอร์เป็นชื่อที่มีชื่อว่าโดยใช้ get
  • เขียนฟิลด์การลงทะเบียนหลายฟิลด์ในธุรกรรมโดยใช้ set พร้อมอาร์กิวเมนต์คำหลัก
  • สนับสนุนการรักษาหลายไบต์เป็นค่าเดียวหรือลงทะเบียนเดี่ยวที่มีหลายค่า

สร้างด้วย i2cdevice

  • bme280 - https://github.com/pimoroni/bme280-python
  • bmp280 - https://github.com/pimoroni/bmp280-python
  • bh1745 - https://github.com/pimoroni/bh1745-python
  • AS7262 - https://github.com/pimoroni/as7262-python
  • lsm303d - https://github.com/pimoroni/lsm303d-python
  • ltr559 - https://github.com/pimoroni/ltr559-python
  • ADS1015 - https://github.com/pimoroni/ads1015-python

ตัวอย่าง

ตัวอย่างด้านล่างกำหนด ALS_CONTROL register บน LTR559 พร้อมที่อยู่ลงทะเบียน 0x80

มันมี 3 ฟิลด์; Gain - ซึ่งแมปกับค่าโลกแห่งความเป็นจริง - และ SW_RESET/MODE ซึ่งเป็นธงบิตเดี่ยว 

 ALS_CONTROL = Register ( 'ALS_CONTROL' , 0x80 , fields = (
    BitField ( 'gain' , 0b00011100 , values_map = { 1 : 0b000 , 2 : 0b001 , 4 : 0b011 , 8 : 0b011 , 48 : 0b110 , 96 : 0b111 }),
    BitField ( 'sw_reset' , 0b00000010 ),
    BitField ( 'mode' , 0b00000001 )
))

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

ตัวอย่างด้านล่างใช้ i2cdevice._byte_swap เพื่อเปลี่ยน endianness ของค่า 16 บิตสองค่าก่อนที่พวกเขาจะถูกจัดเก็บ/เรียกคืน 

 # This will address 0x88, 0x89, 0x8A and 0x8B as a continuous 32bit register
ALS_DATA = Register ( 'ALS_DATA' , 0x88 , fields = (
    BitField ( 'ch1' , 0xFFFF0000 , bitwidth = 16 , values_in = _byte_swap , values_out = _byte_swap ),
    BitField ( 'ch0' , 0x0000FFFF , bitwidth = 16 , values_in = _byte_swap , values_out = _byte_swap )
), read_only = True , bitwidth = 32 )

"ลงทะเบียน" และ "Bitfield" กำหนดชุดของกฎและตรรกะสำหรับรายละเอียดเกี่ยวกับการลงทะเบียนฮาร์ดแวร์ซึ่งตีความโดยคลาสอุปกรณ์ การลงทะเบียนจะถูกประกาศบนอุปกรณ์โดยใช้ registers=() อาร์กิวเมนต์คำหลัก: 

 I2C_ADDR = 0x23
ltr559 = Device ( I2C_ADDR , bit_width = 8 , registers = (
	ALS_CONTROL ,
	ALS_DATA
))

การอ่านทะเบียน

หนึ่งที่กำหนดค่าฟิลด์ของการลงทะเบียนสามารถอ่านเป็น namedtuple โดยใช้วิธี get : 

 register_values = ltr559 . get ( 'ALS_CONTROL' )
gain = register_values . gain
sw_reset = register_values . sw_reset
mode = register_values . mode

การเขียนทะเบียน

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

 ltr559 . set ( 'ALS_CONTROL' ,
           gain = 4 ,
           sw_reset = 1 )

สิ่งนี้จะอ่านสถานะการลงทะเบียนจากอุปกรณ์อัปเดต BitFields ตามนั้นและเขียนผลลัพธ์กลับมา

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด