با سلام .

معمولا کتابخانه هایی رو که در اختیار دیگران میگزارم ، یک تعدادی فایل داره که به شیوه ی خاصی اونا رو نام گزاری کردم  .

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

 

قبل از اینکه توضیحات بیشتری بدم لطفا یک مثال از این نامگذاری ها رو در تصویر زیر ببینید .

این تصویر مربوط به فایلهای کتابخانه منو هست .

همانطور که در تصویر میبینید ، نام فایلها یک قسمت مشترک دارد که  menu_4pin  هست . که در واقع همان نام کتابخانه است.

نام بعضی از فایلها یک قسمت دوم دارد که با "_" از قسمت اول جداشده است .

که معنا و مفهوم آنها به شرح زیر است :

****************************************

****************************************

فایهایی که نامشان قسمت دوم ندارد:

مثال این نوع فایلها در تصویر بالا  فایلهای menu_4pin.h  و  menu_4pin.c  هستند .

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

****************************************

****************************************

توضیحات قسمت دوم نامها :

**************************

1-  conf : 

  این فایل به صورت  h.    است و تنظیمات کتابخانه منو به صورت ماکرو در این فایل قرار دارد و بوسیله آنها میتوان کتابخانه را در وضعیت خاصی قرار داد . ( مثلا حالت کم حجم تر یا سریعتر یا بعضی امکانات را فعال و غیر فعال کرد .)

 

**************************

2- link :  

کتابخانه نیاز به توابع یا برونسپاری هایی دارد که ارتباطی به کتابخانه مورد نظر  ندارد . این موارد از طریق معرفی در این فایل در دسترس کتابخانه منو قرار میگیرد.

مانند تابعی برای ایجاد تاخیر که HAL_Delay()  یک نمونه آن است یا تابعی برای دسترسی به مقدار فعلی تایم بیس که HAL_GetTick()  یک نمونه از آن است .

 

**************************

3- names:

 این فایل شامل تعریف نامهایی است  که برای راحتی کاربر به منظور استفاده در فایل conf منظور شده است .

 

**************************

4- typedef :

در این فایل تعاریف مربوط به انواع داده( شامل ساختمانها و یونیونها ، انواعی شمارشی و غیره ....) مورد استفاده کتابخانه قرار دارد .

 

**************************

5 - color :

 در این فایل همانطور که از نامش پیداست کدهای مربوط به رنگ مورد استفاده کتابخانه در آن قرار دارد .( lcd ها کد رنگ دارند)

 

**************************

6- command :

این فایل تعاریف ( به صورت اسم ) مربوط به کدهای فرمان کتابخانه را در خود جای داده است (  معمولا این فایل برای سخت افزار ها مانند lcd ها  وجود دارد )

 

**************************

** توجه :

بعضی کتابخانه ها ممکنه یک تعدادی از این فایلها را نداشته باشند .

 

****************************************

****************************************

مطلب در اینجا به پایان رسید .

با سپاس از توجه تان.