🐥 🌾 🦒 Arduino के लिए ओपनग्लिश लाइब्रेरी का रस्मीकरण 🧑🏿‍🤝‍🧑🏻 👽 👤

Ks0108 नियंत्रक या इसके एनालॉग्स के साथ ग्राफिक डिस्प्ले पर रूसी-भाषा का पाठ लिखना अभी भी महत्वपूर्ण कठिनाइयों को प्रस्तुत करता है। OpenGLCD पुस्तकालय, जिसे आधिकारिक Arduino साइटों द्वारा अनुशंसित किया गया है, इस समय नवीनतम संस्करण के मूल कॉन्फ़िगरेशन में फ़ॉन्ट cp437font8x8 को छोड़कर कोई भी सिरिलिक फोंट नहीं है। व्यवहार में, यह बहुत कम उपयोग है, क्योंकि रूसी-भाषा के भाग में यह Win-1251 एन्कोडिंग का समर्थन करता है । इसलिए, इस तरह के फ़ॉन्ट में वर्णों को आउटपुट करने के लिए, उन्हें या तो ऑक्टल या हेक्साडेसिमल कोड के साथ पाठ में डाला जाना चाहिए (और साथ ही साथ लोअरकेस अक्षर "I" के साथ अस्पष्टताएं हैं, जैसा कि फ़ॉन्ट निर्माता टिप्पणी में इंगित करता है), या फिर भी एक अलग रूपांतरण फ़ंक्शन लिखें, इस तरह से arduinec कियाAdafruit-GFX लाइब्रेरी के लिए।

इसके अलावा, cp437font8x8 128x64 पिक्सेल स्क्रीन के लिए बड़ा है। इस तरह के डिस्प्ले पर सहायक लेबल के लिए इष्टतम फ़ॉन्ट का आकार System5x7 रहता है। यहां हम सिस्टम फॉन्ट के Russification पर ध्यान केंद्रित करते हैं, हालांकि पाठक स्वतंत्र रूप से इस नमूने के आधार पर किसी भी अन्य फॉन्ट को Russify कर सकता है (विशेषकर यदि यह एक बड़ी स्क्रीन है)।

क्या समस्या है?

आरंभ करने के लिए, आइए समस्या की जड़ों में खुदाई करें। Arduino IDE एक नियमित रूप से विंडोज टेक्स्ट एडिटर है, जो यूनिवर्सल UTF-8 एन्कोडिंग में काम करता है , जैसे विंडोज के आधुनिक संस्करणों में कोई अन्य (नोटपैड, उदाहरण के लिए)। UTF-8 UNICODE मल्टीबाइट एन्कोडिंग का एक किफायती संस्करण है। UTF-8 में, अंग्रेजी भाषा के अक्षर, संख्या, अर्धविराम-कोष्ठक और अन्य सभी प्रकार के चिह्न एक बाइट द्वारा दर्शाए जाते हैं जो मानक ASCII एन्कोडिंग से मेल खाते हैं । इसलिए, स्केच कोड में उनका प्रतिनिधित्व किसी भी कठिनाइयों को प्रस्तुत नहीं करता है: संकलन के बाद, अंग्रेजी-भाषा के पात्रों के स्ट्रिंग को बिना परिवर्तन के लोड करने योग्य हेक्स-फ़ाइल में स्थानांतरित किया जाता है और 8-बिट नियंत्रक के लिए स्पष्ट है, जैसा कि वे कहते हैं, "अनुवाद के बिना"।

इस रूपांतरण की प्रक्रिया में, प्रत्येक चरित्र, जैसा कि किसी भी प्रोग्रामिंग भाषा में किसी भी कार्यक्रम में होता है, को सीधे उसके कोड के रूप में दर्शाया जाता है, अर्थात, फ़ॉन्ट तालिका में क्रम संख्या, जिसमें से प्रोग्राम संबंधित वर्ण की ग्राफिक शैली को निकालता है। OpenGLCD लाइब्रेरी की System5x7.h फ़ॉन्ट फ़ाइल में, वर्णों की संख्या को टाइप uint8_t के font_Char_Count चर द्वारा दर्शाया गया है, अर्थात यह एक बाइट से अधिक नहीं हो सकता है। इसलिए, Cyrillic वर्ण, जो UTF-8 में दो बाइट्स पर कब्जा करते हैं, सामान्य तरीके से नियंत्रक को प्रेषित नहीं किया जा सकता है।

पिछला प्रयास

, . Arduino 1.0.x (, , 1.6.0) , ( , UTF-8 , 0xD0, 0xD1). GLCD v3, , UTF-8 ( 0x80 0xBF). « ». — Arduino IDE 1.0.x GLCD v3, .

Arduino IDE . , , . .

निर्णय

लेखक लाइब्रेरी फ़ंक्शंस के बॉल्स में नहीं गया था, लेकिन ओपनजीएलसीडी के लिए एक ऐड-इन आउटस्ट्रीट () फ़ंक्शन के रूप में लिखा था , जो कि इनपुट स्ट्रिंग के सभी तत्वों से अधिक होता है , जो स्विच चयन ऑपरेटर के माध्यम से गुजरता है । यह स्ट्रिंग से सिरिलिक वर्णों को पकड़ता है और उन्हें उन्नत फ़ॉन्ट फ़ाइल System5x7R.h के अनुरूप सिंगल-बाइट कोड के साथ बदलता है ।

उदाहरण के लिए, राजधानी रूसी पत्र "एफ" के लिए, प्रतिस्थापन स्ट्रिंग इस तरह होगा:

case '': GLCD.PutChar(0xA4); break;

यहाँ 0xA4 UTF-8 में "F" अक्षर के एन्कोडिंग का निम्न बाइट है (ऊपर लिंक देखें)। इस एन्कोडिंग के अनुसार, एक नया फ़ॉन्ट फ़ाइल System5x7R.h संकलित किया गया है । सिद्धांत रूप में, फ़ॉन्ट में इस दृष्टिकोण के साथ, आप रूसी वर्णों के किसी भी एन्कोडिंग और किसी अन्य ग्लिफ़ का उपयोग कर सकते हैं जिसे आप फ़ॉन्ट में सम्मिलित करना चाहते हैं। यदि केवल उनकी कुल संख्या 128 टुकड़े से अधिक नहीं है: तालिका की शुरुआत से 0x7F वर्ण (127 मानक ASCII तालिका का अंतिम चरित्र) है, तो फ़ॉन्ट को अक्षुण्ण छोड़ना उचित है।

सच है, मैंने अपने आप को ASCII तालिका के साथ कुछ स्वतंत्रताओं की अनुमति दी। तथ्य यह है कि मूल फ़ॉन्ट में System5x7.h हैडिग्री आइकन को तालिका की अंतिम पंक्ति में रखा गया है, जिसमें 0x80 वर्ण है, जो हमारे पास पहले से ही सिरिलिक में है। UTF-8 के अनुसार सिरिलिक तालिका के निर्माण की प्रक्रिया का उल्लंघन न करने के लिए, इस लाइन को फ़ाइल से फेंक दिया गया था। और ASCII वर्ण "~" (संख्या 0x7E) के बजाय डिग्री आइकन संलग्न है, जो कि फ़ॉन्ट में अभी भी अपने इच्छित उद्देश्य के लिए उपयोग नहीं किया गया था। लेकिन ऐसा प्रतिस्थापन आपको "~" प्रतीक के रूप में कीबोर्ड से सीधे स्केच पाठ में डिग्री आइकन दर्ज करने की अनुमति देता है।

एक और स्वतंत्रता इस तथ्य के कारण है कि लेखक क्रॉस-आउट शून्य को बर्दाश्त नहीं करता है - एडीसीयू और मोनोक्रोम पाठ डिस्प्ले का पुरातन। इसलिए, आधुनिक फ़ॉन्ट में शून्य को "O" अक्षर के ग्लिफ़ द्वारा बदल दिया जाता है। जो लोग शुद्ध सिद्धांतों का पालन करते हैं, वे केवल System5x7R.h फ़ॉन्ट फ़ाइल को हटा सकते हैंइस प्रविष्टि (पार किए गए शून्य के पुराने ग्लिफ़ को बाहर टिप्पणी की गई है, इसका कोड 0x30 है)।

आधुनिक ओपनजीएलसीडी लाइब्रेरी में , जिसे आप लेख के अंत में लिंक से डाउनलोड कर सकते हैं, एक और सुधार किया गया है - ks0108 नियंत्रक के साथ प्रदर्शित करने के लिए पिन का कनेक्शन क्रम बदल दिया गया है। पुस्तकालय के लेखक ने इस आदेश को क्यों चुना ( Arduino आधिकारिक वेबसाइट पर लिंक पर तालिका देखें ) अज्ञात है। उन्नत संस्करण में, डिस्प्ले कनेक्शन (उदाहरण के लिए, लोकप्रिय MT-12864J चयनित है) इस योजना के अनुसार किया जाता है:

MT-12864J कनेक्शन आरेख

चर रोकनेवाला R1 निर्माता की सिफारिश के अनुसार यहां जुड़ा हुआ है , और रोकनेवाला आर 2 बैकलाइट वर्तमान को सीमित करने का कार्य करता है यदि यह 5 वी वोल्टेज से नहीं जुड़ा हुआ है, लेकिन सीधे एक उच्च वोल्टेज के साथ इनपुट पावर स्रोत (विन अरुडिनो आउटपुट) से जुड़ा है।

लैटिन के साथ मिश्रित रूसी वर्णमाला MT-12864J के प्रदर्शन का एक उदाहरण, संख्याओं और डिग्री आइकन को फोटो में दिखाया गया है:

इस उदाहरण के लिए स्केच पाठ:

रूसी वर्णमाला के समापन के साथ स्केच का पाठ

#include <openGLCD.h> // 
#include <outstr.h> //     
#include <System5x7R.h> //    

void setup() {
      GLCD.Init(); //
      GLCD.ClearScreen();
      }

void loop()
      {
      GLCD.SelectFont(System5x7R);  // 
      GLCD.CursorTo(0,0); //     
      //  - : 
      outstr("ABC \n");
      outstr("PRQ \n");
      outstr("nts \n");
      outstr("xyz \n");
      GLCD.println("1234567890");
      GLCD.CursorTo(19,4); //     5-  
      GLCD.print("~C"); //  
      GLCD.println("@;/.,|<>()=-_{}\"'");
            GLCD.CursorTo(4,7); //    4  8
      GLCD.print("MT-12864J");
      }

चूंकि outstr.h फ़ंक्शन और System5x7R.h फॉन्ट वाली फाइलें अपग्रेड लाइब्रेरी की रूट डायरेक्टरी में स्थित होती हैं , इसलिए उन्हें #include निर्देश का उपयोग करके स्केच की शुरुआत में अलग लिंक के साथ रखा जाना चाहिए । अंग्रेजी-भाषा के शिलालेखों के लिए, मानक प्रिंटल / प्रिंट फ़ंक्शंस का उपयोग करना अभी भी सुविधाजनक है , लेकिन अगर आपको रूसी पाठ में एक पंक्ति का अनुवाद करने की आवश्यकता है, तो आपको स्पष्ट रूप से वर्ण "\ n" निर्दिष्ट करना होगा।

आप यहां पुस्तकालय का सही संस्करण डाउनलोड कर सकते हैं । अनपैक्ड लाइब्रेरी ( ओपनजीएलसीडी फ़ोल्डर ) को अरुडिनो \ लाइब्रेरीज़ फ़ोल्डर में रखा जाना चाहिएहमेशा की तरह। एक उदाहरण स्केच अलग से एक ही संग्रह में स्थित है (पुस्तकालय के उदाहरण फ़ोल्डर में नहीं)। इस पुस्तकालय के अनुसार ks0108 नियंत्रक के साथ एक डिस्प्ले कनेक्ट करना ऊपर चित्र में दिखाया गया है। आप एक अतिरिक्त जोड़ने पिन के आदेश बदलना चाहते हैं, करने के लिए नीचे ट्रैक फ़ोल्डर Arduino \ पुस्तकालयों \ openGLCD \ config \ ks0108 फ़ाइल PinConfig_ks0108-Uno.h और शीर्षक «डाटा पिन परिभाषाओं» जारी है, लेखक को सही करने पर ध्यान केंद्रित कर के तहत स्ट्रिंग में यह संपादित करें।

अगले प्रकाशन में, हम लोअरकेस डिस्प्ले के रसिफिकेशन से निपटने की कोशिश करेंगे। जैसा कि आप देखेंगे, उनके साथ सब कुछ आसान और अधिक जटिल है।

Arduino के लिए ओपनग्लिश लाइब्रेरी का रस्मीकरण

क्या समस्या है?

निर्णय

More articles: