Второе решение — избавиться от сущностей, которые эти термины обозначают. Посмотрите снова на этот пример:
сильно влияют на выбор микроконтроллера. В чипах семейства AVR только порты общего назначения (GPIO). Максимум, что они умеют, — широтноимпульсная модуляция сигнала и аналого-цифровое преобразование.
Нужно ли нам знать о ШИМ и ЛПЦ, когда мы выбираем первый микроконтроллер для любительского проекта? Кажется, что не нужно. Эта информация здесь необязательная, удалим ее:
Контроллеры управляют другими частями вашего проекта через специальные вводы и выводы — их называют портами.
У чипов AVR простые порты: они умеют подавать ток на одни ножки и принимать ток с других. Вы можете сказать контроллеру, например, «Подай ток на пятый вывод». И если к пятому выводу подключен светодиод, он загорится. Если подключен мотор — он начнет вращаться. Если динамик — услышите звук.
У контроллеров Ardurno помимо таких портов есть USB, с помощью которого контроллер умеет общаться с компьютером.
Какое бы решение вы ни выбрали, помните, что объяснять новое нужно всегда на основе того, что человек уже знает.
Объяснять новое через известное.
Привязать к реальности
Человеку тяжело воспринимать абстрактное. Как только мы рассказываем о чём-то оторванном от жизни, нормальные люди теряют интерес. Вспомните уроки алгебры в старших классах: «Зачем эти интегралы? Как они пригодятся в жизни?»
Голая теория — это скучно. Поэтому в хорошем учебнике много примеров, историй, персонажей и всего, что привязывает материал к реальности.
С другой стороны, без теории невозможно объяснить почти ничего. Если просто дать человеку много примеров, он их вряд ли сможет применить. Это как перечисление фактов на уроках истории — «И что это все должно значить?». Просто примеры не работают без теории.
Чтобы разрешить это противоречие, приводите примеры к любой теории. Объясняйте, зачем это знать и как эти знания повлияют на жизнь читателя.
Вот голая теория:
Контроллеры AVR и Arduino не поддерживают многозадачность, но ее можно имитировать с помощью программ.
Добавим практический пример, привязанный к реальности:
Если вы делаете метеостанцию и хотите одновременно измерять влажность и температуру, на самом деле нужно будет замерять их последовательно. Сначала вы даете команду считать влажность, потом температуру, потом вывести их на экран и начать сначала. Так как Arduino может выполнять сотни операций в секунду, со стороны это будет выглядеть так, будто всё происходит параллельно.
Этот пример основан на реальной задаче, которую мы можем решить с помощью контроллера. Реальная задача — хорошо.
Другой способ добавить практики — рассказать случай из жизни, реальный или выдуманный. Вот теория:
В качестве первого контроллера советуем выбрать оригинальные платы, а не китайскую копию — даже не смотря на высокую цену.
Здесь есть абстракции «оригинальное» и «высокая цена». Разовьем их на примерах из жизни:
Мой первый контроллер был оригинальным итальянским Ardurno за 1500 рублей. Он сразу и без проблем подключился к компьютеру, и я смог в этот же день записать на него первую программу.
Следующие контроллеры я заказывал в Китае за 200–300 рублей. Всякий раз с ними было что-то не так и их приходилось перепрошивать через оригинальный Ardurno.
Если вы пишете большую статью, полезно создать одного или двух персонажей. С ними будут происходить все практические случаи, которые вам нужны для объяснения теории:
Олег решил сэкономить и заказал первый контроллер в Китае…
Маша решила не заказывать копию, а начать с оригинального…
Читатель привыкнет к персонажам, а вам будет легко всякий раз приводить примеры.
К любой теории — практику, пример или случай.
Помочь с трудностями
В любом деле у читателя могут возникнуть трудности. Если вы пишете статью с практическими рекомендациями, предусмотрите эти трудности и предложите решение. Мало рассказать, как должно, — нужно еще и написать, как бывает:
Если будете заказывать контроллер на китайском рынке вроде «Таобао» или «Алиэкспресса», заказывайте сразу два контроллера у разных поставщиков. Велика вероятность, что один из них придет бракованным.
При первой прошивке китайского Ardurno вы можете получить сообщение, что плата не найдена. Это значит, что вам досталась модель без первоначальной прошивки. Возьмите официальный Ardurno, загрузите на него программатор, подключите к нему ваш китайский экземпляр и загрузите на него первоначальную прошивку. Это дело на десять минут, подробности — в статье «...».
Если программа для контроллера не компилируется, скорее всего, у вас не закрыта скобка или не стоит точка с запятой в конце одной из строк. Пройдите каждую строку и проверьте, что у каждого цикла и условия есть закрывающая скобка, а в конце каждой строки стоит точка с запятой.
Продавцы будут уговаривать вас купить две или три макетные платы — не ведитесь. Одной длинной платы хватит за глаза.
Не скупитесь на помощь с трудностями: чем больше тонких моментов вы охватите, тем полезнее статья и тем лучше читатель справится со своей задачей.
Трудности бывают не только технические, но и человеческие. Если вы пишете о похудении и спорте, мало просто сказать: «Питайтесь правильно и делайте зарядку». Это и так все знают. Напишите о том, что мешает следовать таким советам:
Все знают, что по утрам нужно делать зарядку. Это легко сделать, если вы каждый день высыпаетесь, а утром у вас полно сил. Но чаще всего утром сил мало и хочется еще поспать. Чтобы справиться с утренней усталостью и сделать зарядку, возьмите...
Главная беда неправильного питания — вечерний перекус. Чтобы не накидываться быстрыми углеводами на ночь, держите в холодильнике запас маложирного творога, огурцов и салата — по сути это белок, клетчатка и вода. Если вы занимаетесь в спортзале, готовьте протеиновый коктейль с творогом и молоком.
Если вам пришлось нарушить диету — ничего страшного. Просто продолжите соблюдать правильный режим питания на следующий день. Ничего страшного не произошло, просто продолжайте.
Рассказ о подобных трудностях куда полезнее, чем разговоры из серии «Как должно быть правильно в идеальном мире».
Не стесняйтесь проблем. Наоборот, раскройте их.
Помочь структурой и выводами
Если учебная статья получается объемной, полезно разделить ее на небольшие фрагменты, каждый из которых будет самостоятельным и ценным.
