Home » فروشگاه » ماژول سنسور نور محیط GebraBit TSL25721FN

ماژول سنسور نور محیط GebraBit TSL25721FN

3.890.000 ریال

نوع ماژول

ماژول نور محیطی

ولتاژ تغذیه

3V3

نوع خروجی

I2C, Digital

محدوده طول موج

~400 to ~1100 nm

جریان مصرفی

10 mA to 30 mA (Typ. 20 mA)

پیک طول موج

~700 nm, ~840 nm

ابعاد

Gebra small(36.29mm x 32.72mm)

بهره

120X, 16X, 1X, 8X

دمای کاری

-30 to 70 °C

سنسور نور محیط

امروزه سنسورهای نور محیط جزئی از گوشی های هوشمند، نوت بوک ها، سایر دستگاه های تلفن همراه، نمایشگرهای خودرو و تلویزیون های LCD هستند. از این سنسورها  برای تشخیص میزان نور موجود در محیط استفاده می شود ، همچنین در دستگاه هایی مثل گوشی های هوشمند و نوت بوک ها، از این سنسورها برای تنظیم اتومات نور صفحه‌ی نمایشگر، باتوجه به نور محیط، استفاده میشود، در نتیجه هم در مصرف انرژی صرفه جویی میشود و هم طول عمر دستگاه افزایش میابد.

به طور کلی سه نوع متداول سنسور نور محیط وجود دارد: ترانزیستورهای نوری، فوتودیودها، و ICهای فوتونی که از ترکیب یک فوتو دیتکتور (photodetector) و یک تقویت کننده تشکیل شده اند.

مروری بر TSL25721FN

سنسور TSL2572 سنسور نور محیطی (ALS) است که در شرایط نوری مختلف، واکنشی شبیه به چشم انسان دارد.

حساسیت بالا و اندازه‌گیری‌های دقیق ALS حاصل به کارگیری تکنولوژی دو دیودی AMS و فیلتر UV میباشد. علاوه بر این، زمانی که از حالت کم مصرف سنسور استفاده می‌شود، محدوده عملکرد تا 60000 لوکس در نور خورشید افزایش می‌یابد.

مشخصات فنی

کاربردها

  • Output Type: Digital-I2C
  • Wavelength Range: ~400 to ~1100 nm
  • Resolution: 16-Bit
  • Display Backlight Control
  • Keyboard Illumination Control
  • Solid State Lighting Control for Daylight Harvesting
  • Printer Paper Detection

ماژول GebraBit TSL25721FN

GebraBit TSL2572 یک ماژول حسگر نور محیط(ASL)  بوده که با تغذیه 3.3 ولت قابل راه اندازی است.

 GebraBit TSL25721FN با پروتکل I2C ارتباط برقرار کرده و دارای یک LED  اختصاصی برای پین وقفه میباشد.

با توجه به دشواری دستسرسی به پین های سنسور، کاربران برای توسعه سخت افزاری و البته توسعه نرم افزاری سنسور،نیاز به یک مدار راه انداز و درایور دارند.GebraBit برای راحتی کاربران این امر را با پیاده سازی مدار سنسور TSL25721FN و ارایه دسترسی به پین های آن، محق ساخته است.

 برای راه اندازی این ماژول کافیست ماژول GebraBit TSL25721FN را در BreadBoard قرار داده سپس با اعمال ولتاژ ، ماژول  GebraBit TSL25721FN را با هریک از برد های اردوینو، رزبری پای ، دیسکاوری و مخصوصا ماژول GebraBit STM32F303 یا GebraBit ATMEGA32  که پیشنهاد ما استفاده از ماژول های توسعه میکروکنترلری GebraBit هست،راه اندازی و دیتا را دریافت کنید.

دلیل پیشنهاد ما در راه اندازی ماژول GebraBit TSL25721FN با ماژول های توسعه میکروکنترلری GebraBit مانند GebraBit STM32F303 یا GebraBit ATMEGA32  ،وجود رگولاتور داخلی 3V3 در آنها و  سازگاری ترتیب پین های همه ماژول های GebraBit  با هم بوده(استاندارد GEBRABUS) که فقط کافیست ماژول  GebraBit TSL25721FN را مانند تصویر بالا در سوکت مربوطه قرار داده و بدون نیاز به سیم کشی ،ماژول سنسور مورد نظر را توسعه دهید.

ویژگی‌های ماژول GebraBit TSL25721FN

  • On Board, ON/OFF LED indicator
  • I2C interface for reading data and configuring the sensor
  • GEBRABIT Pin Compatible with GEBRABUS
  • LED indicator for Dedicated Interrupt Pin
  • It can be used as a daughter board of GEBRABIT MCU Modules
  • Featuring Castellated pad (Assembled as SMD Part)
  • Separatable screw parts to reduce the size of the board

معرفی بخش های ماژول

سنسور TSL25721FN

سنسور TSL25721FN ، سنسور نورمحیط این ماژول بوده که در مرکز ماژول قرار گرفته و مدار آن طراحی شده است.

LED وقفه

یکLED  اختصاصی  برای پین وقفه روی ماژول در نظر گرفته شده است که با تغییر وضعیت وقفه با توجه به دیتاشیت سنسور، وضعیت LED نیز تغییر میکند.

LED تغذیه

با اعمال ولتاژ به ماژول توسط پین مربوطه ، این LED روشن میشود.

پین‌های ماژول GebraBit TSL25721FN

پین های تغذیه

  • 3V3: این پین ،تغذیه اصلی سنسور و سطح منطق(Logic Level) ارتباط دییجیتال(I2C ) سنسور را تامین کند.
  • GND : این پین زمین مشترک برای تغذیه و سطح منطق(Logic Level) سنسور می باشد.

پین‌های I2C

  • SDA : این پین، پین دیتای ارتباط I2C می باشد، که به پین دیتای متناظر در میکروکنترلر(پردازنده) ، متصل می شود.
  • SCL : این پین، پین کلاک ارتباط I2C می باشد، که به پین کلاک متناظر در میکروکنترلر(پردازنده) ، متصل می شود.

پین وقفه

  • INT: پین Interrupt (وقفه) سنسور TSL25721FN بوده که با توجه به دیتاشیت سنسور، کاربر می تواند شرایط وقوع وقفه،حالات و روش های وقوع وقفه و … را تنظیم کند.

اتصال به پردازنده

اتصال I2C با GebraBit STM32F303

برای اتصال I2C ماژول TSL25721FN GebraBit به ماژول میکروکنترلرGebraBit STM32F303 بعد از تعریف کردن SDA و SCL رو پین های PB9 و PB8 (برای راحتی کار در STMCUBEMX)مراحل زیر را دنبال کنید:

  • پین “3V3” ماژول TSL25721FN را به پین “3V3” خروجی ماژول میکروکنترلر متصل کنید.(سیم قرمز)
  • پین “GND” ماژول TSL25721FN را به پین “GND” ماژول میکروکنترلر متصل کنید.(سیم سیاه)
  • پین “SCL” ماژول TSL25721FN را به پین PB8 ماژول میکروکنترلر (SCL) متصل کنید.(سیم آبی)
  • پین “SDA” ماژول TSL25721FN را به پین PB9 ماژول میکروکنترلر (SDA) متصل کنید.(سیم زرد)

نحوه اتصال موارد ذکر شده در بالا،در این تصویر مشاهده می شود:

توجه: با توجه به اینکه پین PA14 ماژول میکروکنترلرGebraBit STM32F303 برای پروگرام کردن میکروکنترلر استفاده میشود،تنظیم I2C بر روی پین های PA14 و PA15 در این ورژن مقدور نمی باشد،لذا در اتصال I2C به ماژول میکروکنترلرGebraBit STM32F303 در این ورژن ، ماژول  GebraBit TSL25721FN نمی تواند به صورت Pin to Pin بر روی آن قرار گیرد.

اتصال I2C با GebraBit ATMEGA32A

با توجه به اینکه پین های I2C میکروکنترلر ATMEGA32A بر اساس استاندارد GEBRABUS متناظر با پین های I2C  دیگر ماژول های GEBRABIT می باشد،  ماژول GebraBit TSL25721FN را به صورت Pin to Pin بر روی ماژول GebraBit ATMEGA32A قرار داده و به راحتی با ماژول GebraBit TSL25721FN از طریق I2C ارتباط برقرار کنید:

در اینجا برای درک بهتر، اتصال جداگانه‌ی این دو ماژول نمایش داده شده است.

اتصالI2C با ARDUINO UNO

برای اتصال I2C ماژول GebraBit TSL25721FN به ARDUINO UNO مراحل زیر را دنبال کنید:

  • پین “3V3” ماژول GebraBit TSL25721FN را به پین “3V3” خروجی برد ARDUINO UNO متصل کنید.(سیم قرمز)
  • پین “GND” ماژول GebraBit TSL25721FN را به پین “GND” برد ARDUINO UNO متصل کنید.(سیم سیاه)
  • پین “SCL” ماژول GebraBit TSL25721FN را به پین A5 برد  ARDUINO UNO( (SCLمتصل کنید.(سیم آبی)
  • پین “SDA” ماژول GebraBit TSL25721FN را به پین A4 برد ARDUINO UNO( (SDAمتصل کنید.(سیم نارنجی)

نحوه اتصال موارد ذکر شده در بالا،در این تصویر مشاهده می شود:

نوع ماژول

ماژول نور محیطی

ولتاژ تغذیه

3V3

نوع خروجی

I2C, Digital

محدوده طول موج

~400 to ~1100 nm

جریان مصرفی

10 mA to 30 mA (Typ. 20 mA)

پیک طول موج

~700 nm, ~840 nm

ابعاد

Gebra small(36.29mm x 32.72mm)

بهره

120X, 16X, 1X, 8X

دمای کاری

-30 to 70 °C

هدف این پروژه چیست؟

هدف این پروژه، واسط کردن سنسور نور محیطی TSL2572 با Arduino برای اندازه‌گیری و پایش شدت نور در محیط‌های مختلف است. این سنسور می‌تواند سطح نور محیط را تشخیص دهد و مقادیر دقیق لکس را ارائه دهد که آن را برای کاربردهایی مانند کنترل خودکار روشنایی، تنظیم روشنایی صفحه نمایش و پایش محیطی ایده‌آل می‌کند. کاربران می‌توانند با خواندن لحظه‌ای سطح نور، سیستم‌هایی طراحی کنند که به تغییرات شرایط نوری واکنش نشان داده و بهره‌وری انرژی و کاربردپذیری را افزایش دهند.


در این آموزش چه چیزهایی خواهید آموخت؟

  • اتصال سنسور TSL2572 به Arduino و برقراری ارتباط I2C
  • استفاده از یک کتابخانه موجود برای یکپارچه‌سازی بدون نقص و افزایش درک پردازش داده‌های I2C
  • خواندن سطوح نور محیط به واحد لوکس با استفاده از TSL2572 و تفسیر داده‌ها برای کاربردهای عملی
  • پیاده‌سازی پروژه‌های مبتنی بر سنسور برای کنترل خودکار روشنایی و پایش محیطی و کسب مهارت‌های عملی در ایجاد سیستم‌های حساس به شدت نور

این راهنمای عملی، اطلاعات ارزشمندی درباره یکپارچه‌سازی سنسور با Arduino و پایش داده‌های لحظه‌ای ارائه می‌دهد.

برای شروع این پروژه به چه چیزهایی نیاز داریم؟

برای اجرای این پروژه به سخت‌افزار و نرم‌افزار نیاز داریم. عناوین این سخت‌افزارها و نرم‌افزارها در جدول زیر به شما ارائه شده است و می‌توانید با کلیک بر روی هر یک، آن را تهیه/دانلود کرده و برای شروع آماده شوید.

سخت افزارهای مورد نیازنرمافزارهای مورد نیاز
Arduino ProgrammerArduino IDE
Arduino Development Board- ( Arduino UNO )
ماژول سنسور نور محیط GebraBit TSL25721FN

GebraMS برای راحتی شما، کتابخانه‌های ویژه‌ای را برای اکثر پروژه‌های آردوینو آماده کرده است.
شما باید کتابخانه آماده شده توسط GebraMS را دانلود کرده و آن را به Arduino IDE خود اضافه کنید.

ابتدا، همان‌طور که در تصویر زیر نشان داده شده است، ماژول Gebra TSL2572 را به این شکل به Arduino UNO متصل می‌کنیم:

سپس کتابخانه GebraBit TSL2572 را دانلود کرده و به Arduino IDE خود اضافه کنید.

سورس کد

کتابخانه پروژه (Library)

جبرابیت علاوه بر طراحی ماژولار انواع حسگرها و قطعات مجتمع، برای سهولت در نصب و توسعه نرم‌افزار توسط کاربران، مجموعه‌ای از کتابخانه‌های ساختاریافته و مستقل از سخت‌افزار را به زبان C ارائه می‌دهد. در این راستا، کاربران می‌توانند کتابخانه‌ی مربوط به ماژول مورد نظر خود را در قالب فایل‌های “.h” و “.c” دانلود کنند.

با افزودن کتابخانه‌ی ارائه‌شده توسط جبرابیت به پروژه (راهنمای افزودن فایل به پروژه)، می‌توانیم به‌راحتی کد خود را توسعه دهیم. فایل‌های مربوطه را می‌توانید در انتهای پروژه یا در بخش صفحات مرتبط در سمت راست مشاهده کنید.

تمام توابع تعریف‌شده در کتابخانه با جزئیات کامل توضیح داده شده‌اند و کلیه پارامترهای ورودی و مقادیر بازگشتی هر تابع به‌صورت مختصر شرح داده شده است. از آنجا که این کتابخانه‌ها مستقل از سخت‌افزار هستند، کاربر می‌تواند آن‌ها را به‌سادگی به کامپایلر دلخواه خود اضافه کرده و با میکروکنترلر یا برد توسعه مورد نظر خود استفاده کند.

USER REGISTER MAP

نقشه رجیستر یا دستورات سنسور در این بخش تعریف شده‌اند:

C
/************************************************
 *              USER REGISTER MAP               *
 ***********************************************/
#define TSL25721_ADDRESS               0x39
#define TSL25721_ENABLE                0x00
#define TSL25721_ATIME                 0x01
#define TSL25721_WTIME                 0x03
#define TSL25721_AILTL                 0x04
#define TSL25721_AILTH                 0x05
#define TSL25721_AIHTL                 0x06
#define TSL25721_AIHTH                 0x07
#define TSL25721_PERS                  0x0C
#define TSL25721_CONFIG                0x0D
#define TSL25721_CONTROL               0x0F
#define TSL25721_ID                    0x12
#define TSL25721_STATUS                0x13
#define TSL25721_C0DATA                0x14
#define TSL25721_C0DATAH               0x15
#define TSL25721_C1DATA                0x16
#define TSL25721_C1DATAH               0x17
#define TSL25721_ALS_INTERRUPT_CLEAR   0xE6
#define GLASS_ATTENUATION              1.0f  // 1 because in open air
/*----------------------------------------------*
 *           USER REGISTER MAP End              *
 *----------------------------------------------*/

TSL25721_Ability Enum

این enum برای فعال و غیرفعال کردن بخش‌های مختلف سنسور استفاده می‌شود:

C
typedef enum ALS_Mode
{
	STANDBY = 0 ,
	ACTIVE
}LTR303ALS_ALS_Mode;

TSL25721_Reset_Status Enum

با استفاده از این enum، وضعیت ریست سنسور تعیین می‌شود:

C
typedef enum
{
	FAILED = 0 ,
	DONE
}TSL25721 _Reset_Status;

TSL25721_ALS_Mode Enum

با استفاده از این enum، حالت کاری سنسور انتخاب می‌شود:

C
 typedef enum ALS_Mode
 {
 	STANDBY = 0 ,
 	ACTIVE
 }TSL25721_ALS_Mode;

TSL25721_ALS_Gain Enum

مقادیر این enum برای تنظیم گین (gain) سنسور استفاده می‌شوند:

C
 typedef enum ALS_Gain
 {
   ALS_GAIN_1X   = 0 ,
   ALS_GAIN_8X   = 1 ,
   ALS_GAIN_16X  = 2 ,
   ALS_GAIN_120X = 3
 } TSL25721_ALS_Gain;

TSL25721_ Integration_Time Enum

مقادیر این enum برای انتخاب زمان ادغام داده‌های سنسور (Integration time) استفاده می‌شوند:

C
 typedef enum Integration_Time
 {
   _2P73_mS_INTEGRATION_TIME = 0xFF ,
   _27P3_mS_INTEGRATION_TIME = 0xF6 ,
   _101_mS_INTEGRATION_TIME  = 0xDB ,
   _175_mS_INTEGRATION_TIME  = 0xC0 ,
   _699_mS_INTEGRATION_TIME  = 0x00
 } TSL25721_Integration_Time;

TSL25721_ Measurement_Rate Enum

میزان نرخ نمونه‌برداری داده‌های سنسور توسط مقادیر این enum تعیین می‌شود:

C
 typedef enum Measurement_Rate
  {
    ALS_MEASRATE_50_mS  ,
    ALS_MEASRATE_100_mS ,
    ALS_MEASRATE_200_mS ,
    ALS_MEASRATE_500_mS ,
    ALS_MEASRATE_1000_mS,
    ALS_MEASRATE_2000_mS,
 } TSL25721 _Measurement_Rate;

TSL25721_ Data_Status Enum

مقادیر این enum تعیین می‌کنند که داده‌های خوانده‌شده، مقادیر جدید هستند یا قدیمی:

C
typedef enum Data_Status
{
	OLD_DATA = 0 ,
	NEW_DATA
}TSL25721 _Data_Status;

TSL25721_ Interrupt_Status Enum

مقادیر این enum برای اطلاع‌رسانی درباره وقفه (interrupt) در سنسور استفاده می‌شوند:

C
 typedef enum Interrupt_Status
 {
 	INTERRUPT_INACTIVE = 0 ,
 	INTERRUPT_ACTIVE
 }TSL25721_Interrupt_Status;

TSL25721_Data_Valid Enum

درستی داده‌های سنسور با استفاده از مقادیر این enum تعیین می‌شود:

C
 typedef enum Data_Valid
 {
 	DATA_IS_INVALID = 0 ,
 	DATA_IS_VALID
 }TSL25721_Data_Valid;

TSL25721_Interrupt_Persist Enum

با استفاده از این enum تعیین می‌شود که پس از چند بار تکرار یک حالت، وقفه (interrupt) باید رخ دهد:

C
 typedef enum Interrupt_Persist
  {
      EVERY_ALS_CYCLE,
      CONSECUTIVE_1_ALS_VALUE_OUT_OF_THR_RANGE,
      CONSECUTIVE_2_ALS_VALUE_OUT_OF_THR_RANGE,
      CONSECUTIVE_3_ALS_VALUE_OUT_OF_THR_RANGE,
      CONSECUTIVE_5_ALS_VALUE_OUT_OF_THR_RANGE,
      CONSECUTIVE_10_ALS_VALUE_OUT_OF_THR_RANGE,
  	CONSECUTIVE_15_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_20_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_25_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_30_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_35_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_40_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_45_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_50_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_55_ALS_VALUE_OUT_OF_THR_RANGE,
 	CONSECUTIVE_60_ALS_VALUE_OUT_OF_THR_RANGE,
 } TSL25721_Interrupt_Persistence;

TSL25721 struct

تمام خصوصیات سنسور، ضرایب کالیبراسیون و داده‌های سنسور در این «struct» تعریف شده‌اند و همه اطلاعات و تنظیمات اعمال‌شده روی سنسور در این «structure» ذخیره می‌شوند و می‌توانید تغییرات هر بخش از سنسور را در محیط «Debug Session» مشاهده کنید.

C
 typedef	struct TSL25721
  {
  	  uint8_t                         Register_Cache;
  	  uint8_t			              PART_ID;
  	  TSL25721_Ability 				  ALS;
  	  TSL25721_Ability                OSCILLATOR;
  	  TSL25721_Ability 				  WAIT_TIMER;
  	  TSL25721_Ability	              WAIT_LONG_12X;
  	  float				              WAIT_TIME_mS;
 	  uint8_t						  WAIT_TIME;
 	  float				              WAIT_TIME_STEP;
 	  TSL25721_Ability                INTERRUPT;
 	  TSL25721_Ability			      SLEEP_AFTER_INTERRUPT;
 	  float							  INTEGRATION_TIME_mS;
 	  uint8_t						  INTEGRATION_TIME;
 	  float				              INTEGRATION_TIME_STEP;
 	  TSL25721_Ability                ALS_GAIN_0P16_SCALE;
 	  TSL25721_ALS_Gain               ALS_GAIN;
 	  float		 					  ALS_GAIN_VALUE;
 	  uint8_t			              STATUS_VALUE;
       TSL25721_Interrupt_Status		  INTERRRUPT_STATUS;
       TSL25721_Data_Valid             DATA;
       TSL25721_Interrupt_Persistence  INTERRUPT_PERSISTENCE;
 	  uint16_t                        INTERRUPT_LOW_THRESHOLD;
 	  uint16_t                        INTERRUPT_HIGH_THRESHOLD;
 	  uint8_t 						  ADC_DATA[ADC_DATA_BUFFER_SIZE];
 	  uint16_t                        ALS_DATA_CH0;//Reference to uint16_t where visible+IR data will be stored
 	  uint16_t               		  ALS_DATA_CH1;//Reference to uint16_t where IR-only data will be stored
 	  float      					  COUNTER_PER_LUX;
 	  double 			              ALS_LUX;
 }GebraBit_TSL25721;

Declaration of functions

در انتهای این فایل، تمام توابع مربوط به خواندن و نوشتن در رجیسترهای TSL25721، پیکربندی سنسور و دریافت داده‌ها از سنسور اعلام شده‌اند:

C
 extern void GB_TSL25721_Read_Reg_Data(uint8_t regAddr,  uint8_t *data)	;
  extern void GB_TSL25721_Burst_Read(uint8_t regAddr,  uint8_t *data, uint16_t byteQuantity);
  extern void GB_TSL25721_Read_Reg_Bits (uint8_t regAddr, uint8_t start_bit, uint8_t len, uint8_t* data);
  extern void GB_TSL25721_Write_Command( uint8_t cmd);
  extern void GB_TSL25721_Write_Reg_Data(uint8_t regAddr,  uint8_t data)	;
  extern void GB_TSL25721_Burst_Write(uint8_t regAddr,  uint8_t *data, uint16_t byteQuantity)								;
  extern void GB_TSL25721_Write_Reg_Bits(uint8_t regAddr, uint8_t start_bit, uint8_t len, uint8_t data);
  /********************************************************
   *       Declare TSL25721 Configuration Functions         *
  ********************************************************/
 extern void GB_TSL25721_Internal_Oscillator ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability osc )  ;
 extern void GB_TSL25721_ALS ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability als )  ;
 extern void GB_TSL25721_Interrupt ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability intr )  ;
 extern void GB_TSL25721_Clear_Interrupt ( GebraBit_TSL25721 * TSL25721 )  ;
 extern void GB_TSL25721_Sleep_After_Interrupt ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability intafs )  ;
 extern void GB_TSL25721_Wait_Timer ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability timer ) ;
 extern void GB_TSL25721_Integration_Time  (GebraBit_TSL25721 * TSL25721 ,float time ) ;
 extern void GB_TSL25721_Wait_Long_12x ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability wlong )  ;
 extern void GB_TSL25721_Check_Wait_Long_12x ( GebraBit_TSL25721 * TSL25721  )   ;
 extern void GB_TSL25721_Set_Wait_Time ( GebraBit_TSL25721 * TSL25721 , float wait  );
 extern void GB_TSL25721_ALS_Gain_0p16_Scale ( GebraBit_TSL25721 * TSL25721 , TSL25721_Ability scale )  ;
 extern void GB_TSL25721_Check_ALS_Gain_0p16_Scale( GebraBit_TSL25721 * TSL25721  ) ;
 extern void GB_TSL25721_ALS_Gain ( GebraBit_TSL25721 * TSL25721 , TSL25721_ALS_Gain gain );
 extern void GB_TSL25721_Read_Part_ID ( GebraBit_TSL25721 * TSL25721  );
 extern void GB_TSL25721_Read_STATUS ( GebraBit_TSL25721 * TSL25721 ) ;
 extern void GB_TSL25721_Interrupt_Persistence ( GebraBit_TSL25721 * TSL25721 , TSL25721_Interrupt_Persistence persist ) ;
 extern void GB_TSL25721_Interrupt_Upper_Limitation ( GebraBit_TSL25721 * TSL25721 , uint16_t limit );
 extern void GB_TSL25721_Interrupt_Lower_Limitation ( GebraBit_TSL25721 * TSL25721 , uint16_t limit )  ;
 extern void GB_TSL25721_initialize( GebraBit_TSL25721 * TSL25721 )  ;
 extern void GB_TSL25721_Configuration(GebraBit_TSL25721 * TSL25721)  ;
 extern void GB_TSL25721_Read_CH0_CH1_Raw_Data(GebraBit_TSL25721 * TSL25721);
 extern void GB_TSL25721_Lux_Reading(GebraBit_TSL25721 * TSL25721);
 extern void GB_TSL25721_Get_Data(GebraBit_TSL25721 * TSL25721);

فایل منبع Gebra_TSL25721.c

این فایل که به زبان C نوشته شده است، تمامی توابع را با جزئیات کامل کامنت‌گذاری کرده و پارامترهای ورودی و مقادیر بازگشتی توابع را به‌وضوح توضیح داده است. بنابراین، ما فقط به این توضیحات اکتفا کرده و کاربران را برای کسب اطلاعات بیشتر مستقیماً به این فایل ارجاع می‌دهیم.


برنامه نمونه در Arduino

پس از اتصال ماژول به Arduino و افزودن کتابخانه به IDE، به مسیر زیر بروید:
File > Examples > GebraBit_TSL2572 > Luminosity


توضیح فایل نمونه

enumها و توابع مورد نیاز ماژول Gebra TSL25721 به ساختارها اضافه شده‌اند. در بخش بعدی، یک متغیر به نام TSL25721_Module از نوع ساختار Gebra_TSL25721 (که در هدر Gebra_TSL25721 تعریف شده و در بخش توضیحات کتابخانه شرح داده شده است) برای پیکربندی ماژول Gebra TSL25721 تعریف شده است:

C
GebraBit_TSL25721 TSL25721;

در بخش بعدی کد نوشته شده، با استفاده از توابع
GB_TSL25721_initialize(&TSL25721_Module)
و
GB_TSL25721_Configuration(&TSL25721_Module)
ماژول Gebra TSL25721 را پیکربندی می‌کنیم و در نهایت در بخش حلقه while برنامه، داده‌ها از سنسور خوانده شده و مقادیر ALS و CLEAR به‌طور مداوم دریافت می‌شوند:

C
void setup() {
    Wire.begin();           // Initialize the I2C bus
    Serial.begin(9600);     // Initialize serial communication for debugging

    GB_TSL25721_initialize(&TSL25721); // Initialize the TSL25721 sensor
    GB_TSL25721_Configuration(&TSL25721); // Configure the TSL25721 sensor
}

void loop() {
    GB_TSL25721_Get_Data(&TSL25721); // Read data from the sensor

    Serial.print("luminosity: ");
    Serial.print(TSL25721.ALS_LUX);
    Serial.println(" lx");

    delay(2000); // Delay between readings
}

The Sample file code text:

C
#include "GebraBit_TSL25721.h"

GebraBit_TSL25721 TSL25721;

void setup() {
    Wire.begin();           // Initialize the I2C bus
    Serial.begin(9600);     // Initialize serial communication for debugging

    GB_TSL25721_initialize(&TSL25721); // Initialize the TSL25721 sensor
    GB_TSL25721_Configuration(&TSL25721); // Configure the TSL25721 sensor
}

void loop() {
    GB_TSL25721_Get_Data(&TSL25721); // Read data from the sensor

    Serial.print("luminosity: ");
    Serial.print(TSL25721.ALS_LUX);
    Serial.println(" lx");

    delay(2000); // Delay between readings
}

Arduino خود را به کامپیوتر وصل کنید و برد Arduino خود را انتخاب کنید.

سپس کد نمونه را تأیید (verify) کرده و بارگذاری (upload) کنید.

پس از بارگذاری کد، سریال مانیتور را باز کنید و می‌توانید مقادیر روشنایی را مشاهده کنید.

برای اطلاع دقیق از مقادیر کاری و حداکثر مقادیر مجاز آی‌سی‌ها، کاربران باید به دیتاشیت اصلی و رسمی آن قطعات مراجعه کنند

اگر هر یک از اسناد فنی ناقص یا اشتباه است، لطفاً به ما اطلاع دهید

با نظرات خود به تیم جبرا در بهبود کیفیت کمک کنید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

توجه!

محصولات ما صرفاً برای اهداف تحقیقاتی و توسعه طراحی شده‌اند. جبرابیت صراحتاً اعلام می‌کند که در صورت استفاده کاربران از این محصولات در کاربردهای حساس و دقیق از جمله امور مالی یا مواردی که به جان و مال انسان آسیب می‌زنند، هیچ‌گونه مسئولیتی را نمی‌پذیرد.

برای اطلاع دقیق از مقادیر کاری و حداکثر مقادیر مجاز آی‌سی‌ها (IC)، کاربران باید حتماً به دیتاشیت اصلی و رسمی آن قطعات مراجعه کنند.

سبد خرید
پیمایش به بالا