GebraBit

پروژه سنسور نوری LTR303ALS با سری میکروکنترلر STM32F303

متن سربرگ خود را وارد کنید

LTR303 gebrabit project

پروژه سنسور نوری LTR303ALS با سری میکروکنترلر STM32F303

LTR303 gebrabit project
  1. خانه
  2. »
  3. پروژه ها
  4. »
  5. پروژه سنسور نوری LTR303ALS با سری میکروکنترلر STM32F303

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

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

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

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

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

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

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

سخت افزارهای مورد نیاز
نرم افزارهای مورد نیاز
Keil compiler 
 STM32CubeMX program
 ST-LINK/V2 programmer

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

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

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

تنظیمات STM32CubeMX

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

تنظیمات RCC

با توجه به وجود کریستال 8Mhz در ماژول GebraBit STM32F303 ، کلاک خارجی را در بخش RCC انتخاب می کنیم:

تنظیمات Debug&Programming

با توجه به دسترسی به پین های SWCLK و SWDIO در ماژول GebraBit STM32F303 ، برای کاهش تعداد پین هنگام  Debug&Programming در بلوک SYS گزینه Serial Wire را در بخش Debug انتخاب می کنیم:

تنظیمات I2C

برای ارتباط از طریق I2C با ماژول GebraBit STM32F303 حالت Standard Mode  با سرعت 100khz  را انتخاب کرده و پین های PB8 و PB9 را به عنوان SCL و SDA انتخاب می کنیم :

با توجه به دیتاشیت سنسور ، تنظیمات پارامتر های I2C  در بخش Parameter Settings همانند تصویر بالا مقدار دهی خواهد شد.

تنظیمات Clock

تنظیمات کلاک مربوط به هریک از بخش های میکروکنترلر STM32F303 در این کد به شرح ذیل می باشد:

تنظیمات Project Manager

تنظیمات Project Manager به صورت زیر بوده که در اینجا ما از کامپایلر MDK-ARM ورژن 5.32 استفاده کرده ایم:

بعد از اتمام تمام تنظیمات فوق ، بر روی GENERATE CODE  کلیک کرده و با اضافه کردن کتابخانه و درایور(تهیه شده توسط GebraBit) LTR303ALS ، کد خود را به راحتی توسعه می دهیم.فایل STM32CubeMX , کتابخانه و درایور و پروژه KEIL را می توانید از انتهای این آموزش دانلود کنید.

کتابخانه و درایور LTR303ALS

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

بدین منظور پس از تهیه هر یک از ماژول های  GebraBit  ، کاربر می تواند با مراجعه به بخش آموزش ماژول مربوطه، کتابخانه مختص به آن ماژول که حاوی فایل .h و .c (Header and Source) و یک برنامه نمونه آموزشی تحت سخت افزار های GebraBit STM32F303, GebraBit ATMEGA32A یا Arduino می باشد را دانلود کند.

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

فایل هدر GebraBit_LTR303ALS.h

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

USER REGISTER MAP

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

				
					1. #define LTR303ALS_ALS_CONTR                  0x80
 2. #define LTR303ALS_ALS_MEAS_RATE         	 0x85
 3. #define LTR303ALS_PART_ID		  		     0x86
 4. #define LTR303ALS_MANUFAC_ID                 0x87
 5. #define LTR303ALS_ALS_DATA_CH1_0             0x88      ////0xA0 TO 0xAE
 6. #define LTR303ALS_ALS_DATA_CH1_1	         0x89
 7. #define LTR303ALS_ALS_DATA_CH0_0		     0x8A
 8. #define LTR303ALS_ALS_DATA_CH0_1		     0x8B
 9. #define LTR303ALS_ALS_STATUS		         0x8C	  /* I2C Address */
10. #define LTR303ALS_INTERRUPT                  0x8F
11. #define LTR303ALS_ALS_THRES_UP_0             0x97
12. #define LTR303ALS_ALS_THRES_UP_1		     0x98
13. #define LTR303ALS_ALS_THRES_LOW_0 			 0x99
14. #define LTR303ALS_ALS_THRES_LOW_1 			 0x9A
15. #define LTR303ALS_INTERRUPT_PERSIST		     0x9E
16. #define LTR303ALS_WRITE_ADDRESS 		     0x52
17. #define LTR303ALS_READ_ADDRESS               0x53
18. #define LTR303ALS_ADDRESS 			         0x29
19. #define LTR303ALS_I2C		                 &hi2c1	
20. #define LTR303ALS_OSR_256_CONVERSION_TIME	 1
21. #define LTR303ALS_OSR_512_CONVERSION_TIME	 2
22. #define LTR303ALS_OSR_1024_CONVERSION_TIME	 3
23. #define LTR303ALS_OSR_2048_CONVERSION_TIME	 5
24. #define LTR303ALS_OSR_4096_CONVERSION_TIME	 9
25. #define LTR303ALS_OSR_8192_CONVERSION_TIME	 17
26. #define REGISTER_DATA_BUFFER_SIZE            4
27.  

				
			

enum LTR303ALS_ALS_Mode

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

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

				
			

enum LTR303ALS_ALS_Gain

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

				
					typedef enum ALS_Gain 
{
  ALS_GAIN_1X  = 0,
  ALS_GAIN_2X  = 1,
  ALS_GAIN_4X  = 2,
  ALS_GAIN_8X  = 3,
  ALS_GAIN_48X = 6,
  ALS_GAIN_96X = 7,
} LTR303ALS_ALS_Gain;

				
			

enum LTR303ALS_ Integration_Time

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

				
					typedef enum Integration_Time
{
  ALS_INTEGTIME_100_mS,
  ALS_INTEGTIME_50_mS ,
  ALS_INTEGTIME_200_mS,
  ALS_INTEGTIME_400_mS,
  ALS_INTEGTIME_150_mS,
  ALS_INTEGTIME_250_mS,
  ALS_INTEGTIME_300_mS,
  ALS_INTEGTIME_350_mS,
} LTR303ALS_Integration_Time;

				
			

enum LTR303ALS_ Measurement_Rate

نرخ اندازه گیری مقادیر داده توسط سنسور از مقادیر این enum استفاده می شود:

				
					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,
} LTR303ALS_Measurement_Rate;

				
			

enum LTR303ALS_ Data_Status

مقادیر این enum مشخص می کند دیتای خوانده شده، مقادیر جدید می باشد یا قدیمی:

				
					typedef enum Data_Status 
{  
	OLD_DATA = 0 ,                      
	NEW_DATA     
}LTR303ALS_Data_Status;

				
			

enum LTR303ALS_ Interrupt_Status

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

				
					typedef enum Interrupt_Status 
{  
	INTERRUPT_INACTIVE = 0 ,                      
	INTERRUPT_ACTIVE     
}LTR303ALS_Interrupt_Status;

				
			

enum LTR303ALS_Data_Valid

با استفاده از این enum مشخص می شود دیتای خوانده شده صحیح است یا خیر:

				
					typedef enum Data_Valid 
{  
	DATA_IS_VALID = 0 ,                      
	DATA_IS_INVALID     
}LTR303ALS_Data_Valid;

				
			

enum LTR303ALS_Interrupt_Mode

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

				
					typedef enum Interrupt_Mode 
{  
	INT_PIN_INACTIVE = 0 ,                      
	INT_PIN_TRIG_INTERRUPT     
}LTR303ALS_Interrupt_Mode;

				
			

enum LTR303ALS_Interrupt_Polarity

با استفاده از این enum سطح لاجیک (active low یا active high بودن) پین وقفه ، هنگام وقوع انتخاب می شود:

				
					typedef enum Interrupt_Polarity 
{  
	ACTIVE_LOW = 0 ,                      
	ACTIVE_HIGH     
}LTR303ALS_Interrupt_Polarity;

				
			

enum LTR303ALS_Interrupt_Persist

با استفاده از این enum مشخص می شود که بعد از تکرار چند بار از یک حالت وقفه انجام شود:

				
					typedef enum Interrupt_Persist
{
EVERY_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_2_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_3_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_4_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_5_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_6_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_7_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_8_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_9_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_10_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_11_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_12_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_13_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_14_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_15_ALS_VALUE_OUT_OF_THR_RANGE,
CONSECUTIVE_16_ALS_VALUE_OUT_OF_THR_RANGE,
} LTR303ALS_Interrupt_Persist;

				
			

enum LTR303ALS_Reset_Status

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

				
					typedef enum 
{  
	FAILED = 0 ,                      
	DONE     
}LTR303ALS_Reset_Status;

				
			

struct LTR303ALS

تمام ویژگی های سنسور، ضرایب کالیبراسیون و داده های سنسور در این Struct تعریف شده است و تمامی اطلاعات و کانفیگ اجرا شده بر روی سنسور در این Structure ذخیره شده و می توان تغییرات در هر بخش از سنسور را در محیط Debug Session مشاهده نمود:

				
					1. typedef	struct LTR303ALS
 2. {
 3. 	  uint8_t                       	Register_Cache;
 4. 	  uint8_t			                PART_ID;
 5. 	  uint8_t							MANUFACTURE_ID;
 6. 	  LTR303ALS_Reset_Status			RESET;
 7. 	  LTR303ALS_ALS_Mode                ALS_MODE;
 8. 	  LTR303ALS_ALS_Gain                ALS_GAIN;
 9. 	  uint8_t	 						ALS_GAIN_VALUE;
10. 	  LTR303ALS_Measurement_Rate        MEASUREMENT_RATE;
11. 	  LTR303ALS_Integration_Time        INTEGRATION_TIME;
12. 	  float								INTEGRATION_TIME_VALUE;
13.       LTR303ALS_Data_Status             DATA_STATUS;
14.       LTR303ALS_Interrupt_Status		INTERRRUPT_STATUS;
15.       LTR303ALS_Data_Valid              DATA;
16. 	  LTR303ALS_Interrupt_Mode          INTERRUPT_MODE;
17. 	  LTR303ALS_Interrupt_Polarity      INTERRUPT_POLARITY;
18.       LTR303ALS_Interrupt_Persist       INTERRUPT_PERSIST;
19. 	  uint16_t                          INTERRUPT_UPPER_THRESHOLD;
20. 	  uint16_t                          INTERRUPT_LOWER_THRESHOLD;
21. 	  uint8_t 							REGISTER_DATA[REGISTER_DATA_BUFFER_SIZE];
22. 	  uint16_t               			ALS_DATA_CH1;//Reference to uint16_t where IR-only data will be stored
23. 	  uint16_t               			ALS_DATA_CH0;//Reference to uint16_t where visible+IR data will be stored
24. 	  double 							RATIO;
25. 	  double 							ALS_LUX;
26. }GebraBit_LTR303ALS;
27.  

				
			

اعلان توابع

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

				
					1. extern void GB_LTR303ALS_Read_Reg_Data(uint8_t regAddr,  uint8_t *data)	;
 2. extern void GB_LTR303ALS_Burst_Read(uint8_t regAddr,  uint8_t *data, uint16_t byteQuantity);
 3. extern void GB_LTR303ALS_Read_Reg_Bits (uint8_t regAddr, uint8_t start_bit, uint8_t len, uint8_t* data);	
 4. extern void GB_LTR303ALS_Write_Command( uint8_t cmd);
 5. extern void GB_LTR303ALS_Write_Reg_Data(uint8_t regAddr,  uint8_t data)	;
 6. extern void GB_LTR303ALS_Write_Reg_Bits(uint8_t regAddr, uint8_t start_bit, uint8_t len, uint8_t data);
 7. /********************************************************
 8.  *       Declare LTR303ALS Configuration Functions         *
 9.  ********************************************************/
10. extern void GB_LTR303ALS_Soft_Reset ( GebraBit_LTR303ALS * LTR303ALS )  ;
11. extern void GB_LTR303ALS_ALS_Mode ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_ALS_Mode als ) ;
12. extern void GB_LTR303ALS_ALS_Gain ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_ALS_Gain gain )  ;
13. extern void GB_LTR303ALS_Measurement_Repeat_Rate ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_Measurement_Rate rate )  ;
14. extern void GB_LTR303ALS_Integration_Time ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_Integration_Time intg )  ;
15. extern void GB_LTR303ALS_Read_Part_ID ( GebraBit_LTR303ALS * LTR303ALS  )  ;
16. extern void GB_LTR303ALS_Read_Manufacture_ID ( GebraBit_LTR303ALS * LTR303ALS )  ;
17. extern void GB_LTR303ALS_Read_ALS_STATUS ( GebraBit_LTR303ALS * LTR303ALS )  ;
18. extern void GB_LTR303ALS_Interrupt_Mode ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_Interrupt_Mode mode )  ;
19. extern void GB_LTR303ALS_Interrupt_Polarity ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_Interrupt_Polarity polar )  ;
20. extern void GB_LTR303ALS_Interrupt_Persist ( GebraBit_LTR303ALS * LTR303ALS , LTR303ALS_Interrupt_Persist persist )  ;
21. extern void GB_LTR303ALS_Interrupt_Upper_Limitation ( GebraBit_LTR303ALS * LTR303ALS , uint16_t limit );
22. extern void GB_LTR303ALS_Interrupt_Lower_Limitation ( GebraBit_LTR303ALS * LTR303ALS , uint16_t limit )  ;
23. extern void GB_LTR303ALS_initialize( GebraBit_LTR303ALS * LTR303ALS )  ;
24. extern void GB_LTR303ALS_Configuration(GebraBit_LTR303ALS * LTR303ALS)  ;
25. extern void GB_LTR303ALS_Get_ALS_CH0_CH1_DATA(GebraBit_LTR303ALS * LTR303ALS);
26. extern void GB_LTR303ALS_Lux_Reading(GebraBit_LTR303ALS * LTR303ALS);
27. extern void GB_LTR303ALS_Get_Data(GebraBit_LTR303ALS * LTR303ALS);

				
			

فایل سورس GebraBit_LTR303ALS.c

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

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

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

شرح فایل main.c

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

				
					/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
GebraBit_LTR303ALS LTR303ALS_Module;
/* USER CODE END PTD */

				
			

در بخش بعدی کد نوشته شده، با استفاده از تابع  GB_LTR303ALS_initialize(&LTR303ALS_Module) و GB_LTR303ALS_Configuration(&LTR303ALS_Module) ماژول GebraBit LTR303ALS را مقدار دهی می کنیم و در نهایت در قسمت while برنامه ،داده را از سنسور خوانده و مقادیر ALS  و IR به طور پیوسته دریافت میشود:

				
					1. /* USER CODE BEGIN 2 */
 2. 	GB_LTR303ALS_initialize(&LTR303ALS_Module);
 3. 	GB_LTR303ALS_Configuration(&LTR303ALS_Module);
 4.   /* USER CODE END 2 */
 5.  
 6.   /* Infinite loop */
 7.   /* USER CODE BEGIN WHILE */
 8.   while (1)
 9.   {
10.     /* USER CODE END WHILE */
11.  
12.     /* USER CODE BEGIN 3 */
13. 		GB_LTR303ALS_Get_Data(&LTR303ALS_Module);
14.   }
15.   /* USER CODE END 3 */
16. }
17.  

				
			

متن کد فایل main.c:

				
					  1. /* USER CODE BEGIN Header */
  2. /*
  3.  * ________________________________________________________________________________________________________
  4.  * Copyright (c) 2020 GebraBit Inc. All rights reserved.
  5.  *
  6.  * This software, related documentation and any modifications thereto (collectively “Software”) is subject
  7.  * to GebraBit and its licensors' intellectual property rights under U.S. and international copyright
  8.  * and other intellectual property rights laws. 
  9.  *
 10.  * GebraBit and its licensors retain all intellectual property and proprietary rights in and to the Software
 11.  * and any use, reproduction, disclosure or distribution of the Software without an express license agreement
 12.  * from GebraBit is strictly prohibited.
 13.  
 14.  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT 
 15.  * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT IN  
 16.  * NO EVENT SHALL GebraBit BE LIABLE FOR ANY DIRECT, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, 
 17.  * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
 18.  * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 19.  * OF THE SOFTWARE.
 20.  * ________________________________________________________________________________________________________
 21.  */
 22. /**
 23.   ******************************************************************************
 24.   * @file           : main.c
 25.   * @brief          : Main program body
 26. 	* @Author       	: Mehrdad Zeinali
 27.   ******************************************************************************
 28.   * @attention
 29.   *
 30.   * Copyright (c) 2022 STMicroelectronics.
 31.   * All rights reserved.
 32.   *
 33.   * This software is licensed under terms that can be found in the LICENSE file
 34.   * in the root directory of this software component.
 35.   * If no LICENSE file comes with this software, it is provided AS-IS.
 36.   *
 37.   ******************************************************************************
 38.   */
 39. /* USER CODE END Header */
 40. /* Includes ------------------------------------------------------------------*/
 41. #include "main.h"
 42. #include "i2c.h"
 43. #include "gpio.h"
 44.  
 45. /* Private includes ----------------------------------------------------------*/
 46. /* USER CODE BEGIN Includes */
 47. #include "LTR303ALS.h"
 48. /* USER CODE END Includes */
 49.  
 50. /* Private typedef -----------------------------------------------------------*/
 51. /* USER CODE BEGIN PTD */
 52. GebraBit_LTR303ALS LTR303ALS_Module;
 53. /* USER CODE END PTD */
 54.  
 55. /* Private define ------------------------------------------------------------*/
 56. /* USER CODE BEGIN PD */
 57. /* USER CODE END PD */
 58.  
 59. /* Private macro -------------------------------------------------------------*/
 60. /* USER CODE BEGIN PM */
 61.  
 62. /* USER CODE END PM */
 63.  
 64. /* Private variables ---------------------------------------------------------*/
 65.  
 66. /* USER CODE BEGIN PV */
 67.  
 68. /* USER CODE END PV */
 69.  
 70. /* Private function prototypes -----------------------------------------------*/
 71. void SystemClock_Config(void);
 72. /* USER CODE BEGIN PFP */
 73.  
 74. /* USER CODE END PFP */
 75.  
 76. /* Private user code ---------------------------------------------------------*/
 77. /* USER CODE BEGIN 0 */
 78.  
 79. /* USER CODE END 0 */
 80.  
 81. /**
 82.   * @brief  The application entry point.
 83.   * @retval int
 84.   */
 85. int main(void)
 86. {
 87.   /* USER CODE BEGIN 1 */
 88.  
 89.   /* USER CODE END 1 */
 90.  
 91.   /* MCU Configuration--------------------------------------------------------*/
 92.  
 93.   /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
 94.   HAL_Init();
 95.  
 96.   /* USER CODE BEGIN Init */
 97.  
 98.   /* USER CODE END Init */
 99.  
100.   /* Configure the system clock */
101.   SystemClock_Config();
102.  
103.   /* USER CODE BEGIN SysInit */
104.  
105.   /* USER CODE END SysInit */
106.  
107.   /* Initialize all configured peripherals */
108.   MX_GPIO_Init();
109.   MX_I2C1_Init();
110.   /* USER CODE BEGIN 2 */	
111.   GB_LTR303ALS_initialize(<R303ALS_Module);
112.   GB_LTR303ALS_Configuration(<R303ALS_Module);
113.   /* USER CODE END 2 */
114.  
115.   /* Infinite loop */
116.   /* USER CODE BEGIN WHILE */
117.   while (1)
118.   {
119.     /* USER CODE END WHILE */
120.  
121.     /* USER CODE BEGIN 3 */
122. 		GB_LTR303ALS_Get_Data(<R303ALS_Module);
123.   }
124.   /* USER CODE END 3 */
125. }
126.  
127. /**
128.   * @brief System Clock Configuration
129.   * @retval None
130.   */
131. void SystemClock_Config(void)
132. {
133.   RCC_OscInitTypeDef RCC_OscInitStruct = {0};
134.   RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
135.   RCC_PeriphCLKInitTypeDef PeriphClkInit = {0};
136.  
137.   /** Initializes the RCC Oscillators according to the specified parameters
138.   * in the RCC_OscInitTypeDef structure.
139.   */
140.   RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
141.   RCC_OscInitStruct.HSEState = RCC_HSE_ON;
142.   RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
143.   RCC_OscInitStruct.HSIState = RCC_HSI_ON;
144.   RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
145.   RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
146.   RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
147.   if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
148.   {
149.     Error_Handler();
150.   }
151.  
152.   /** Initializes the CPU, AHB and APB buses clocks
153.   */
154.   RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
155.                               |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
156.   RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
157.   RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
158.   RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
159.   RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
160.  
161.   if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
162.   {
163.     Error_Handler();
164.   }
165.   PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_I2C1;
166.   PeriphClkInit.I2c1ClockSelection = RCC_I2C1CLKSOURCE_SYSCLK;
167.   if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
168.   {
169.     Error_Handler();
170.   }
171. }
172.  
173. /* USER CODE BEGIN 4 */
174.  
175. /* USER CODE END 4 */
176.  
177. /**
178.   * @brief  This function is executed in case of error occurrence.
179.   * @retval None
180.   */
181. void Error_Handler(void)
182. {
183.   /* USER CODE BEGIN Error_Handler_Debug */
184.   /* User can add his own implementation to report the HAL error return state */
185.   __disable_irq();
186.   while (1)
187.   {
188.   }
189.   /* USER CODE END Error_Handler_Debug */
190. }
191.  
192. #ifdef  USE_FULL_ASSERT
193. /**
194.   * @brief  Reports the name of the source file and the source line number
195.   *         where the assert_param error has occurred.
196.   * @param  file: pointer to the source file name
197.   * @param  line: assert_param error line source number
198.   * @retval None
199.   */
200. void assert_failed(uint8_t *file, uint32_t line)
201. {
202.   /* USER CODE BEGIN 6 */
203.   /* User can add his own implementation to report the file name and line number,
204.      ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
205.   /* USER CODE END 6 */
206. }
207. #endif /* USE_FULL_ASSERT */
208.  

				
			

خروجی برنامه

بعد از تولید پروژه Keil با استفاده از STM32CubeMX و اضافه کردن کتابخانه، پروگرامر STLINK V2 را با استفاده از آداپتور تبدیل STLINKV2 به GebraBit STM32F303 متصل می کنیم:

آداپتور تبدیل :STLINKV2

  با اتصال پروگرامر STLINK V2 به GebraBit STM32F303 دیگر نیازی به اعمال تغذیه به  ماژول های GebraBit STM32F303 و GebraBit LTR303ALS نمی باشد، زیرا ولتاژ کاری خود را مستقیما از پروگرامر STLINK V2 دریافت میکنند.

در نهایت وارد حالت Debug شده و با اضافه کردن LTR303ALS_Module به پنجره  watch و اجرای برنامه ، تغییرات مقادیر IR و ALS ماژول GebraBit LTR303ALS را مشاهده می کنیم:

در ادامه می توانید پروژه راه اندازی ماژول GebraBit LTR303ALS را با استفاده از ماژول GebraBit STM32F303 در محیط Keil و فایل STM32CubeMX ، شماتیک ماژول ها و دیتاشیت LTR303ALS را دانلود کنید.

ویدیو خروجی برنامه

این مقاله را با دوستانتان به اشتراک بگذارید!

دیدگاهتان را بنویسید

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

Shopping cart
Start typing to see posts you are looking for.

Sign in

No account yet?