OLED-дисплей, вывод текста на русском языке в Arduino IDE
Как и обещал в предыдущем уроке ДисплейSSD1306 подключаем к Arduino. Выводим текст,рисуем фигуры. расскажу, как вывести текст на русском языке на 0,96-дюймовый SSD1306 OLED-дисплей в среде Arduino IDE.
Для урока понадодиться:
- ARDUINO NANO. Купить можно на AliExpress или в России.
- OLED-дисплей SSD1306. Купить можно на AliExpress.
- Провод DuPont. Купить можно на AliExpress или в России.
- Плата макетная беспаечная 55х82х8.5 мм. Купить можно на AliExpress или в России.
С учетом того, что я уже показывал, как работать с дисплеем, вам нужно сделать следующее, чтобы русифицировать дисплей :
1. Установить библиотеки Adafruit : библиотеку Adafruit_SSD1306 и библиотеку Adafruit_GFX . Как их установить, я рассматривал в предыдущем уроке.
2. Скачать файл glcdfont.c и заменить его в библиотеке Adafruit-GFX. Библиотека находится C:UsersUSERDocumentsArduinolibrariesAdafruit_GFX_Library. У вас путь до библиотеки может отличаться.
3. В скетч нужно добавить функцию перекодировки русских букв из UTF-8 в Win-1251 . Добавить функцию можно в самом низу кода.
/* Функция перекодировки русских букв из UTF-8 в Win-1251 */
String utf8rus(String source) { int i,k; String target; unsigned char n; char m[2] = { '0', ' 0' };
k = source.length(); i = 0;
while (i < k) { n = source[i]; i++; if (n >= 0xC0) {
switch (n) {
case 0xD0: { n = source[i]; i++; if (n == 0x81) { n = 0xA8; break; }
if (n >= 0x90 && n <= 0xBF) n = n + 0x30; break; }
case 0xD1: { n = source[i]; i++; if (n == 0x91) { n = 0xB8; break; }
if (n >= 0x80 && n <= 0x8F) n = n + 0x70; break; } } }
m[0] = n; target = target + String(m); } return target; }
Добавить в блок void setup() {} следующую строчку кода.
display.cp437(true);
При выводе русского текста использовать функцию utf8rus().
За основу возьмите скетч из урока 15. вывод “Hello, world!” на OLED-дисплей .
И сделайте все по инструкции выше . Замените строчку
display.println("Hello,world!");
на
display.println(utf8rus("Привет МИР!"));
В итоге. у вас должен получится код:
#include
#include
#include
#include
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels
// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
void setup() {
Serial.begin(115200);
if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
Serial.println("SSD1306 allocation failed");
for(;;); }
delay(2000);
display.cp437(true);
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(WHITE);
display.setCursor(0,20);
display.println(utf8rus("Привет МИР!"));
display.display(); delay(2000); }
void loop() { } /* Функция перекодировки русских букв из UTF-8 в Win-1251 */
String utf8rus(String source) {
int i,k; String target; unsigned char n; char m[2] = { '0', ' 0' };
k = source.length();
i = 0;
while (i < k) { n = source[i];
i++;
if (n >= 0xC0) { switch (n) { case 0xD0: { n = source[i]; i++;
if (n == 0x81) { n = 0xA8; break; }
if (n >= 0x90 && n <= 0xBF) n = n + 0x30; break; }
case 0xD1: { n = source[i]; i++;
if (n == 0x91) { n = 0xB8; break; }
if (n >= 0x80 && n <= 0x8F) n = n + 0x70; break; } } }
m[0] = n; target = target + String(m); } return target; }
Вы уже умеете работать с выводом теста на дисплей , поэтому сможете отформатировать его: изменить размер текста и расположить по центру дисплея , чтобы получилось вот так.
Скетч данного примера будет вот таким.
#include
#include
#include
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels
// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
void setup() {
Serial.begin(115200);
if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // Address 0x3D for 128x64
Serial.println(F("SSD1306 allocation failed"));
for(;;);
}
delay(2000);
display.cp437(true);
display.clearDisplay();
display.setTextColor(WHITE);
display.setCursor(27, 0);
// Display static text
display.setTextSize(2); // Draw 2X-scale text
display.println(utf8rus("Привет"));
display.setCursor(32, 30);
// Display static text
display.setTextSize(3); // Draw 3X-scale text
display.println(utf8rus("МИР!"));
display.display();
}
void loop() {
}
/* Recode russian fonts from UTF-8 to Windows-1251 */
String utf8rus(String source)
{
int i,k;
String target;
unsigned char n;
char m[2] = { '0', ' 0' };
k = source.length(); i = 0;
while (i < k) {
n = source[i]; i++;
if (n >= 0xC0) {
switch (n) {
case 0xD0: {
n = source[i]; i++;
if (n == 0x81) { n = 0xA8; break; }
if (n >= 0x90 && n <= 0xBF) n = n + 0x30;
break;
}
case 0xD1: {
n = source[i]; i++;
if (n == 0x91) { n = 0xB8; break; }
if (n >= 0x80 && n <= 0x8F) n = n + 0x70;
break;
}
}
}
m[0] = n; target = target + String(m);
}
return target;
}
Ниже скетч вывода русского алфавита и вывода некоторых спец символов на 0,96-дюймовый SSD1306 OLED-дисплем в среде Arduino IDE :
#include
#include
#include
#include
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels
// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
void setup() {
Serial.begin(115200);
if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {
Serial.println("SSD1306 allocation failed");
for(;;);
}
delay(2000);
display.cp437(true);
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(WHITE);
display.setCursor(0,0);
display.println(utf8rus("АБВГДЕЖЗИЙКЛМНОП"));
display.println(utf8rus("РСТУФХЦЧШЩЪЫЬЭЮЯ"));
display.println(utf8rus("абвгдежзийклмноп"));
display.println(utf8rus("рстуфхцчшщъыьэюя"));
display.println(utf8rus("Ёё123ABCabc!@#xBCxBD"));
display.println(utf8rus("10x83 10x8Ax82 10x81x80 2x85"));
display.display();
delay(2000);
}
void loop() {
}
/* Функция перекодировки русских букв из UTF-8 в Win-1251 */
String utf8rus(String source)
{
int i,k;
String target;
unsigned char n;
char m[2] = { '0', ' 0' };
k = source.length(); i = 0;
while (i < k) {
n = source[i]; i++;
if (n >= 0xC0) {
switch (n) {
case 0xD0: {
n = source[i]; i++;
if (n == 0x81) { n = 0xA8; break; }
if (n >= 0x90 && n <= 0xBF) n = n + 0x30;
break;
}
case 0xD1: {
n = source[i]; i++;
if (n == 0x91) { n = 0xB8; break; }
if (n >= 0x80 && n <= 0x8F) n = n + 0x70;
break;
}
}
}
m[0] = n; target = target + String(m);
}
return target;
}
И напоследок, вот такой пример вывода спец символов букв и цифр , найден на просторах интернета.
#include
#include
#include
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels
// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
unsigned char i1,i2,c3;
void setup() {
Serial.begin(115200);
if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // Address 0x3D for 128x64
Serial.println(F("SSD1306 allocation failed"));
for(;;);
}
delay(2000);
display.cp437(true);
display.clearDisplay();
}
void loop() {
TEST_display_1();
delay(10000);
TEST_display_2();
delay(10000);
TEST_display_3();
delay(8000);
TEST_display_4();
delay(4000);
}
void TEST_display_1()
{
display.clearDisplay();
display.setTextColor(WHITE);
display.setTextSize(1);
display.setCursor(0,0);
for(i1=0; i1<8; i1++) {
for(i2=0; i2<16; i2++) {
c3=i1*16+i2;
if(c3 == 0x0A || c3 == 0x0D) display.print(" ");
else display.write(c3);
}
display.println("");
}
display.display();
}
void TEST_display_2()
{
display.clearDisplay();
display.setTextColor(WHITE);
display.setTextSize(1);
display.setCursor(0,0);
for(i1=8; i1<16; i1++) {
for(i2=0; i2<16; i2++)
display.write(i1*16+i2);
display.println("");
}
display.display();
}
void TEST_display_3()
{
display.clearDisplay();
display.setTextColor(WHITE);
display.setTextSize(1);
display.setCursor(0,0);
display.println(utf8rus("АБВГДЕЖЗИЙКЛМНОП"));
display.println(utf8rus("РСТУФХЦЧШЩЪЫЬЭЮЯ"));
display.println(utf8rus("абвгдежзийклмноп"));
display.println(utf8rus("рстуфхцчшщъыьэюя"));
display.println(utf8rus("Ёё123ABCabc!@#xBCxBD"));
display.println(utf8rus("10x83 10x8Ax82 10x81x80 2x85"));
display.display();
}
void TEST_display_4()
{
display.clearDisplay();
display.setTextColor(WHITE);
display.setCursor(0,0);
display.setTextSize(1);
display.println(utf8rus("Размер шрифта 1"));
display.setTextSize(2);
display.println(utf8rus("Размер 2"));
display.setTextSize(3);
display.println(utf8rus("Разм 3"));
display.display();
}
/* Функция перекодировки русских букв из UTF-8 в Win-1251 */
String utf8rus(String source)
{
int i,k;
String target;
unsigned char n;
char m[2] = { '0', ' 0' };
k = source.length(); i = 0;
while (i < k) {
n = source[i]; i++;
if (n >= 0xC0) {
switch (n) {
case 0xD0: {
n = source[i]; i++;
if (n == 0x81) { n = 0xA8; break; }
if (n >= 0x90 && n <= 0xBF) n = n + 0x30;
break;
}
case 0xD1: {
n = source[i]; i++;
if (n == 0x91) { n = 0xB8; break; }
if (n >= 0x80 && n <= 0x8F) n = n + 0x70;
break;
}
}
}
m[0] = n; target = target + String(m);
}
return target;
}
Данный метод вывода русского алфавита работает не только с SSD1306, но и с дисплеем Nokia 5110 (PCD8544), и с дисплеем 2.8" TFT Touch Shield 320x240.
На этом возможности дисплея не заканчиваются, одна из них - выводить растровые изображения, но об этом как-нибудь в другой раз.
Дата: 2025-05-09 Автор: Статья с веб источника Просмотров: 275
Контакты
Если у Вас есть вопросы, мы с удовольствием на них ответим.
Адрес:
Мурманская область, г.Полярный ул. Красный Горн, д.16, 3-й этаж, 34 каб.
Почта:
komarov.1988@inbox.ru
Телефон:
+7 9646829261