Home » فروشگاه » ماژول سنسور نور محیط GebraBit TSL25721FN
محصول اوریجینال جبرابیت
تست شده
کیفیت مهندسی
نوری و اپتیک

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

3.700.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

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

در این بخش قصد داریم سنسور TSL25721را به وسیله میکروکنترلر آرم، سری STM32F راه اندازی کنیم. به منظور استفاده راحت تر و بهینه تر در این پروژه از دو ماژول آماده GB613EN و GebraBit STM32F303 استفاده میکنیم.

این دو ماژول شامل مینیمم قطعات لازم سنسور TSL25721و میکروکنترلر STM32F میباشند که توسط تیم جبرابیت جهت آسان سازی کار فراهم شده اند.

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

شما در این بخش ضمن راه اندازی و استفاده از سنسورTSL25721، به طور خلاصه با تمامی رجیسترهای سنسور TSL25721، نحوه تنظیم بخش های مختلف میکروکنترلر STM32 برای راه اندازی این سنسور با استفاده از پروتکل I2C، چگونگی استفاده از فایل کتابخانه و درایور مختص ماژول GB613EN، نحوه فراخوانی توابع و در نهایت دریافت داده های سنسور در کامپایلر Keil  نیز آشنا خواهید شد.

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

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

سخت افزارهای مورد نیازنرمافزارهای مورد نیاز
ST-LINK/V2 ProgrammerKeil uVision Programmer
STM32 Microcontroller – ( Gebra STM32f303 )STM32CubeMX Program
ماژول سنسور نور محیط GebraBit TSL25721FN
Cable and Breadboard

بدین منظور مانند تصویر زیر ماژولGebraBit TSL25721 را به صورت زیر به ماژول GebraBit STM32F303 متصل می کنیم:

Not: Gebra STM32F303 mikrodenetleyici modülünün PA14 pininin mikrodenetleyiciyi programlamak için kullanıldığı göz önüne alındığında, bu versiyonda PA14 ve PA15 pinlerindeki I2C ayarı imkansızdır, dolayısıyla bu versiyonda Gebra STM32F303 mikrokontrolör modülü ile I2C bağlantısı için ماژول سنسور نور محیط GebraBit TSL2572 modül üzerine Pin to Pin olarak yerleştirilemez.

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

در نهایت مقادیر  CH1 , CH0و ALS را به صورت Real Time در پنجره Watch1 کامپایلر Keil در حالت Debug Session مشاهده خواهیم کرد.

تنظیمات STM32CubeMX

در ادامه تنظیمات مربوط به هریک از بخش های I2C , RCC , Debug , Clock را در میکروکنترلر STM32F303 برای راه اندازی ماژول GebraBit TSL25721  را مرور می کنیم.

I2C تنظیمات

برای برقراری ارتباط I2C بین Gebra STM32F303و ماژول سنسور نور محیط GebraBit TSL2572، از مسیر Connectivity -> I2C گزینه Standard Mode را انتخاب کرده و پایه‌های PB8 و PB9 را به ترتیب به‌عنوان SCL و SDA تنظیم کنید.

نکته: اگر از میکروکنترلر دیگری استفاده می‌کنید یا می‌خواهید از پایه‌های متفاوتی برای I2C استفاده کنید، کافی است روی پایه دلخواه کلیک کرده و گزینه‌های i2c1_scl و i2c1_sda را انتخاب نمایید.

RCC / Clock تنظیمات

به‌دلیل وجود کریستال خارجی (External Crystal) در برد جبرابیت STM32F303، در بخش “RCC” گزینه “Crystal/Ceramic Resonator” را انتخاب می‌کنیم.

سپس از صفحه Clock Configuration حالت PLLCLK را انتخاب کرده و سایر تنظیمات لازم را انجام می‌دهیم (برای اطلاعات بیشتر کلیک کنید).

Debug & Programming تنظیمات

برای کاهش تعداد پایه‌ها در زمان Debug and Program، در این ماژول گزینه “Serial Wire” را از بخش “Debug” در بلوک “SYS” انتخاب می‌کنیم که مربوط به پایه‌های “SWCLK” و “SWDIO” است.

Project Manager تنظیمات

تنظیمات “Project Manager” به صورت زیر است؛ در اینجا از نسخه “5.32” محیط توسعه “MDK-ARM” استفاده کرده‌ایم. اگر شما برای برنامه‌نویسی از محیط توسعه دیگری استفاده می‌کنید، باید از قسمت Toolchain گزینه مربوط به IDE مورد استفاده خود را انتخاب کنید.





پس از تکمیل تمامی تنظیمات بالا، روی گزینه GENERATE CODE کلیک می‌کنیم.

Source Code

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

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

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

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

فایل هدر GebraBit_TSL25721 .h

در این فایل بر اساس دیتاشیت سنسور یا ای سی ، تمامی آدرس رجیسترها، مقادیر هریک از رجیسترها به صورت Enumeration تعریف شده است.همچنین بدنه سنسور TSL25721  و کانفیگ های مربوط به هریک از بلوک های داخلی سنسور  TSL25721  به صورت STRUCT  با نام  GebraBit_TSL25721  نیز تعریف شده است.که نهایتا در محیط  Debug Session تمامی کانفیگ های مربوط به هر بلوک به صورت Real Time قابل مشاهده است.

USER REGISTER MAP

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

C
#define TSL25721_ADDRESS 			  0x39
 #define TSL25721_WRITE_ADDRESS 		  ((TSL25721_ADDRESS<<1)|0)
 #define TSL25721_READ_ADDRESS 		  ((TSL25721_ADDRESS<<1)|1)
 #define TSL25721_I2C		          &hi2c1
 #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 Beacuse in open air

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 استفاده می شود:

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 استفاده می شود:

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 استفاده می شود :

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 مشخص می شود که بعد از تکرار چند بار از یک حالت وقفه انجام شود:

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);

فایل سورس GebraBit_TSL25721.c

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

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

بعد از تولید پروژه Keil با استفاده از STM32CubeMX و اضافه کردن کتابخانه GebraBit_TSL25721 .c ارائه شده توسط GebraBit ، به بررسی قسمت اصلی برنامه آموزشی نمونه، فایل main.c و مشاهده خروجی ماژول GebraBit TSL25721  در قسمت watch در محیط Debugging برنامه Keil می پردازیم.

شرح فایل main.c

به ساختار ها ، Enum ها و توابع مورد نیاز ماژول GebraBit TSL25721  ، اضافه شده است.در قسمت بعدی متغیری به نام TSL25721 _Module از نوع ساختار GebraBit_TSL25721  (این ساختار در هدر GebraBit_TSL25721  بوده و در بخش توضیحات کتابخانه GebraBit_TSL25721 توضیح داده شد) که برای پیکربندی ماژول GebraBit TSL25721  می باشد،تعریف شده است:

C
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
GebraBit_TSL25721  TSL25721 _Module;
/* USER CODE END PTD */

در بخش بعدی کد نوشته شده، با استفاده از تابع GB_TSL25721 _initialize(&TSL25721 _Module) و GB_TSL25721 _Configuration(&TSL25721 _Module) ماژول GebraBit TSL25721  را مقدار دهی می کنیم و در نهایت در قسمت while برنامه ،داده را از سنسور خوانده و مقادیر ALS  و CLEAR به طور پیوسته دریافت میشود:

C
 /* USER CODE BEGIN 2 */
 	GB_TSL25721 _initialize(&TSL25721 _Module);
 	GB_TSL25721 _Configuration(&TSL25721 _Module);
 /* USER CODE END 2 */

 /* Infinite loop */
/* USER CODE BEGIN WHILE */
while (1)
{
  /* USER CODE END WHILE */

   /* USER CODE BEGIN 3 */
	GB_TSL25721 _Get_Data(&TSL25721 _Module);
 }
/* USER CODE END 3 */
 }

“main.c” dosyası kodu:

C
/* USER CODE BEGIN Header */
 /*
  * ________________________________________________________________________________________________________
  * Copyright (c) 2020 GebraBit Inc. All rights reserved.
  *
  * This software, related documentation and any modifications thereto (collectively “Software”) is subject
  * to GebraBit and its licensors' intellectual property rights under U.S. and international copyright
  * and other intellectual property rights laws.
  *
  * GebraBit and its licensors retain all intellectual property and proprietary rights in and to the Software
  * and any use, reproduction, disclosure or distribution of the Software without an express license agreement
  * from GebraBit is strictly prohibited.

  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
  * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT IN
  * NO EVENT SHALL GebraBit BE LIABLE FOR ANY DIRECT, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
  * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
  * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  * OF THE SOFTWARE.
  * ________________________________________________________________________________________________________
  */
 /**
   ******************************************************************************
   * @file           : main.c
   * @brief          : Main program body
 	* @Author       	: Mehrdad Zeinali
   ******************************************************************************
   * @attention
   *
   * Copyright (c) 2022 STMicroelectronics.
   * All rights reserved.
   *
   * This software is licensed under terms that can be found in the LICENSE file
   * in the root directory of this software component.
   * If no LICENSE file comes with this software, it is provided AS-IS.
   *
   ******************************************************************************
   */
 /* USER CODE END Header */
 /* Includes ------------------------------------------------------------------*/
 #include "main.h"
 #include "i2c.h"
 #include "gpio.h"

 /* Private includes ----------------------------------------------------------*/
 /* USER CODE BEGIN Includes */
 #include "GebraBit_TSL25721 .h"
 /* USER CODE END Includes */

 /* Private typedef -----------------------------------------------------------*/
 /* USER CODE BEGIN PTD */
 GebraBit_TSL25721  TSL25721 _Module;
 /* USER CODE END PTD */

 /* Private define ------------------------------------------------------------*/
 /* USER CODE BEGIN PD */
 /* USER CODE END PD */

 /* Private macro -------------------------------------------------------------*/
 /* USER CODE BEGIN PM */

 /* USER CODE END PM */

 /* Private variables ---------------------------------------------------------*/

 /* USER CODE BEGIN PV */

 /* USER CODE END PV */

 /* Private function prototypes -----------------------------------------------*/
 void SystemClock_Config(void);
 /* USER CODE BEGIN PFP */

 /* USER CODE END PFP */

 /* Private user code ---------------------------------------------------------*/
 /* USER CODE BEGIN 0 */

 /* USER CODE END 0 */

 /**
   * @brief  The application entry point.
   * @retval int
   */
 int main(void)
 {
   /* USER CODE BEGIN 1 */

   /* USER CODE END 1 */

   /* MCU Configuration--------------------------------------------------------*/

   /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
   HAL_Init();

   /* USER CODE BEGIN Init */

   /* USER CODE END Init */

   /* Configure the system clock */
   SystemClock_Config();

   /* USER CODE BEGIN SysInit */

   /* USER CODE END SysInit */

   /* Initialize all configured peripherals */
   MX_GPIO_Init();
   MX_I2C1_Init();
   /* USER CODE BEGIN 2 */
   GB_TSL25721 _initialize(&TSL25721 _Module);
 	GB_TSL25721 _Configuration(&TSL25721 _Module);
   /* USER CODE END 2 */

   /* Infinite loop */
   /* USER CODE BEGIN WHILE */
   while (1)
   {
     /* USER CODE END WHILE */
     GB_TSL25721 _Get_Data(&TSL25721 _Module);
     /* USER CODE BEGIN 3 */
   }
   /* USER CODE END 3 */
 }

 /**
   * @brief System Clock Configuration
   * @retval None
   */
 void SystemClock_Config(void)
 {
   RCC_OscInitTypeDef RCC_OscInitStruct = {0};
   RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
   RCC_PeriphCLKInitTypeDef PeriphClkInit = {0};

   /** Initializes the RCC Oscillators according to the specified parameters
   * in the RCC_OscInitTypeDef structure.
   */
   RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
   RCC_OscInitStruct.HSEState = RCC_HSE_ON;
   RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
   RCC_OscInitStruct.HSIState = RCC_HSI_ON;
   RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
   RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
   RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
   if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
   {
     Error_Handler();
   }

   /** Initializes the CPU, AHB and APB buses clocks
   */
   RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                               |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
   RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
   RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
   RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
   RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

   if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
   {
     Error_Handler();
   }
   PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_I2C1;
   PeriphClkInit.I2c1ClockSelection = RCC_I2C1CLKSOURCE_SYSCLK;
   if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
   {
     Error_Handler();
   }
 }

 /* USER CODE BEGIN 4 */

 /* USER CODE END 4 */

 /**
   * @brief  This function is executed in case of error occurrence.
   * @retval None
   */
 void Error_Handler(void)
 {
   /* USER CODE BEGIN Error_Handler_Debug */
   /* User can add his own implementation to report the HAL error return state */
   __disable_irq();
   while (1)
   {
   }
   /* USER CODE END Error_Handler_Debug */
 }

 #ifdef  USE_FULL_ASSERT
 /**
   * @brief  Reports the name of the source file and the source line number
   *         where the assert_param error has occurred.
   * @param  file: pointer to the source file name
   * @param  line: assert_param error line source number
   * @retval None
   */
 void assert_failed(uint8_t *file, uint32_t line)
 {
   /* USER CODE BEGIN 6 */
   /* User can add his own implementation to report the file name and line number,
      ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
   /* USER CODE END 6 */
 }
 #endif /* USE_FULL_ASSERT */

STLINK V2

پس از ایجاد پروژه Keil با استفاده از STM32CubeMX و افزودن کتابخانه، آداپتور STLINKV2 را متصل کرده و برنامه‌نویس STLINK V2 را به برد جبرابیت STM32F303 وصل می‌کنیم.
وقتی برنامه‌نویس STLINK V2 را به برد جبرابیت STM32F303 متصل می‌کنید، نیازی به تغذیه جداگانه ماژول نیست، زیرا ولتاژ تغذیه را مستقیماً از برنامه‌نویس STLINK V2 دریافت می‌کند.

سپس روی گزینه Build (F7) کلیک کرده و پنجره Build Output را برای بررسی خطاهای احتمالی کنترل می‌کنیم.

Son olarak “Debug” moduna girip “watch” penceresine “TSL25721_Module” ekleyip programı çalıştırarak Gebra TSL25721 modülünün Clear ve ALS değerlerindeki değişimleri görebiliriz:

1. TSL25721FN چه نوع سنسوری است و چگونه کار می‌کند؟

سنسور TSL25721FN یک ambient light sensor با قابلیت تبدیل نور محیط به داده دیجیتال است. این سنسور دارای photodiode دو کاناله است که می‌تواند نور مرئی و IR را به طور همزمان اندازه‌گیری کند و داده‌ها را از طریق I²C interface ارائه دهد. TSL25721FN از ADC داخلی 16 بیتی استفاده می‌کند که دقت بالایی در اندازه‌گیری روشنایی فراهم می‌کند و می‌تواند در محدوده 0 تا چندین هزار lux عمل کند. این سنسور برای کاربردهایی مثل تنظیم خودکار روشنایی نمایشگر و مدیریت انرژی ایده‌آل است.
🔗 Reference: TSL25721FN Datasheet – ams


2. ولتاژ و جریان کاری TSL25721FN چقدر است؟

سنسور TSL25721FN با ولتاژ کاری 2.7V تا 3.6V کار می‌کند و جریان مصرفی آن در حالت active حدود 400 µA است. در حالت power-down mode، مصرف به کمتر از 1 µA کاهش می‌یابد که برای کاربردهای باتری‌محور مناسب است. این ولتاژ و جریان کم باعث می‌شود سنسور در پروژه‌های موبایل و IoT بهینه باشد و بدون نیاز به مدارهای اضافی برای regulation قابل استفاده باشد.
🔗 Reference: TSL25721FN Datasheet – ams


3. چگونه می‌توان داده‌های TSL25721FN را از طریق I²C خواند؟

برای خواندن داده‌های TSL25721FN، ابتدا I²C address صحیح را انتخاب و پین‌های SDA و SCL را به میکروکنترلر متصل می‌کنیم. سپس با ارسال دستور read command، می‌توان مقادیر ADC هر کانال نور را دریافت کرد. داده‌های خروجی 16 بیتی هستند و باید با توجه به integration time و gain تبدیل به lux شوند. این روش امکان استفاده آسان با Arduino و STM32 را فراهم می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


4. TSL25721FN چگونه کالیبره می‌شود و دقت آن چقدر است؟

TSL25721FN دارای factory calibration است و معمولاً نیازی به کالیبراسیون دستی ندارد. با این حال، برای دقت بالاتر می‌توان از dark offset و lux scaling factor استفاده کرد. دقت سنسور در محدوده نور مرئی معمولاً ±10٪ است و drift حرارتی در دماهای معمولی کمتر از 2٪ می‌باشد. این ویژگی‌ها باعث می‌شوند TSL25721FN در کاربردهای روشنایی حساس و اندازه‌گیری محیطی بسیار قابل اعتماد باشد.
🔗 Reference: TSL25721FN Datasheet – ams


5. محدوده حساسیت نور TSL25721FN چقدر است؟

TSL25721FN می‌تواند نور محیط را از حدود 0.1 lux تا 40,000 lux اندازه‌گیری کند، که این بازه شامل نور بسیار کم تا نور مستقیم خورشید می‌شود. این سنسور دارای دو کانال است: یکی برای نور مرئی و دیگری برای نور IR، که با ترکیب داده‌ها می‌توان شدت نور واقعی محیط را دقیق‌تر محاسبه کرد. تنظیم integration time و gain امکان تطبیق سنسور با شرایط نوری مختلف را فراهم می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


6. چگونه می‌توان integration time را در TSL25721FN تنظیم کرد؟

در TSL25721FN، integration time زمان نمونه‌گیری ADC را تعیین می‌کند و بر دقت و dynamic range اندازه‌گیری نور تأثیر دارد. این مقدار معمولاً بین 50ms تا 700ms قابل تنظیم است و زمان طولانی‌تر باعث افزایش دقت در نور کم می‌شود، اما نرخ نمونه‌گیری را کاهش می‌دهد. با تنظیم درست integration time، می‌توان سنسور را برای محیط‌های مختلف نوری بهینه کرد.
🔗 Reference: TSL25721FN Datasheet – ams


7. چرا TSL25721FN دو کانال نوری دارد و چه مزیتی دارد؟

TSL25721FN دارای Channel 0 (broadband) و Channel 1 (IR) است. این طراحی اجازه می‌دهد نور مرئی و مادون قرمز به صورت جداگانه اندازه‌گیری شوند و با ترکیب داده‌ها، مقدار lux واقعی و کیفیت روشنایی محیط محاسبه شود. دو کاناله بودن باعث کاهش خطاهای ناشی از منابع نوری ترکیبی و تابش IR مزاحم می‌شود و accuracy سنسور را افزایش می‌دهد.
🔗 Reference: TSL25721FN Datasheet – ams


8. چگونه می‌توان gain سنسور TSL25721FN را تنظیم کرد؟

TSL25721FN از two gain levels (1x, 16x) برای افزایش دقت در نور کم استفاده می‌کند. انتخاب gain مناسب باعث می‌شود مقادیر ADC در محدوده بهینه باقی بمانند و از saturation جلوگیری شود. معمولاً در نور محیط کم، از gain بالا استفاده می‌کنیم و در نور شدید، gain پایین انتخاب می‌شود. این تنظیمات می‌توانند به صورت نرم‌افزاری و از طریق I²C اعمال شوند.
🔗 Reference: TSL25721FN Datasheet – ams


9. چه عواملی می‌توانند باعث drift یا خطا در TSL25721FN شوند؟

عوامل اصلی drift در TSL25721FN شامل تغییرات دما، تابش مستقیم خورشید، و نور IR مزاحم هستند. همچنین نوسانات ولتاژ و نویز الکترونیکی می‌توانند بر ADC اثر بگذارند. برای کاهش خطا، توصیه می‌شود از decoupling capacitor، تنظیم مناسب integration time و gain، و فیلتر نرم‌افزاری برای smoothing داده‌ها استفاده شود.
🔗 Reference: TSL25721FN Datasheet – ams


10. TSL25721FN چگونه با Arduino یا STM32 راه‌اندازی می‌شود؟

راه‌اندازی TSL25721FN با Arduino یا STM32 از طریق I²C library ساده است. ابتدا آدرس I²C را مشخص کرده، سپس مقادیر register را برای gain و integration time تنظیم می‌کنیم. با خواندن دو کانال ADC، می‌توان lux واقعی را محاسبه و نمایش داد. کتابخانه‌ها و مثال‌های رسمی می‌توانند روند راه‌اندازی را سریع‌تر و بدون خطا کنند.
🔗 Reference: TSL25721FN Datasheet – ams


11. TSL25721FN چه محدوده دمای کاری دارد و آیا دما روی دقت تأثیر می‌گذارد؟

TSL25721FN می‌تواند در دمای -40°C تا +85°C کار کند. با این حال، دماهای بسیار بالا یا پایین می‌توانند بر ADC accuracy و drift سنسور اثر بگذارند. برای کاربردهای حساس، توصیه می‌شود دمای محیط پایدار نگه داشته شود یا از temperature compensation استفاده شود تا اندازه‌گیری نور دقیق باقی بماند.
🔗 Reference: TSL25721FN Datasheet – ams


12. چگونه می‌توان نور شدید یا مستقیم خورشید را با TSL25721FN اندازه‌گیری کرد؟

در نور بسیار شدید، کانال ADC ممکن است به saturation برسد. برای جلوگیری از این مشکل، TSL25721FN دارای low gain mode و integration time کوتاه است. ترکیب gain و integration time مناسب به شما اجازه می‌دهد حتی در نور مستقیم خورشید، داده‌های قابل اعتمادی از سنسور دریافت کنید. همچنین، استفاده از یک optical filter می‌تواند نور IR مزاحم را کاهش دهد.
🔗 Reference: TSL25721FN Datasheet – ams


13. آیا TSL25721FN می‌تواند برای کنترل روشنایی صفحه نمایش استفاده شود؟

بله، TSL25721FN برای ambient light sensing و کنترل خودکار روشنایی نمایشگر بسیار مناسب است. با خواندن lux محیط و مقایسه با مقادیر مرجع، می‌توان PWM یا تنظیم دیجیتال brightness را در نمایشگر اعمال کرد. دقت بالا و دو کاناله بودن سنسور باعث می‌شود نور محیط واقعی به درستی شناسایی شود و تجربه کاربری بهتر شود.
🔗 Reference: TSL25721FN Datasheet – ams


14. TSL25721FN چگونه نویز الکترونیکی را مدیریت می‌کند؟

سنسور TSL25721FN دارای internal ADC averaging و فیلتر نرم‌افزاری برای کاهش نویز است. همچنین، استفاده از decoupling capacitor روی VDD و اتصال صحیح زمین باعث کاهش interference می‌شود. با این روش‌ها، حتی در محیط‌های نویزی، داده‌های lux پایدار و دقیق از سنسور دریافت می‌شود.
🔗 Reference: TSL25721FN Datasheet – ams


15. آیا TSL25721FN می‌تواند میزان IR و نور مرئی را جداگانه گزارش دهد؟

بله، TSL25721FN دو کانال جداگانه دارد: Channel 0 برای نور مرئی + IR و Channel 1 فقط برای IR. با استفاده از این دو کانال و فرمول‌های ارائه شده در Datasheet، می‌توان نور مرئی خالص و IR را محاسبه کرد. این ویژگی برای جلوگیری از تأثیر نور IR مزاحم در کاربردهای دقیق مثل کنترل روشنایی و سنجش lux حیاتی است.
🔗 Reference: TSL25721FN Datasheet – ams


16. چه فاکتورهایی در دقت اندازه‌گیری lux با TSL25721FN مؤثر هستند؟

دقت lux در TSL25721FN تحت تأثیر gain، integration time، temperature drift و نویز محیطی است. انتخاب gain و integration time مناسب باعث می‌شود ADC در محدوده بهینه عمل کند و داده‌های پایدار دریافت شوند. همچنین ترکیب داده‌های دو کانال (broadband و IR) امکان حذف خطاهای ناشی از تابش IR مزاحم را فراهم می‌کند و lux واقعی محیط بهتر تخمین زده می‌شود.
🔗 Reference: TSL25721FN Datasheet – ams


17. چگونه می‌توان TSL25721FN را برای نور کم کالیبره کرد؟

برای نور کم، توصیه می‌شود gain بالاتر (16x) و integration time طولانی‌تر انتخاب شود تا مقادیر ADC دقیق‌تر ثبت شوند. استفاده از dark offset و فرمول scaling factor ارائه شده در Datasheet باعث می‌شود اندازه‌گیری lux در نور کم دقیق باقی بماند. این روش مخصوصاً در کاربردهای اتاق تاریک یا سنجش روشنایی شبانه مفید است.
🔗 Reference: TSL25721FN Datasheet – ams


18. چه محدودیت‌هایی برای استفاده از TSL25721FN در نور IR زیاد وجود دارد؟

اگر محیط دارای نور IR شدید باشد، Channel 1 می‌تواند اشباع شود و بر محاسبه lux واقعی تأثیر بگذارد. با ترکیب داده‌های دو کانال و استفاده از الگوریتم‌های موجود در Datasheet، این خطا قابل اصلاح است. همچنین می‌توان از optical IR filter برای کاهش اثر نور مزاحم استفاده کرد.
🔗 Reference: TSL25721FN Datasheet – ams


19. چه نکاتی برای طراحی PCB با TSL25721FN مهم است؟

برای طراحی PCB با TSL25721FN، توصیه می‌شود مسیرهای SDA و SCL کوتاه و بدون نویز باشند و از pull-up resistor مناسب استفاده شود. همچنین محل سنسور باید از منابع نور غیرمرئی مزاحم و EMI دور باشد. استفاده از ground plane کامل و decoupling capacitor نزدیک VDD باعث بهبود پایداری داده‌ها و کاهش نویز می‌شود.
🔗 Reference: TSL25721FN Datasheet – ams


20. چگونه می‌توان TSL25721FN را در پروژه‌های Arduino و STM32 با I²C راه‌اندازی کرد؟

راه‌اندازی TSL25721FN در Arduino و STM32 شامل اتصال SDA و SCL، تنظیم آدرس I²C و نوشتن register برای gain و integration time است. سپس با خواندن دو کانال ADC، lux واقعی محاسبه می‌شود. استفاده از library رسمی یا نمونه کد Datasheet فرآیند را ساده می‌کند و احتمال خطا در کدنویسی کاهش می‌یابد.
🔗 Reference: TSL25721FN Datasheet – ams


21. TSL25721FN در چه نوع کاربردهایی بهترین عملکرد را دارد؟

سنسور TSL25721FN برای ambient light sensing در نمایشگرها، دستگاه‌های موبایل، ساعت‌های هوشمند، سیستم‌های روشنایی هوشمند و IoT ایده‌آل است. با دو کانال نوری و ADC 16 بیتی، می‌تواند نور مرئی و IR محیط را به دقت اندازه‌گیری کند و داده‌های lux قابل اعتماد ارائه دهد. این ویژگی باعث می‌شود کنترل خودکار روشنایی و مدیریت انرژی بهینه شود.
🔗 Reference: TSL25721FN Datasheet – ams


22. چگونه می‌توان نور محیط را با TSL25721FN در شرایط نوری متغیر اندازه‌گیری کرد؟

برای اندازه‌گیری در محیط با تغییرات نور سریع، توصیه می‌شود integration time کوتاه و continuous mode انتخاب شود. این روش باعث می‌شود سنسور داده‌ها را به‌روز نگه دارد و تغییرات نور سریع را ثبت کند. همچنین، استفاده از smoothing نرم‌افزاری روی داده‌های lux به کاهش نوسان و نویز کمک می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


23. آیا TSL25721FN نیاز به کالیبراسیون دوره‌ای دارد؟

TSL25721FN دارای factory calibration است و معمولاً نیاز به کالیبراسیون دوره‌ای ندارد. با این حال، در محیط‌های خاص یا کاربردهای بسیار دقیق، می‌توان با بررسی dark offset و lux scaling factor داده‌ها را بهبود داد. این سنسور برای اکثر کاربردهای روزمره و صنعتی بدون کالیبراسیون اضافی دقیق و پایدار عمل می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


24. چه عواملی باعث ایجاد خطا در اندازه‌گیری lux توسط TSL25721FN می‌شوند؟

عوامل خطا شامل نور مستقیم خورشید، نور IR مزاحم، نوسانات دما و نویز الکترونیکی هستند. برای کاهش خطا، توصیه می‌شود از gain و integration time مناسب استفاده شود و مسیرهای I²C کوتاه و بدون نویز طراحی شود. همچنین، فیلتر نرم‌افزاری و smoothing داده‌ها باعث افزایش accuracy می‌شود.
🔗 Reference: TSL25721FN Datasheet – ams


25. چگونه می‌توان lux واقعی را از داده‌های دو کانال TSL25721FN محاسبه کرد؟

برای محاسبه lux واقعی، داده‌های Channel 0 (broadband) و Channel 1 (IR) باید با فرمول ارائه شده در Datasheet ترکیب شوند. این فرمول با توجه به integration time و gain، مقدار lux دقیق را ارائه می‌دهد و اثر تابش IR مزاحم حذف می‌شود. استفاده از این محاسبه نرم‌افزاری باعث می‌شود سنسور در انواع شرایط نوری قابل اعتماد باشد.
🔗 Reference: TSL25721FN Datasheet – ams


26. TSL25721FN در چه محدوده ولتاژ کاری بهترین عملکرد را دارد؟

TSL25721FN می‌تواند در محدوده 2.7V تا 3.6V کار کند. استفاده از ولتاژ خارج از این محدوده ممکن است باعث کاهش دقت، افزایش نویز و اختلال در عملکرد I²C شود. برای پایداری بیشتر، توصیه می‌شود منبع تغذیه با low ripple و تثبیت شده استفاده شود تا lux واقعی به‌طور دقیق اندازه‌گیری شود.
🔗 Reference: TSL25721FN Datasheet – ams


27. TSL25721FN چگونه از نور محیطی مختلف تشخیص lux می‌دهد؟

TSL25721FN با دو کانال نوری و ADC 16 بیتی می‌تواند نور مرئی و IR را جداگانه اندازه‌گیری کند. با ترکیب داده‌ها و استفاده از فرمول lux ارائه شده در Datasheet، میزان lux واقعی محیط محاسبه می‌شود. این طراحی باعث می‌شود سنسور حتی در شرایط نوری پیچیده مانند تابش همزمان LED و نور خورشید دقت بالایی داشته باشد.
🔗 Reference: TSL25721FN Datasheet – ams


28. چگونه می‌توان نویز I²C را در TSL25721FN کاهش داد؟

برای کاهش نویز در ارتباط I²C، توصیه می‌شود مسیرهای SDA و SCL کوتاه و موازی با خطوط پر نویز قرار نگیرند. استفاده از pull-up resistor مناسب (4.7kΩ یا 10kΩ) و decoupling capacitor نزدیک VDD باعث می‌شود ارتباط پایدار شود. این اقدامات باعث می‌شود داده‌های lux با کمترین خطا از TSL25721FN دریافت شوند.
🔗 Reference: TSL25721FN Datasheet – ams


29. آیا TSL25721FN می‌تواند در محیط‌های صنعتی با نور شدید IR کار کند؟

بله، اما برای عملکرد دقیق توصیه می‌شود integration time کوتاه و gain پایین انتخاب شود تا از اشباع ADC جلوگیری شود. همچنین استفاده از فیلترهای نوری و الگوریتم‌های نرم‌افزاری برای حذف اثر نور IR مزاحم، دقت lux را در محیط‌های صنعتی افزایش می‌دهد.
🔗 Reference: TSL25721FN Datasheet – ams


30. چه فرمولی برای محاسبه lux از Channel 0 و Channel 1 ارائه شده است؟

در Datasheet TSL25721FN فرمولی وجود دارد که با استفاده از ADC0 (broadband) و ADC1 (IR) و اعمال scaling factor و integration time، lux واقعی محاسبه می‌شود. این فرمول اثر نور IR مزاحم را حذف کرده و دقت اندازه‌گیری را افزایش می‌دهد. استفاده از این محاسبه نرم‌افزاری ضروری است تا lux در هر محیطی دقیق باشد.
🔗 Reference: TSL25721FN Datasheet – ams


31. چگونه می‌توان TSL25721FN را در سیستم روشنایی هوشمند استفاده کرد؟

با خواندن lux محیط از TSL25721FN و مقایسه با مقادیر هدف، می‌توان PWM یا dimming چراغ‌ها را کنترل کرد. دو کاناله بودن سنسور و دقت ADC باعث می‌شود تنظیم روشنایی بدون خطا و با سرعت مناسب انجام شود. این روش به کاهش مصرف انرژی و افزایش راحتی دید کاربران کمک می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


32. TSL25721FN چگونه در نور کم و شب عملکرد می‌دهد؟

در نور کم، توصیه می‌شود از gain بالا (16x) و integration time طولانی استفاده شود. این تنظیمات باعث می‌شود ADC سیگنال‌های کوچک نور محیط را ثبت کند و lux واقعی به دقت اندازه‌گیری شود. داده‌های دو کانال نیز امکان حذف نویز و IR مزاحم را فراهم می‌کنند.
🔗 Reference: TSL25721FN Datasheet – ams


33. تفاوت TSL25721FN با سنسورهای مشابه چیست؟

TSL25721FN دارای دو کانال نوری، ADC 16 بیتی، و امکان تنظیم gain و integration time است که باعث دقت و انعطاف‌پذیری بالاتر نسبت به سنسورهای ساده تک‌کاناله می‌شود. همچنین قابلیت کار در نور کم و نور شدید با correction نرم‌افزاری از دیگر مزایای آن است. این ویژگی‌ها آن را برای کاربردهای صنعتی و مصرفی مناسب می‌کند.
🔗 Reference: TSL25721FN Datasheet – ams


34. چگونه می‌توان داده‌های TSL25721FN را در Arduino یا STM32 پردازش کرد؟

پس از خواندن دو کانال ADC، با استفاده از فرمول lux و scaling factor داده‌ها پردازش می‌شوند. می‌توان داده‌ها را smooth کرد یا از فیلتر نرم‌افزاری برای کاهش نویز استفاده نمود. Arduino و STM32 به کمک I²C library رسمی یا نمونه کد Datasheet به راحتی می‌توانند lux واقعی را محاسبه و استفاده کنند.
🔗 Reference: TSL25721FN Datasheet – ams


35. منابع رسمی TSL25721FN از کجا قابل دریافت هستند؟

برای دریافت Datasheet، Design Guide و نمونه کد TSL25721FN می‌توان به صفحه رسمی کارخانه مراجعه کرد. این منابع شامل توضیحات کامل سخت‌افزاری، نرم‌افزاری و روش‌های محاسبه lux هستند و پایه‌ای برای طراحی و راه‌اندازی پروژه‌های دقیق با این سنسور فراهم می‌کنند.
🔗 Reference: Manufacturer Official Product Page – TSL25721FN

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

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

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

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


توجه!

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

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

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