Myagkij: /* Функции */

2024-02-18T07:33:15Z

Функции

← Предыдущая версия		Версия от 11:33, 18 февраля 2024
Строка 112:		Строка 112:
	===Получение сообщения===		===Получение сообщения===

	* <syntaxhighlight lang="c">int messageBuild()</syntaxhighlight> Проверяет, завершено ли сообщение. Если завершено, возвращает размер сообщения, включая пробелы. ~~'''ВНИМАНИЕ: если~~ вы вызовите эту функцию второй раз, это сбросит предыдущее сообщение!~~'''~~		* <syntaxhighlight lang="c">int messageBuild()</syntaxhighlight> Проверяет, завершено ли сообщение. Если завершено, возвращает размер сообщения, включая пробелы.
	* <syntaxhighlight lang="c">char messageGetChar()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве символа. Если доступных слов нет, возвращает '''«0»'''. ~~'''ВНИМАНИЕ: если~~ вы отправите что-то вроде «foo», она вернет «f» и проигнорирует «oo».~~'''~~		{{Внимание1\|Если вы вызовите эту функцию второй раз, это сбросит предыдущее сообщение!}}
			* <syntaxhighlight lang="c">char messageGetChar()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве символа. Если доступных слов нет, возвращает '''«0»'''.
			{{Внимание1\|Если вы отправите что-то вроде «foo», она вернет «f» и проигнорирует «oo».}}
	* <syntaxhighlight lang="c">int messageGetInt()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве целого числа. Если доступных слов нет, возвращает '''«0»'''.		* <syntaxhighlight lang="c">int messageGetInt()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве целого числа. Если доступных слов нет, возвращает '''«0»'''.

EducationBot в 08:26, 8 июля 2023

2023-07-08T08:26:59Z

← Предыдущая версия		Версия от 12:26, 8 июля 2023
Строка 131:		Строка 131:

	<references />		<references />
			{{Навигационная таблица/Портал/Arduino}}

EducationBot в 07:16, 8 июля 2023

2023-07-08T07:16:10Z

← Предыдущая версия		Версия от 11:16, 8 июля 2023
Строка 132:		Строка 132:
	<references />		<references />

	~~{{Навигационная таблица/Arduino библиотеки}}~~

	~~{{Навигационная таблица/Arduino библиотеки}}~~


	[[Категория:Функция]]		[[Категория:Функция]]
	[[Категория:Библиотека SimpleMessageSystem]]		[[Категория:Библиотека SimpleMessageSystem]]
	[[Категория:SimpleMessageSystem]]		[[Категория:SimpleMessageSystem]]

EducationBot в 08:27, 20 мая 2023

2023-05-20T08:27:49Z

← Предыдущая версия		Версия от 12:27, 20 мая 2023
Строка 3:		Строка 3:
	{{Myagkij-редактор}}		{{Myagkij-редактор}}

	~~{{Черновик}}~~

	=Библиотека SimpleMessageSystem<ref>[http://sweb.cityu.edu.hk/sm2240/11/read_me.pdf sweb.cityu.edu.hk - read_me.pdf]</ref><ref>[http://playground.arduino.cc/Code/SimpleMessageSystem playground.arduino.cc - SimpleMessageSystem]</ref>=		=Библиотека SimpleMessageSystem<ref>[http://sweb.cityu.edu.hk/sm2240/11/read_me.pdf sweb.cityu.edu.hk - read_me.pdf]</ref><ref>[http://playground.arduino.cc/Code/SimpleMessageSystem playground.arduino.cc - SimpleMessageSystem]</ref>=

Myagkij в 16:50, 4 марта 2017

2017-03-04T16:50:07Z

Новая страница

{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

{{Черновик}}

=Библиотека SimpleMessageSystem<ref>[http://sweb.cityu.edu.hk/sm2240/11/read_me.pdf sweb.cityu.edu.hk - read_me.pdf]</ref><ref>[http://playground.arduino.cc/Code/SimpleMessageSystem playground.arduino.cc - SimpleMessageSystem]</ref>=

'''Библиотека SimpleMessageSystem''' упрощает коммуникацию с терминалами и программами, которыми можно управлять при помощи сообщений (к примеру, '''Max/Msp''' или '''Pure Data'''). Поддерживает платы '''Arduino''' версий '''0004''' и выше. Все данные, входящие и исходящие через последовательную коммуникацию, интерпретируются как сообщения формата '''ASCII'''.

Саму библиотеку, а также примеры и инструкции к ней [http://playground.arduino.cc/uploads/Code/SimpleMessageSystem.zip можно скачать отсюда].

'''Главные преимущества библиотеки SimpleMessageSystem''':
* Возможность отправлять, получать и обрабатывать списки символов и целых чисел, присылаемых и отсылаемых платой '''Arduino'''
* Терминальная программа, '''Max/Msp''' и '''Pure Data''' могут коммуницировать при помощи одного и того же кода, используемого для '''Arduino'''
* Может быть адаптирована для отправки, получения и обработки строк
* Пересылаемая информация удобочитаема

'''Главный недостаток''':
* Медленней, чем специализированный последовательный протокол, который обращается с битами и байтами, как с числами, а не '''ASCII'''-символами

==Что такое сообщение?==

'''Сообщение''' – это серия слов, которая заканчивается символом возврата каретки (опционально – символом перевода строки); слова состоят из символов формата '''ASCII''' и разделены пробелами. Выглядит все это следующим образом:

<syntaxhighlight lang="c">
слово 1 (пробел) слово2 (пробел) слово3 (возврат каретки)
</syntaxhighlight>

В текущей версии '''SimpleMessageSystem''' слова могут быть либо одним символом, либо целым числом. Сообщение считается завершенным, если в конце поставлен символ возврата каретки. Это также значит, что теперь его можно обрабатывать в скетче '''Arduino'''.

==Пример кода Arduino номер 1==

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
if (messageBuild()) { // проверяем, завершено ли сообщение
firstChar = messageGetChar()) { // берем первое присланное слово и в виде символа сохраняем его в переменную firstChar
if (firstChar = 'r') { // проверяем, является ли он символом «r»
secondChar = messageGetChar() // берем следующее слово и в виде символа сохраняем его в secondChar
if (firstChar = 'd') // чтобы продолжить, следующим символом должен быть «d»
messageSendChar('d'); // отправляем обратно считанный символ
for (char i=2;i<14;i++) {
messageSendInt(digitalRead(i)); // считываем контакты 2-13
}
messageEnd(); // завершаем сообщение, чтобы отправить его
}
}
}
</syntaxhighlight>

Если этот код получит сообщение '''rd CR''' ('''CR''' означает возврат каретки), то вернет значения всех цифровых контактов в сообщении, имеющем следующую структуру:

<syntaxhighlight lang="c">
d кон2 кон3 кон4 кон5 кон6 кон7 кон8 кон9 кон10 кон11 кон12 кон13 CR
</syntaxhighlight>

==Пример кода Arduino номер 2==

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
if (messageBuild()) { // проверяем, завершено ли сообщение
firstChar = messageGetChar()) { // берем первое присланное слово и в виде символа сохраняем его в переменную firstChar
if (firstChar = 'w') { // проверяем, является ли он символом «w»
int pin = messageGetInt(); // берем следующее слово и в виде целого числа сохраняем его в pin
int state = messageGetInt(); // берем следующее слово и в виде целого числа сохраняем его в state
pinMode(pin,OUTPUT);
digitalWrite(pin,state);
}
</syntaxhighlight>

Если этот код получит сообщение '''w 13 1 CR''' ('''CR''' означает возврат каретки), то выставит '''13'''-ый контакт в состояние [[Arduino:Справочник языка Arduino/Константы/HIGH|HIGH]], в результате чего последняя строчка будет выглядеть как [[Arduino:Справочник языка Arduino/Функции/Цифровой ввод/вывод/digitalWrite()|digitalWrite]](13, [[Arduino:Справочник языка Arduino/Константы/HIGH|HIGH]]). В языке '''Arduino''' [[Arduino:Справочник языка Arduino/Константы/HIGH|HIGH]] – это '''«1»''', а [[Arduino:Справочник языка Arduino/Константы/LOW|LOW]] – это '''«0»'''.

==Как импортировать/установить библиотеку==

# Скачайте '''ZIP'''-файл с '''библиотекой SimpleMessageSystem''' (ссылку смотрите выше).
# Откройте '''IDE Arduino''', кликните на '''Скетч > Подключить библиотеку > Добавить .ZIP библиотеку (Sketch > Include Library > Add .ZIP Library…)''', в появившемся окне укажите путь к скачанному '''ZIP'''-файлу и нажмите '''Open'''.
# Создайте новый скетч (или откройте уже существующий) и кликните на '''Скетч > Подключить библиотеку > SimpleMessageSystem (Sketch > Include Library > SimpleMessageSystem)'''. Когда библиотека будет импортирована, в верхней части скетча появится строчка <syntaxhighlight lang="c">#inlcude SimpleMessageSystem.h</syntaxhighlight>
# Когда вы запустите (скомпилируете) свой код, он также скомпилирует библиотеку '''SimpleMessageSystem'''. Вы получите предупреждающие сообщения, но это «нормально».

==Примеры использования==

Запустите в '''IDE Arduino''' следующий скетч-пример: '''Файл > Примеры > SimpleMessageSystem > SimpleMessageSystem_example_1 (File > Examples > SimpleMessageSystem > SimpleMessageSystem_example_1)'''.

Теперь откройте патч для '''Max/Msp''' или '''Pure Data''', чтобы начать коммуникацию с платой '''Arduino'''.

=== Max/Msp ===

Откройте файл '''SimpleMessageSystem.mxb''' в папке '''MaxMsp Example'''. Используйте абстракции '''max2asciimessage''' и '''asciimessage2max''' в своих патчах '''Max/Msp''', чтобы коммуницировать с платой '''Arduino''', в которую загружена '''библиотека SimpleMessageSystem'''.

=== Pure Data ===

Откройте файл '''SimpleMessageSystem.pd''' в папке '''Pure Data Example'''. Используйте абстракции '''pd2ascii''' и '''ascii2pd''' в своих патчах '''Pure Data''', чтобы коммуницировать с платой '''Arduino''', в которую загружена '''библиотека SimpleMessageSystem'''. Если вы работаете на '''Linux''' и не знаете номер порта, к которому подключена '''Arduino''', воспользуйтесь следующей терминальной командой:

<syntaxhighlight lang="c">
i=0; for f in `ls /dev/tty[US]*`; do echo $i $f; i=$(( $i + 1 )); done
</syntaxhighlight>

==Как пользоваться библиотекой==

===Получение сообщения===

# Вызовите функцию messageBuilt(). Если она возвращает '''«1»''' или больше, это значит, что в конце сообщения стоит символ возврата каретки, то есть оно считается законченным. По сути, функция messageBuilt() возвращает количество символов в сообщении, включая пробелы.
# Извлекаем первое слово, используя функцию messageGetChar() или messageGetInt().
# Повторяем второй шаг для всех входящих слов.

===Отправка сообщения===

# Вызываем функцию messageSendChar() или messageSendInt(), чтобы отправить символ или целое число.
# Повторяем второй шаг для всех символов и чисел, которые хотим отправить. Между вызовами этих функций автоматически ставятся пробелы.
# Вызываем функцию messageEnd(), чтобы отправить символ возврата каретки и тем самым просигнализировать, что сообщение завершено и готово к обработке.

==Функции==

===Получение сообщения===

* <syntaxhighlight lang="c">int messageBuild()</syntaxhighlight> Проверяет, завершено ли сообщение. Если завершено, возвращает размер сообщения, включая пробелы. '''ВНИМАНИЕ: если вы вызовите эту функцию второй раз, это сбросит предыдущее сообщение!'''
* <syntaxhighlight lang="c">char messageGetChar()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве символа. Если доступных слов нет, возвращает '''«0»'''. '''ВНИМАНИЕ: если вы отправите что-то вроде «foo», она вернет «f» и проигнорирует «oo».'''
* <syntaxhighlight lang="c">int messageGetInt()</syntaxhighlight> Если имеется доступное слово, возвращает его в качестве целого числа. Если доступных слов нет, возвращает '''«0»'''.

===Отправка сообщения===

* <syntaxhighlight lang="c">void messageSendChar(char value)</syntaxhighlight> Отправляет символ (автоматически вставляет пробелы в сообщении между каждым отправляемым символом).
* <syntaxhighlight lang="c">void messageSendInt(int value)</syntaxhighlight> Отправляет целое число (автоматически вставляет пробелы в сообщении между каждым отправляемым целым числом).
* <syntaxhighlight lang="c">void messageEnd()</syntaxhighlight> Завершает сообщение, сигнализируя цели, что сообщение готово к обработке.

==Примеры==

* [[Arduino:Примеры/SimpleMessageSystem example 1|SimpleMessageSystem example 1]] - Управление функциями '''Arduino''' при помощи сообщений

=См.также=

=Внешние ссылки=

<references />

{{Навигационная таблица/Arduino библиотеки}}

{{Навигационная таблица/Arduino библиотеки}}

[[Категория:Функция]]
[[Категория:Библиотека SimpleMessageSystem]]
[[Категория:SimpleMessageSystem]]

Arduino:Библиотеки/SimpleMessageSystem - История изменений

Myagkij: /* Функции */

EducationBot в 08:26, 8 июля 2023

EducationBot в 07:16, 8 июля 2023

EducationBot в 08:27, 20 мая 2023

Myagkij в 16:50, 4 марта 2017