Add documentation

doc/main.tex

@@ -0,0 +1,555 @@
+\documentclass[a4paper,12pt]{extarticle}
+\usepackage{/home/eddy/ed}
+\usepackage{bytefield}
+\graphicspath{{./pic/}}
+\nocolon
+
+\title{Система температурного мониторинга главного зеркала БТА}
+\author{Емельянов~Э.В.}
+\begin{document}
+\maketitle
+\tableofcontents\newpage
+
+\section*{Введение}\addcontentsline{toc}{section}{Введение}
+
+В техническом отчете \No\,338 за 2018\,г. описана первоначальная система температурного мониторинга
+главного зеркала (ГЗ) БТА, установленного на <<переполированное>> ГЗ~\No\,1. В 2019\,г. при
+обратной замене уничтоженного ЛЗОС ГЗ \No\,1 на ГЗ \No\,2 система была
+перенесена, но уже с увеличением количества термодатчиков: 20\,датчиков установлено на тыльной
+части зеркала и 80~--- на <<донышках>> углублений под разгрузки (т.е. фактически, на расстоянии
+около 20\,см от рабочей поверхности ГЗ). Это позволило строить значительно более детализованные
+картины распределения температур. Также были учтены проблемы с использованием для питания
+контроллеров шести свободных проводников витой пары, оставшиеся два из которой использовались для
+организации связи по CAN~шине. Внутри оправы был проложен специальный кабель для камер
+видеонаблюдения, включающий в себя витую пару и кабель питания (к сожалению, при монтаже
+выяснилось, что кабель~--- не медный, а изготовлен из <<обмедненного алюминия>>, что делает его
+чрезвычайно хрупким). Разъемы RJ-45 на контроллерах были заменены на DB-9, имеющие значительно
+более надежный контакт, кроме того, адресация контроллера расширена до четырех бит, позволяя таким
+образом установить до 16~контроллеров (т.е. подключить до 256~термодатчиков в одну сеть).
+
+Микропрограммное обеспечение контроллеров претерпело ряд изменений, последнее  из которых было
+произведено в сентябре~2024\,г (\verb|build #62 @ 2024-09-04|). Один из контроллеров начал
+периодически блокировать CAN-шину постоянно повторяющимися <<широковещательными>> запросами на
+измерение температуры. Был немного изменен протокол, добавлено несколько дополнительных команд, а
+также запрещены широковещательные запросы. Кроме того, была удалена поддержка приема команд по UART,
+т.к. слишком низкая скорость этого интерфейса требует выделения достаточно большого объема памяти
+для текстового буфера, иначе часть сообщений из CAN-шины микроконтроллер просто не успевает
+зафиксировать (при получении ответа от очередного контроллера со свежими данными температур, особо
+остро эта проблема проявлялась при
+получении ответа от всех контроллеров на <<широковещательный>> запрос).
+
+В данном документе описано состояние системы на сентябрь 2024\,г. Опущены все факты, упомянутые в
+вышеназванном техническом отчете (его, как и данный документ, можно найти в репозитории с
+кодом~\footnote{\url{https://github.com/eddyem/tsys01}}).
+
+\section{Топология системы}
+Основной компьютер, осуществляющий доступ к свежесобранным данным, установлен в металлическом щитке
+на правой стене помещения третьего этажа фокуса <<Н2>>. Помимо компьютера в щите установлен блок
+питания 12\,В для энергоснабжения контроллеров, а также контроллер с номером~<<0>>,
+выполняющий роль ведущего для сбора данных с пяти контроллеров в оправе ГЗ~БТА. В целях
+безопасности контроллер подключен к компьютеру по USB через гальваноразвязку. Питание ведомых
+контроллеров заводится через нормально замкнутое USB-реле, также подключенное к компьютеру.
+
+Кабель (двойная витая пара) от ведущего контроллера внутрь оправы проложен еще в 2018\,г., и из-за
+сложности прокладки при реорганизации системы в 2019\,г не заменялся, поэтому питание передается в
+оправу по семи парам (по семь проводников на каждый полюс), восьмая пара используется в
+коммуникационных целях.
+
+В оправе ГЗ (крышка вблизи Н2) расположен коммутационный разъем, соединяющий кабель со стороны
+ведущего контроллера и кабели CAN-шины, идущие к ведомым контроллерам, а также к частотному
+преобразователю, управляющему перемешиванием воздуха внутри оправы. К ведомым контроллерам проходит
+двойной кабель: витая пара (используется только одна пара) и питание. В предыдущем варианте питание
+передавалось по трем парам одинарной витой, что вызывало значительную просадку напряжения: на
+последнем контроллере питающее напряжение составляло всего лишь 6\dots7\,В.
+
+\begin{pict}
+\includegraphics[width=0.8\textwidth]{Razgruzki}
+\caption{Нумерация разгрузок ГЗ БТА. Зелеными пятнами отмечено расположение ведомых контроллеров,
+зеленая цифра~--- номер контроллера.}
+\label{razgruzki}
+\end{pict}
+
+На рис.~\ref{razgruzki} отображена нумерация разгрузок ГЗ~БТА. Зеркало изображено так, как оно
+видится из первичного фокуса (в дальнейшем все координаты и изображения приведены к этому
+положению).
+
+Ведомые контроллеры расположены на стенках оправы ГЗ~БТА со стороны следующих разгрузок (номер
+контроллера~-- номер разгрузки): 1~--~38, 2~--~50, 3~--~29, 4~--~12, 5~--~2. Кабель проложен в
+окнах между разгрузками, за исключением тех мест, где окон не было: в них он проходит через
+специально подготовленное отверстие.
+
+По окнам в оправе расположены кабели, подключающие термодатчики к контроллерам. Условная нумерация
+термодатчиков состоит из трех цифр: первая цифра~-- номер контроллера (1--5), вторая~-- номер
+канала (0--7), третья~-- номер датчика в канале (0,~1). Таким образом, например, номер~471
+соответствует датчику номер~1 в седьмом канале четвертого контроллера.
+
+К термодатчикам припаяны экранированные четырехканальные кабели (каждый проводник в собственном
+экране). Каждая пара кабелей сводится в одной точке и переходит в витую пару, которая уже
+заканчивается непосредственно разъемом~4P4C, подключаемым к соответствующему гнезду на плате
+контроллера. Кабели к датчикам проходят через технологические отверстия в разгрузках ГЗ БТА. К
+сожалению, полная топология прокладки служебных кабелей не была изначально документирована и
+требует вскрытия заглушек всех разгрузок ГЗ БТА, что, ввиду незначительности задачи, видится
+бессмысленным.
+
+Все термодатчики были аттестованы на массивной дюралюминиевой плите в диапазоне температур не хуже
+$-10\div+20\,\degr$C, для каждого была построена кривая разницы показаний от медианной температуры
+группы опорных термодатчиков. Датчики, показывающие нелинейность свыше~$\pm0.1\degr$C были
+отбракованы, для остальных был вычислен аддитивный показатель (погрешности ВЫЧИТАЮТСЯ из показаний
+датчика для получения реальной температуры). В таблице~\ref{sensonm} приведено местоположение
+датчиков и вычисленные аддитивные поправки. Условные координаты~--- в дециметрах от центра зеркала,
+где направление вверх соответствует направлению к верху зеркала, а направление вправо~--- к Н2.
+Местоположение (place)~--- номер разгрузки, а в случае датчиков, закрепленных на нижней поверхности
+зеркала~--- ближайшие разгрузки, между которыми наклеен датчик.
+
+\begin{table}
+\leavevmode
+\hbox to 0.45\textwidth{
+\begin{tabular}{|c|c|c|c|c|}
+\hline
+\textbf{No} & \textbf{Place} & $\Delta T$ & $X$ & $Y$ \\
+\hline
+100 & 36    & -0.07 & 19  & 7\\
+101 & 19    & 0.03  & 20  & 0\\
+110 & 20    & 0.03  & 19  & -7\\
+111 & 20-21 & -0.05 & 17  & -10\\
+120 & 40    & 0.02  & 17  & -22\\
+121 & 21    & -0.03 & 15  & -13\\
+130 & 39    & 0.02  & 22  & -17\\
+131 & 38-39 & -0.09 & 24  & -14\\
+140 & 38    & 0.03  & 25  & -10\\
+141 & 37    & 0.02  & 27  & -4\\
+150 & 60    & -0.01 & 27  & 4\\
+151 & 59    & -0.09 & 25  & 10\\
+160 & 58    & 0.07  & 22  & 17\\
+161 & 58-59 & 0     & 24  & 14\\
+170 & 56    & 0.02  & 10  & 25\\
+171 & 57    & 0.08  & 17  & 22\\
+200 & 55    & -0.01 & 4   & 27\\
+201 & 54-55 & -0.03 & 0   & 27\\
+210 & 54    & 0.04  & -4  & 27\\
+211 & 53    & -0.01 & -10 & 25\\
+220 & 52    & -0.02 & -17 & 22\\
+221 & 51    & -0.04 & -22 & 17\\
+230 & 50    & 0.03  & -25 & 10\\
+231 & 50-51 & -0.03 & -24 & 14\\
+240 & 48    & -0.03 & -27 & -4\\
+241 & 49    & 0.03  & -27 & 4\\
+250 & 47    & -0.05 & -25 & -10\\
+251 & 46-47 & 0     & -24 & -14\\
+260 & 46    & 0.03  & -22 & -17\\
+261 & 45    & -0.05 & -17 & -22\\
+270 & 44    & -0.02 & -10 & -25\\
+271 & 43    & 0.04  & -4  & -27\\
+300 & 24    & 0.12  & -3  & -20\\
+301 & 25    & 0     & -10 & -17\\
+310 & 26    & -0.08 & -15 & -13\\
+311 & 26-27 & -0.08 & -17 & -10\\
+320 & 27    & -0.1  & -19 & -7\\
+321 & 28    & -0.04 & -20 & 0\\
+330 & 29    & -0.08 & -19 & 7\\
+331 & 29-30 & 0.03  & -17 & 10\\
+\hline
+\end{tabular}}\hbox to 0.45\textwidth{
+\begin{tabular}{|c|c|c|c|c|}
+\hline
+\textbf{No} & \textbf{Place} & $\Delta T$ & $X$ & $Y$ \\
+\hline
+340 & 30    & 0.11  & -15 & 13\\
+341 & 31    & 0.07  & -10 & 17\\
+350 & 32    & 0.09  & -3  & 20\\
+351 & 32-33 & -0.09 & 0   & 20\\
+360 & 33    & -0.1  & 3   & 20\\
+361 & 34    & 0.04  & 10  & 17\\
+370 & 35    & 0.05  & 15  & 13\\
+371 & 35-36 & -0.04 & 17  & 10\\
+400 & 17    & 0.01  & 9   & 9\\
+401 & 17-18 & -0.04 & 11  & 7\\
+410 & 16    & 0.01  & 3   & 13\\
+411 & 15-16 & -0.04 & 0   & 13\\
+420 & 14    & 0.14  & -9  & 9\\
+421 & 15    & 0     & -3  & 13\\
+430 & 13    & 0.07  & -13 & 3\\
+431 & 13-14 & -0.02 & -11 & 7\\
+440 & 12    & 0.04  & -13 & -3\\
+441 & 11-12 & -0.06 & -11 & -7\\
+450 & 11    & 0.01  & -9  & -9\\
+451 & 10    & 0.08  & -3  & -13\\
+460 & 9     & -0.09 & 3   & -13\\
+461 & 9-10  & -0.04 & 0   & -13\\
+470 & 23    & 0.06  & 3   & -20\\
+471 & 23-24 & -0.05 & 0   & -20\\
+500 & 42    & 0.05  & 4   & -27\\
+501 & 42-43 & -0.08 & 0   & -27\\
+510 & 22    & 0.1   & 10  & -17\\
+511 & 41    & -0.05 & 10  & -25\\
+520 & 8     & 0     & 9   & -9\\
+521 & 7-8   & 0.01  & 11  & -7\\
+530 & 2     & 0     & 3   & -5\\
+531 & 2-3   & -0.02 & 0   & -6\\
+540 & 3     & 0.05  & -3  & -5\\
+541 & 4     & -0.03 & -6  & 0\\
+550 & 5     & 0.03  & -3  & 5\\
+551 & 5-6   & 0.06  & 0   & 6\\
+560 & 6     & 0     & 3   & 5\\
+561 & 1     & -0.06 & 6   & 0\\
+570 & 7     & -0.07 & 13  & -3\\
+571 & 18    & 0.02  & 13  & 3\\
+\hline
+\end{tabular}}
+\caption{Положение термодатчиков на ГЗ БТА.}\label{sensonm}
+\end{table}
+
+Датчики вблизи поверхности зеркала расположены на <<донышке>> каждого углубления под разгрузку. На
+нижней поверхности зеркала термодатчики установлены по шести радиусам: восемь на вертикальном
+диаметре (между каждой парой разгрузок около него) и по три на остальных радиусах с шагом~$60\degr$.
+
+За время эксплуатации системы выяснилось также, что разъемы 4P4C, использующиеся для подключения
+датчиков, не отличаются особой надежностью. Из-за плохого контакта некоторые датчики могут
+перестать реагировать на опрос и исключаются (однако, контроллеры периодически проводят опрос всех
+датчиков, и если обнаруживается, что отключившийся датчик снова отвечает, производится
+переинициализация системы, и показания вновь становятся доступными).
+
+Осмотр системы в~2024\,г. показал, что на контроллере~1 деградировало несколько разъемов 4P4C.
+После замены контроллера основная часть датчиков, ранее не подававших признаков жизни, <<ожила>>.
+Мертвым оказался лишь датчик 100, не реагирующий на опрос даже на самой медленной частоте шины I2C.
+Датчики 160 и 161 отсутствуют изначально (при монтаже в 2019\,г. были уничтожены неопытным
+монтажником, не заземлившим паяльник). Учитывая незначительность потери, было принято решение так
+все и оставить, а не вскрывать разгрузки, чтобы заменить недостающие датчики. Кроме того,
+заменять-то их и нечем: среди оставшихся из 100~закупленных небольшая часть по тем или иным
+причинам неработоспособна, а оставшиеся имеют значительные (свыше $\pm0.1\degr$C) отклонения по
+линейности. На контроллере~2 у датчиков~250 и~251 по причине плохого контакта изредка пропадают
+показания. Датчики~370 и~371 контроллера~3 вышли из строя (дают показания, но совершенно неверные).
+У контроллера~4 датчики 450 и~451 в основном не работают по причине плохого контакта. Датчик 551
+контроллера~5 не подает признаков жизни.
+
+Итого, из 80~закрепленных на ГЗ БТА датчиков надежные показания дают~70.
+
+\section{Протоколы связи}
+Протокол связи с собственно термодатчиками по шине I2C документирован производителем, поэтому здесь
+не озвучивается.
+
+Реализацию всех протоколов можно найти в исходных кодах по вышеупомянутой ссылке.
+
+\subsection{CAN-протокол}
+
+Данные по CAN-шине передаются пакетами переменной длины: от одного до восьми байт. Каждый
+контроллер (за исключением работающего в режиме мониторинга шины) принимает лишь пакеты с
+определенным идентификатором, равным $0x680+N$, где $N$~-- номер контроллера, устанавливаемый
+перемычками на плате. Контроллеры первого поколения имели лишь три бита адресации, в следующем
+поколении адресация расширена до четырех бит, однако, протокол все еще рассчитан на адреса от~0
+до~7, где 0~--- ведущий (автоматически запускается в режиме мониторинга, если не получит команду
+перейти в режим индивидуальной адресации), а остальные~--- ведомые (аналогично, могут быть
+переключены в режим мониторинга командой по USB). <<Широковещательные>> сообщения, поддерживаемые
+первым поколением контроллеров, удалены с целью защиты шины от <<спамеров>>. Как и удалена
+поддержка бесполезного ввиду слишком  медленной скорости UART.
+
+В каждом пакете нулевым байтом является маркер типа пакета (\texttt{MAR}): данные (\verb'0x5A') или
+команда (\verb'0xA5'). Байт~1 (\texttt{NUM})~--- номер контроллера, отправившего сообщение (команду
+или данные), что позволяет выявить адресата и отправить ответ именно ему (таким образом, ведомые
+контроллеры тоже могут посылать команды ведущему). Байт~2 (\texttt{CMD})~--- код команды
+(перечислены далее). Оставшиеся байты (\texttt{DATA}) содержат данные ответа на запрос и
+присутствуют лишь в пакетах с маркером <<данные>>. Таким образом, графически формат пакета можно
+выразить так:\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{8}
+    \bitheader{0-7} \\
+    \bitbox{1}{MAR} & \bitbox{1}{NUM} & \bitbox{1}{CMD}
+    & \bitbox{5}{DATA} \\
+\end{bytefield}
+
+Перечень команд (числовое значение команды, мнемоническое обозначение, расшифровка):
+\begin{description}
+    \item[0x00] \verb'CMD_PING' ожидание пакета данных с эхом этой команды (используется для
+    проверки существования контроллера на шине);
+    \item[0x01] \verb'CMD_START_MEASUREMENT' начать одиночное измерение температуры (см.~далее);
+    \item[0x02] \verb'CMD_SENSORS_STATE' получить состояние датчиков (см.~далее);
+    \item[0x03] \verb'CMD_START_SCAN' войти в режим непрерывного измерения температуры (каждые
+    15~секунд контроллер отправляет данные с термодатчиков запрашиваемому узлу);
+    \item[0x04] \verb'CMD_STOP_SCAN' выйти из предыдущего режима;
+    \item[0x05] \verb'CMD_SENSORS_OFF' отключить питание датчиков;
+    \item[0x06] \verb'CMD_LOWEST_SPEED' минимальная скорость I2C (5.8\,кГц);
+    \item[0x07] \verb'CMD_LOW_SPEED' низкая скорость I2C (10\,кГц);
+    \item[0x08] \verb'CMD_HIGH_SPEED' высокая скорость I2C (100\,кГц);
+    \item[0x09] \verb'CMD_REINIT_I2C' реинициализация шины I2C;
+    \item[0x0A] \verb'CMD_CHANGE_MASTER_B' (исключена);
+    \item[0x0B] \verb'CMD_CHANGE_MASTER' (исключена);
+    \item[0x0C] \verb'CMD_GETMCUTEMP' температура микроконтроллера (см.~далее);
+    \item[0x0D] \verb'CMD_GETUIVAL' значения напряжений и токов (см.~далее);
+    \item[0x0E] \verb'CMD_GETUIVAL0' (см.~далее);
+    \item[0x0F] \verb'CMD_GETUIVAL1' (см.~далее);
+    \item[0x10] \verb'CMD_REINIT_SENSORS' запуск процедуры обнаружения термодатчиков и получения их
+    калибровочных величин;
+    \item[0x11] \verb'CMD_GETBUILDNO' номер версии сборки текущей микропрограммы;
+    \item[0x12] \verb'CMD_SYSTIME' условное (в миллисекундах) время, начиная с последнего старта
+    микроконтроллера (данные начинаются с байта~4, остроконечный формат);
+    \item[0x13] \verb'CMD_USBSTATUS' состояние активности подключения к контроллеру по USB (в
+    ответе~1, если USB активно);
+    \item[0x14] \verb'CMD_SHUTUP' после получения этой команды контроллер входит в режим молчания,
+    не посылая никаких сообщений в CAN-шину;
+    \item[0x15] \verb'CMD_SPEAK' нормальный режим (контроллер отвечает в CAN-шину);
+    \item[0xAA] \verb'CMD_ANSOK' ответ <<OK>> контроллера в случае, если не предусмотрена пересылка
+    данных на запрос;
+    \item[0xDA] \verb'CMD_DUMMY0' тестовая команда;
+    \item[0xAD] \verb'CMD_DUMMY1' тестовая команда.
+\end{description}
+
+Ответ на команду \texttt{CMD\_START\_MEASUREMENT}, где \texttt{SNO}~-- номер датчика ($10\cdot
+N+M$, где $N$~-- номер канала, $M$~-- номер датчика в паре), \texttt{TH}~-- старший байт данных и
+\texttt{TL}~-- младший байт данных (температура передается в сотых градуса Цельсия):\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{6}
+    \bitheader{0-5} \\
+    \bitbox{1}{0x5A} & \bitbox{1}{NUM} & \bitbox{1}{0x01}
+    & \bitbox{1}{SNO} & \bitbox{1}{TH} & \bitbox{1}{TL}\\
+\end{bytefield}
+
+При считывании температурных данных в случае ошибки измерений (значение температуры,
+полученное с шины, лежит вне допустимого диапазона) возвращается число -30000 (т.е. $-300\degr$C),
+а при ошибке передачи команды считывания измеренных данных~--- число -31000 (т.е. $-310\degr$C).
+
+
+Ответ на команду \verb'CMD_SENSORS_STATE':\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{8}
+    \bitheader{0-7} \\
+    \bitbox{1}{0x5A} & \bitbox{1}{NUM} & \bitbox{1}{0x02}
+    & \bitbox{1}{ST} & \bitbox{1}{SP[0]} & \bitbox{1}{SP[1]}
+    &\bitbox{1}{NS} & \bitbox{1}{NT}\\
+\end{bytefield}
+
+Здесь поле \texttt{ST}~-- состояние датчиков:
+\begin{description}
+    \item[0x00] \verb'SENS_INITING' питание включено, происходит инициализация;
+    \item[0x01] \verb'SENS_RESETING' процедура обнаружения датчиков командой сброса;
+    \item[0x02] \verb'SENS_GET_COEFFS' получение калибровочных коэффициентов обнаруженных датчиков;
+    \item[0x03] \verb'SENS_SLEEPING' <<спящее>> состояние между измерениями;
+    \item[0x04] \verb'SENS_START_MSRMNT' команда начала измерения температуры;
+    \item[0x05] \verb'SENS_WAITING' ожидание окончания измерений температуры;
+    \item[0x06] \verb'SENS_GATHERING' сбор температур с обнаруженных термодатчиков;
+    \item[0x07] \verb'SENS_OFF' питание датчиков отключено;
+    \item[0x08] \verb'SENS_OVERCURNT' превышение допустимого тока питания датчиков (0.5\,А),
+    датчики временно отключены;
+    \item[0x09] \verb'SENS_OVERCURNT_OFF' попытка включения питания датчиков более 32~раз
+    закончилась состоянием \verb'SENS_OVERCURNT', питание отключено вплоть до внешнего
+    вмешательства.
+\end{description}
+
+Поля \texttt{SP[x]}~-- битовые, каждый бит означает, что датчик с данным индексом обнаружен~(1) или
+нет~(0). \texttt{SP[0]}~-- датчики с нулевым адресом в паре (младший бит~-- канал~0, старший~--
+канал~7); \texttt{SP[1]}~-- датчики с индексом~1 в паре.
+
+Поле \texttt{NS}~-- количество обнаруженных датчиков (откликнувшихся на команду инициализации и
+сообщивших калибровочные данные).
+
+Поле \texttt{NT}~-- количество измеренных температур, которое в силу ошибок может быть меньше
+\texttt{NS}, в этом случае рекомендуется снизить скорость I2C данного контроллера. Несмотря на то,
+что кабельное хозяйство расположено в эдакой <<клетке Фарадея>>, из-за значительной (местами до
+2.5\,м) длины линии I2C рекомендуется первой же командой, переданной ведущему контроллеру,
+установить на всех ведомых минимальную скорость I2C.
+
+Ответ на команду \verb'CMD_GETMCUTEMP' (тупоконечный формат в сотых градуса Цельсия):\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{5}
+    \bitheader{0-4} \\
+    \bitbox{1}{0x5A} & \bitbox{1}{NUM} & \bitbox{1}{0x0C}
+    & \bitbox{1}{TH} & \bitbox{1}{TL}\\
+\end{bytefield}
+
+Ответ на команду \verb'CMD_GETUIVAL' эквивалентен ответу на посылку последовательно команд с
+индексами~0 и~1.
+
+\verb|CMD_GETUIVAL0|~-- напряжение на шинах~5\,В и~12\,В (в сотых Вольты). Тупоконечный формат,
+байты~3 и~4~-- 12\,В, байты~5 и~6~-- 5\,В:\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{5}
+    \bitheader{0-6} \\
+    \bitbox{1}{0x5A} & \bitbox{1}{NUM} & \bitbox{1}{0x0E}
+    & \bitbox{1}{V12H} & \bitbox{1}{V12L}
+    & \bitbox{1}{V5H} & \bitbox{1}{V5L}\\
+\end{bytefield}
+
+\verb|CMD_GETUIVAL1|~-- потребляемый ток на шине~12\,В (в миллиамперах) и напряжение питания~МК (в
+сотых Вольты). Тупоконечный формат, байты~3 и~4~-- ток, байты~5 и~6~-- напряжение 3.3\,В
+(закупленная на алиэкспрессе партия токовых датчиков полностью оказалась бракованной, поэтому ни на
+одном контроллере холловские датчики тока не распаяны):\\[0pt]
+
+\begin{bytefield}[bitwidth=4em]{5}
+    \bitheader{0-6} \\
+    \bitbox{1}{0x5A} & \bitbox{1}{NUM} & \bitbox{1}{0x0F}
+    & \bitbox{1}{I12H} & \bitbox{1}{I12L}
+    & \bitbox{1}{V3.3H} & \bitbox{1}{V3.3L}\\
+\end{bytefield}
+
+
+\subsection{Текстовый протокол данных при работе через USB}
+
+Формат команды:
+\verb'[<num>]<char><endline>', где \verb'<char>' "--- символ команды (большая или малая латинская
+буква), а \verb'<endline>' "--- символ завершения строки (\verb'\n'). Параметр \verb'[<num>]'
+используется лишь для основной части команд в верхнем регистре, означая номер контроллера, которому
+будет осуществлена передача следующей команды.
+Все команды в нижнем регистре запускаются исключительно локально на данном контроллере (существуют
+также команды, не имеющие <<локального>> варианта, как и команды, не имеющие <<сетевого>>).
+<<Сетевые>> команды могут быть отправлены с любого контроллера: как ведущего, так и ведомого. При
+получении команды контроллер сохраняет номер адресата, отправляя ответ с нужным~ID.
+
+Далее приводится список основных команд.
+
+\begin{description}
+    \item[@] инвертировать флаг режима отладки: при установленном флаге контроллер выдает
+    дополнительные сообщения в USB (на посылки в CAN-шину данный флаг не влияет);
+    \item[A] разрешение подчиненному узлу отправлять сообщения в CAN-шину (нормальный режим работы);
+    \item[a] получение <<сырых>> значений измерений АЦП микроконтроллера;
+    \item[B] посылка тестового сообщения по CAN-шине (на него не приходит ответа, лишь в USB
+    получателя выводится сообщение <<DUMMY>>, если, конечно, к USB кто-либо подключен);
+    \item[b] получение или установка (если за литерой следует число) скорости CAN-шины (в кбод)
+    \item[c] отобразить коэффициенты заводской калибровки для всех подключенных термодатчиков
+    (сетевой вариант данной команды не предусмотрен: пока еще не было прецедентов, чтобы это
+    понадобилось бы);
+    \item[D] послать по CAN-шине тестовое сообщение ведущему контроллеру (т.е. с идентификатором
+    0x580);
+    \item[Ee] выйти из режима сканирования температуры (в режиме сканирования каждые 15\,с
+    контроллер проводит измерение температуры с выдачей данных в CAN-шину с идентификатором
+    <<заказчика>>);
+    \item[Ff] отключить питание термодатчиков (не рекомендуется часто отключать питание, иначе
+    датчики быстро выйдут из строя);
+    \item[g] активировать режим <<прослушивания>> CAN-шины (автоматически включен у ведущего
+    контроллера, но при подключении по USB к ведомому в диагностических целях может быть также
+    активирован);
+    \item[Hh] переключить I2C в режим скорости 100\,кГц (не рекомендуется для длинных линий);
+    \item[Ii] запустить процедуру поиска термодатчиков (необходимо в случае, если контроллер
+    отключил их питание по аварийной ситуации);
+    \item[Jj] температура микроконтроллера (в сотых градуса Цельсия);
+    \item[Kk] получить все значения измеренных АЦП МК напряжений и токов (U3.3, U5, U12, I12~-- см.
+    выше);
+    \item[Ll] переключить I2C в режим скорости 10\,кГц (режим по умолчанию, однако, как оказалось,
+    линии длиной больше двух метров требуют перехода в <<сверхмедленный>> режим);
+    \item[N] получение значения номера сборки микрокода (для текущего контроллера при подключении
+    по USB номер и дата сборки выводятся в шапке сообщения подсказки, например, при запросе <<?>>);
+    \item[Oo] (нестандартный: заглавная литера тоже означает локальную команду) включение
+    (заглавная) или отключение (прописная) набортных диагностических диодов (светодиод LED0
+    пульсирует с частотой в 1\,Гц, LED1 своим свечением диагностирует нормальную работу CAN-шины);
+    \item[P] ping "--- запрос на существование в сети контроллера с соответствующим адресом
+    (ответом является отправка назад того же пакета данных, но с маркировкой <<data>>);
+    \item[Qq] получение условного (в миллисекундах) времени с включения контроллера: несмотря на
+    значительную погрешность кварцевых генераторов, порядок величины позволяет определить, не
+    перезагружался ли тот или иной контроллер после общего включения питания;
+    \item[Rr] переинициализация I2C;
+    \item[S] <<заткнуть>> данный узел: он перестанет отправлять в CAN-шину какие бы то ни было
+    сообщения (вплоть до получения разрешения вернуться в нормальный режим), данная команда,
+    отправленная ведомым узлом, может <<заткнуть>> и ведущий, что чревато;
+    \item[s] отправить в CAN-шину сообщение, первым байтом следует идентификатор сообщения,
+    затем~-- до восьми байт данных (формат: двоичный с префиксом~\verb'0b', восьмеричный с
+    префиксом~\verb'0', десятичный или же шестнадцатеричный с префиксом~\verb'0x');
+    \item[Tt] запуск одиночного измерения температуры (стандартная команда для измерений по запросу
+    с ведущего контроллера);
+    \item[U] состояние USB (в случае, если к контроллеру подключен хост, возвращается единица);
+    \item[u] режим приема сообщений лишь с идентификатором, равным $0x580+ADDR$ (режим по
+    умолчанию для ведомых);
+    \item[Vv] переключить I2C в режим наименьшей скорости (около 5.8~кГц);
+    \item[Xx] активировать  режим сканирования температуры (ведомые каждые 15\,с будут отправлять
+    измеренные данные);
+    \item[Yy] состояние термодатчиков (см.~выше);
+    \item[z] проверить флаг ошибки CAN-шины.
+\end{description}
+
+
+\section{Основные утилиты и демоны}
+При подключении к компьютеру любого контроллера, udev-правило создает в директории \verb|/dev| файл
+\verb|tsyscontrX| (если подключено лишь одно устройство, \verb|X| будет нулем), являющийся
+символической ссылкой на последовательный терминал, эмулятор PL2303 (udev-скрипт и создан в целях
+идентификации конкретного устройства, если к компьютеру подключено несколько разнотипных устройств,
+эмулирующих PL2303). Эмуляция именно PL2303 создана с двумя целями: избавиться от <<перехвата>>
+устройства демоном \verb|modemmanager| systemd-based дистрибутивов, а также затруднить работу с
+устройствами из вражеской среды. Код данного скрипта:
+
+\begin{verbatim}
+ACTION=="add", DRIVERS=="usb", ENV{USB_IDS}="%s{idVendor}:%s{idProduct}"
+ACTION=="add", ENV{USB_IDS}=="067b:2303", ATTRS{interface}=="?*",
+    PROGRAM="/bin/bash -c \"ls /dev | grep $attr{interface} | wc -l \"",
+    SYMLINK+="$attr{interface}%c", MODE="0666", GROUP="tty"
+ACTION=="add", ENV{USB_IDS}=="0483:5740", ATTRS{interface}=="?*",
+    PROGRAM="/bin/bash -c \"ls /dev | grep $attr{interface} | wc -l \"",
+    SYMLINK+="$attr{interface}%c", MODE="0666", GROUP="tty"
+\end{verbatim}
+
+Для возможности разделения последовательного устройства между несколькими независимыми процессами
+(опрос температурных данных, работа с вентиляторами, диагностика), запускается
+прокси-демон\footnote{\url{https://github.com/eddyem/eddys_snippets/tree/master/serialsock}},
+предоставляющий сетевой доступ по заданному локальному INET-сокету или же UNIX-сокету. Полученные
+из последовательного устройства данные транслируются всем подключенным клиентам, а данные от
+клиентов записываются в устройство.
+
+Основной сетевой демон\footnote{\url{https://github.com/eddyem/tsys01/tree/master/src/netdaemon}}
+подключается к сокету прокси-демона, а также открывает общедоступный сетевой сокет, через который
+любой клиент может получить данные последних измерений. Кроме того, при помощи \verb|gnuplot|
+каждые 15\,минут формируются изображения с распределением температуры по обоим слоям установки
+термодатчиков. Данные доступны через веб.
+
+При помощи \verb|netcat| и баш-скриптов реализован также веб-интерфейс управления вентиляторами,
+расположенными внутри оправы ГЗ~БТА. На рис.~\ref{fans} продемонстрирован простейший интерфейс,
+доступный по адресу \url{http://mirtemp.sao.ru/fans.html}. Переключатели <<Low>>, <<Mid>> и
+<<High>> позволяют установить заданную скорость вращения вентиляторов. Флажок <<Run middle>>
+включает вентилятор, расположенный в средней части зеркала (он захватывает воздух из подкупольного
+пространства, в отличие от остальных вентиляторов, которые лишь перемешивают внутри оправы~ГЗ). При
+выборе флажка <<Stop>> выключаются все вентиляторы. Кнопка <<Set>> активирует текущий выбор.
+Под ней отображаются текущие значения потребляемого вентиляторами тока и скорость вращения их
+двигателей (центральный вентилятор включается пускателем, поэтому в статистике не участвует).
+
+\begin{pict}
+    \includegraphics[width=0.4\textwidth]{fans}
+    \caption{Управление вентиляторами.}
+    \label{fans}
+\end{pict}
+
+На рис.~\ref{t0} и~\ref{t1} приведены примеры изображений распределения температур. В тех местах,
+где термодатчики отсутствуют, либо же их показания выбиваются за $3\sigma$ от медианной по зеркалу,
+данные не отображены.
+
+Вся подробная информация: исходные коды, схемы и т.п. размещена в
+репозитории\footnote{\url{https://github.com/eddyem/tsys01}}.
+
+Для подключения к сокету прокси-демона в отладочных целях удобно использовать
+терминал\footnote{\url{https://github.com/eddyem/tty_term}}, позволяющий задавать формат входных и
+отображаемых данных, а также разделяющих строку ввода от поля вывода (в отличие от netcat,
+смешивающего все данные).
+
+Для передачи данных в СУ~БТА на основном компьютере управления (обычно, \verb|acs7|) запущен демон
+\verb|bta_mirtemp|. К сожалению, он <<сляпан на скорую руку>>, поэтому даже не проверяет наличие уже
+запущенного экземпляра. В случае наличия данных от сервера \verb|mirtemp|, в СУ вводятся полученные
+данные средней температуры по зеркалу (алгоритмы вычисления и т.п.~--- в репозитории). Если же в
+течение 15\,минут данные отсутствуют, в системе отображается ошибка.
+
+Разворачивание системы с нуля элементарно, и не требует каких-либо комментариев. Выдачей клиенту
+изображений распределений температур может заниматься NGINX или даже элементарный самописный сервер
+(не более трех-четырех страниц кода на~С).
+
+В будущем, если найдется разработчик, желающий довести систему до ума, он сможет сменить
+баш-скрипты управления вентиляторами на более защищенные демоны на~С, а также внедрить систему
+интеллектуального контроля скоростью вращения вентиляторов (отключать их при открытых крышках и
+устанавливать скорость вращения в зависимости от градиента по зеркалу). Кроме того, уже который год
+мы планируем вместо центрального вентилятора установить управляемый кондиционер, который позволил
+бы поддерживать на заданном уровне температуру ГЗ~БТА. Управление этим кондиционером~--- еще одна
+задача следующего поколения разработчиков.
+
+\begin{pict}
+    \includegraphics[width=0.7\textwidth]{T0}
+    \caption{Пример изображения распределения температур приповерхностного слоя.}
+    \label{t0}
+\end{pict}
+
+\begin{pict}
+    \includegraphics[width=0.7\textwidth]{T1}
+    \caption{Пример изображения распределения температур тыльной поверхности.}
+    \label{t1}
+\end{pict}
+
+
+
+\end{document}
+
+\begin{pict}
+\includegraphics[width=0.7\textwidth]{}
+\caption{.}
+\label{}
+\end{pict}

kicad/stm32_deprecated/stm32-rescue.lib

@@ -1,6 +1,307 @@
-EESchema-LIBRARY Version 2.3
+EESchema-LIBRARY Version 2.4
 #encoding utf-8
 #
+# 74HC4051
+#
+DEF 74HC4051 U 0 10 Y Y 1 F N
+F0 "U" 0 0 50 H V C CNN
+F1 "74HC4051" 0 -150 50 H V C CNN
+F2 "" 0 0 50 H V C CNN
+F3 "" 0 0 50 H V C CNN
+$FPLIST
+ SO16
+ TSSOP16
+ SSOP16
+ DHVQFN16
+$ENDFPLIST
+DRAW
+S -400 450 400 -450 0 1 0 N
+X Y4 1 700 -50 300 L 50 50 1 1 B
+X S1 10 -700 250 300 R 50 50 1 1 I
+X S0 11 -700 350 300 R 50 50 1 1 I
+X Y3 12 700 50 300 L 50 50 1 1 B
+X Y0 13 700 350 300 L 50 50 1 1 B
+X Y1 14 700 250 300 L 50 50 1 1 B
+X Y2 15 700 150 300 L 50 50 1 1 B
+X VCC 16 -700 -100 300 R 50 50 1 1 W
+X Y6 2 700 -250 300 L 50 50 1 1 B
+X Z 3 0 -750 300 U 50 50 1 1 B
+X Y7 4 700 -350 300 L 50 50 1 1 B
+X Y5 5 700 -150 300 L 50 50 1 1 B
+X ~{E} 6 -700 -350 300 R 50 50 1 1 I I
+X VEE 7 -700 0 300 R 50 50 1 1 W
+X GND 8 -700 -200 300 R 50 50 1 1 W
+X S2 9 -700 150 300 R 50 50 1 1 I
+ENDDRAW
+ENDDEF
+#
+# C
+#
+DEF C C 0 10 N Y 1 F N
+F0 "C" 25 100 50 H V L CNN
+F1 "C" 25 -100 50 H V L CNN
+F2 "" 38 -150 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ C_*
+$ENDFPLIST
+DRAW
+P 2 0 1 20 -80 -30 80 -30 N
+P 2 0 1 20 -80 30 80 30 N
+X ~ 1 0 150 110 D 50 50 1 1 P
+X ~ 2 0 -150 110 U 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# CONN_01X01
+#
+DEF CONN_01X01 J 0 40 Y N 1 F N
+F0 "J" 0 100 50 H V C CNN
+F1 "CONN_01X01" 100 0 50 V V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ Pin_Header_Straight_1X*
+ Pin_Header_Angled_1X*
+ Socket_Strip_Straight_1X*
+ Socket_Strip_Angled_1X*
+$ENDFPLIST
+DRAW
+S -50 5 10 -5 0 1 0 N
+S -50 50 50 -50 0 1 0 N
+X P1 1 -200 0 150 R 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# CONN_01X03
+#
+DEF CONN_01X03 J 0 40 Y N 1 F N
+F0 "J" 0 200 50 H V C CNN
+F1 "CONN_01X03" 100 0 50 V V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ Pin_Header_Straight_1X*
+ Pin_Header_Angled_1X*
+ Socket_Strip_Straight_1X*
+ Socket_Strip_Angled_1X*
+$ENDFPLIST
+DRAW
+S -50 -95 10 -105 0 1 0 N
+S -50 5 10 -5 0 1 0 N
+S -50 105 10 95 0 1 0 N
+S -50 150 50 -150 0 1 0 N
+X P1 1 -200 100 150 R 50 50 1 1 P
+X P2 2 -200 0 150 R 50 50 1 1 P
+X P3 3 -200 -100 150 R 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# CONN_01X04
+#
+DEF CONN_01X04 J 0 40 Y N 1 F N
+F0 "J" 0 250 50 H V C CNN
+F1 "CONN_01X04" 100 0 50 V V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ Pin_Header_Straight_1X*
+ Pin_Header_Angled_1X*
+ Socket_Strip_Straight_1X*
+ Socket_Strip_Angled_1X*
+$ENDFPLIST
+DRAW
+S -50 -145 10 -155 0 1 0 N
+S -50 -45 10 -55 0 1 0 N
+S -50 55 10 45 0 1 0 N
+S -50 155 10 145 0 1 0 N
+S -50 200 50 -200 0 1 0 N
+X P1 1 -200 150 150 R 50 50 1 1 P
+X P2 2 -200 50 150 R 50 50 1 1 P
+X P3 3 -200 -50 150 R 50 50 1 1 P
+X P4 4 -200 -150 150 R 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# CONN_02X08
+#
+DEF CONN_02X08 J 0 1 Y N 1 F N
+F0 "J" 0 450 50 H V C CNN
+F1 "CONN_02X08" 0 0 50 V V C CNN
+F2 "" 0 -1200 50 H I C CNN
+F3 "" 0 -1200 50 H I C CNN
+$FPLIST
+ Pin_Header_Straight_2X*
+ Pin_Header_Angled_2X*
+ Socket_Strip_Straight_2X*
+ Socket_Strip_Angled_2X*
+ IDC_Header_Straight_*
+$ENDFPLIST
+DRAW
+S -100 -345 -50 -355 0 1 0 N
+S -100 -245 -50 -255 0 1 0 N
+S -100 -145 -50 -155 0 1 0 N
+S -100 -45 -50 -55 0 1 0 N
+S -100 55 -50 45 0 1 0 N
+S -100 155 -50 145 0 1 0 N
+S -100 255 -50 245 0 1 0 N
+S -100 355 -50 345 0 1 0 N
+S -100 400 100 -400 0 1 0 N
+S 50 -345 100 -355 0 1 0 N
+S 50 -245 100 -255 0 1 0 N
+S 50 -145 100 -155 0 1 0 N
+S 50 -45 100 -55 0 1 0 N
+S 50 55 100 45 0 1 0 N
+S 50 155 100 145 0 1 0 N
+S 50 255 100 245 0 1 0 N
+S 50 355 100 345 0 1 0 N
+X P1 1 -250 350 150 R 50 50 1 1 P
+X P10 10 250 -50 150 L 50 50 1 1 P
+X P11 11 -250 -150 150 R 50 50 1 1 P
+X P12 12 250 -150 150 L 50 50 1 1 P
+X P13 13 -250 -250 150 R 50 50 1 1 P
+X P14 14 250 -250 150 L 50 50 1 1 P
+X P15 15 -250 -350 150 R 50 50 1 1 P
+X P16 16 250 -350 150 L 50 50 1 1 P
+X P2 2 250 350 150 L 50 50 1 1 P
+X P3 3 -250 250 150 R 50 50 1 1 P
+X P4 4 250 250 150 L 50 50 1 1 P
+X P5 5 -250 150 150 R 50 50 1 1 P
+X P6 6 250 150 150 L 50 50 1 1 P
+X P7 7 -250 50 150 R 50 50 1 1 P
+X P8 8 250 50 150 L 50 50 1 1 P
+X P9 9 -250 -50 150 R 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# CP
+#
+DEF CP C 0 10 N Y 1 F N
+F0 "C" 25 100 50 H V L CNN
+F1 "CP" 25 -100 50 H V L CNN
+F2 "" 38 -150 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ CP_*
+$ENDFPLIST
+DRAW
+S -90 20 -90 40 0 1 0 N
+S -90 20 90 20 0 1 0 N
+P 2 0 1 0 -70 90 -30 90 N
+P 2 0 1 0 -50 110 -50 70 N
+S 90 -20 -90 -40 0 1 0 F
+S 90 40 -90 40 0 1 0 N
+S 90 40 90 20 0 1 0 N
+X ~ 1 0 150 110 D 50 50 1 1 P
+X ~ 2 0 -150 110 U 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# Crystal
+#
+DEF Crystal Y 0 40 N N 1 F N
+F0 "Y" 0 150 50 H V C CNN
+F1 "Crystal" 0 -150 50 H V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ Crystal*
+$ENDFPLIST
+DRAW
+S -45 100 45 -100 0 1 12 N
+P 2 0 1 0 -100 0 -75 0 N
+P 2 0 1 20 -75 -50 -75 50 N
+P 2 0 1 20 75 -50 75 50 N
+P 2 0 1 0 100 0 75 0 N
+X 1 1 -150 0 50 R 50 50 1 1 P
+X 2 2 150 0 50 L 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# D
+#
+DEF D D 0 40 N N 1 F N
+F0 "D" 0 100 50 H V C CNN
+F1 "D" 0 -100 50 H V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ TO-???*
+ *SingleDiode
+ *_Diode_*
+ *SingleDiode*
+ D_*
+$ENDFPLIST
+DRAW
+P 2 0 1 8 -50 50 -50 -50 N
+P 2 0 1 0 50 0 -50 0 N
+P 4 0 1 8 50 50 50 -50 -50 0 50 50 N
+X K 1 -150 0 100 R 50 50 1 1 P
+X A 2 150 0 100 L 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# D_Zener
+#
+DEF D_Zener D 0 40 N N 1 F N
+F0 "D" 0 100 50 H V C CNN
+F1 "D_Zener" 0 -100 50 H V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ TO-???*
+ *SingleDiode
+ *_Diode_*
+ *SingleDiode*
+ D_*
+$ENDFPLIST
+DRAW
+P 2 0 1 0 50 0 -50 0 N
+P 3 0 1 8 -50 -50 -50 50 -30 50 N
+P 4 0 1 8 50 -50 50 50 -50 0 50 -50 N
+X K 1 -150 0 100 R 50 50 1 1 P
+X A 2 150 0 100 L 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# Jumper_NO_Small
+#
+DEF Jumper_NO_Small JP 0 30 N N 1 F N
+F0 "JP" 0 80 50 H V C CNN
+F1 "Jumper_NO_Small" 10 -60 50 H V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+DRAW
+C -40 0 20 0 1 0 N
+C 40 0 20 0 1 0 N
+X 1 1 -100 0 40 R 50 50 0 1 P
+X 2 2 100 0 40 L 50 50 0 1 P
+ENDDRAW
+ENDDEF
+#
+# L
+#
+DEF L L 0 40 N N 1 F N
+F0 "L" -50 0 50 V V C CNN
+F1 "L" 75 0 50 V V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ Choke_*
+ *Coil*
+ Inductor_*
+ L_*
+$ENDFPLIST
+DRAW
+A 0 -75 25 -898 898 0 1 0 N 0 -100 0 -50
+A 0 -25 25 -898 898 0 1 0 N 0 -50 0 0
+A 0 25 25 -898 898 0 1 0 N 0 0 0 50
+A 0 75 25 -898 898 0 1 0 N 0 50 0 100
+X 1 1 0 150 50 D 50 50 1 1 P
+X 2 2 0 -150 50 U 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
 # LED-RESCUE-stm32
 #
 DEF LED-RESCUE-stm32 D 0 40 Y N 1 F N
@@ -22,4 +323,198 @@ X A 2 150 0 100 L 50 50 1 1 P
 ENDDRAW
 ENDDEF
 #
+# LM1117-3.3
+#
+DEF LM1117-3.3 U 0 30 Y Y 1 F N
+F0 "U" 100 -250 50 H V C CNN
+F1 "LM1117-3.3" 0 250 50 H V C CNN
+F2 "" 0 0 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ SOT-223*
+ TO-263*
+ TO-252*
+$ENDFPLIST
+DRAW
+S -200 -200 200 200 0 1 10 f
+X GND/ADJ 1 0 -300 100 U 50 50 1 1 W
+X VO 2 300 0 100 L 50 50 1 1 w
+X VI 3 -300 0 100 R 50 50 1 1 W
+X VO 4 300 0 100 L 50 50 1 1 w N
+ENDDRAW
+ENDDEF
+#
+# MCP2551-I/SN
+#
+DEF MCP2551-I/SN U 0 40 Y Y 1 F N
+F0 "U" -400 350 50 H V L CNN
+F1 "MCP2551-I/SN" 100 350 50 H V L CNN
+F2 "Housings_SOIC:SOIC-8_3.9x4.9mm_Pitch1.27mm" 0 -500 50 H I C CIN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ SOIC*Pitch1.27mm*
+$ENDFPLIST
+DRAW
+S -400 300 400 -300 0 1 10 f
+X TXD 1 -500 200 100 R 50 50 1 1 I
+X VSS 2 0 -400 100 U 50 50 1 1 W
+X VDD 3 0 400 100 D 50 50 1 1 W
+X RXD 4 -500 100 100 R 50 50 1 1 O
+X Vref 5 -500 -100 100 R 50 50 1 1 w
+X CANL 6 500 -100 100 L 50 50 1 1 B
+X CANH 7 500 100 100 L 50 50 1 1 B
+X Rs 8 -500 -200 100 R 50 50 1 1 I
+ENDDRAW
+ENDDEF
+#
+# Q_PMOS_GSD
+#
+DEF Q_PMOS_GSD Q 0 0 Y N 1 F N
+F0 "Q" 200 50 50 H V L CNN
+F1 "Q_PMOS_GSD" 200 -50 50 H V L CNN
+F2 "" 200 100 50 H I C CNN
+F3 "" 0 0 50 H I C CNN
+DRAW
+P 2 0 1 0 30 -70 100 -70 N
+P 2 0 1 10 30 -50 30 -90 N
+P 2 0 1 0 30 0 100 0 N
+P 2 0 1 10 30 20 30 -20 N
+P 2 0 1 0 30 70 100 70 N
+P 2 0 1 10 30 90 30 50 N
+P 2 0 1 0 100 -70 100 -100 N
+P 2 0 1 0 100 -70 100 0 N
+P 2 0 1 0 100 100 100 70 N
+P 3 0 1 10 10 75 10 -75 10 -75 N
+P 4 0 1 0 90 0 50 -15 50 15 90 0 F
+P 4 0 1 0 100 -70 130 -70 130 70 100 70 N
+P 4 0 1 0 110 -20 115 -15 145 -15 150 -10 N
+P 4 0 1 0 130 -15 115 10 145 10 130 -15 N
+C 65 0 111 0 1 10 N
+C 100 -70 11 0 1 0 F
+C 100 70 11 0 1 0 F
+X G 1 -200 0 210 R 50 50 1 1 I
+X S 2 100 -200 100 U 50 50 1 1 P
+X D 3 100 200 100 D 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# R
+#
+DEF R R 0 0 N Y 1 F N
+F0 "R" 80 0 50 V V C CNN
+F1 "R" 0 0 50 V V C CNN
+F2 "" -70 0 50 V I C CNN
+F3 "" 0 0 50 H I C CNN
+$FPLIST
+ R_*
+ R_*
+$ENDFPLIST
+DRAW
+S -40 -100 40 100 0 1 10 N
+X ~ 1 0 150 50 D 50 50 1 1 P
+X ~ 2 0 -150 50 U 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
+# STM32F042C6Tx
+#
+DEF STM32F042C6Tx U 0 40 Y Y 1 L N
+F0 "U" -3000 1725 50 H V L BNN
+F1 "STM32F042C6Tx" 3000 1725 50 H V R BNN
+F2 "LQFP48" 3000 1675 50 H V R TNN
+F3 "" 0 0 50 H V C CNN
+DRAW
+S -3000 -1700 3000 1700 0 1 10 f
+X VBAT 1 -3100 1100 100 R 50 50 1 1 W
+X ADC_IN0/RTC_TAMP2/SYS_WKUP1/TIM2_CH1/TIM2_ETR/TSC_G1_IO1/USART2_CTS/PA0 10 3100 100 100 L 50 50 1 1 B
+X ADC_IN1/TIM2_CH2/TSC_G1_IO2/USART2_DE/USART2_RTS/PA1 11 3100 0 100 L 50 50 1 1 B
+X ADC_IN2/SYS_WKUP4/TIM2_CH3/TSC_G1_IO3/USART2_TX/PA2 12 3100 -100 100 L 50 50 1 1 B
+X ADC_IN3/TIM2_CH4/TSC_G1_IO4/USART2_RX/PA3 13 3100 -200 100 L 50 50 1 1 B
+X ADC_IN4/I2S1_WS/SPI1_NSS/TIM14_CH1/TSC_G2_IO1/USART2_CK/USB_OE/PA4 14 3100 -300 100 L 50 50 1 1 B
+X ADC_IN5/CEC/I2S1_CK/SPI1_SCK/TIM2_CH1/TIM2_ETR/TSC_G2_IO2/PA5 15 3100 -400 100 L 50 50 1 1 B
+X ADC_IN6/I2S1_MCK/SPI1_MISO/TIM16_CH1/TIM1_BKIN/TIM3_CH1/TSC_G2_IO3/PA6 16 3100 -500 100 L 50 50 1 1 B
+X ADC_IN7/I2S1_SD/SPI1_MOSI/TIM14_CH1/TIM17_CH1/TIM1_CH1N/TIM3_CH2/TSC_G2_IO4/PA7 17 3100 -600 100 L 50 50 1 1 B
+X PB0/ADC_IN8/TIM1_CH2N/TIM3_CH3/TSC_G3_IO2 18 -3100 100 100 R 50 50 1 1 B
+X PB1/ADC_IN9/TIM14_CH1/TIM1_CH3N/TIM3_CH4/TSC_G3_IO3 19 -3100 0 100 R 50 50 1 1 B
+X PC13/RTC_OUT_ALARM/RTC_OUT_CALIB/RTC_TAMP1/RTC_TS/SYS_WKUP2 2 -3100 500 100 R 50 50 1 1 B
+X PB2/TSC_G3_IO4 20 -3100 -100 100 R 50 50 1 1 B
+X PB10/CEC/I2C1_SCL/SPI2_SCK/TIM2_CH3/TSC_SYNC 21 -3100 -900 100 R 50 50 1 1 B
+X PB11/I2C1_SDA/TIM2_CH4 22 -3100 -1000 100 R 50 50 1 1 B
+X VSS 23 -200 -1800 100 U 50 50 1 1 W
+X VDD 24 -200 1800 100 D 50 50 1 1 W
+X PB12/SPI2_NSS/TIM1_BKIN 25 -3100 -1100 100 R 50 50 1 1 B
+X PB13/I2C1_SCL/SPI2_SCK/TIM1_CH1N 26 -3100 -1200 100 R 50 50 1 1 B
+X PB14/I2C1_SDA/SPI2_MISO/TIM1_CH2N 27 -3100 -1300 100 R 50 50 1 1 B
+X PB15/RTC_REFIN/SPI2_MOSI/SYS_WKUP7/TIM1_CH3N 28 -3100 -1400 100 R 50 50 1 1 B
+X CRS_SYNC/RCC_MCO/TIM1_CH1/USART1_CK/PA8 29 3100 -700 100 L 50 50 1 1 B
+X PC14/RCC_OSC32_IN 3 -3100 400 100 R 50 50 1 1 B
+X I2C1_SCL/TIM1_CH2/TSC_G4_IO1/USART1_TX/PA9 30 3100 -800 100 L 50 50 1 1 B
+X I2C1_SDA/TIM17_BKIN/TIM1_CH3/TSC_G4_IO2/USART1_RX/PA10 31 3100 -900 100 L 50 50 1 1 B
+X CAN_RX/I2C1_SCL/TIM1_CH4/TSC_G4_IO3/USART1_CTS/USB_DM/PA11 32 3100 -1000 100 L 50 50 1 1 B
+X CAN_TX/I2C1_SDA/TIM1_ETR/TSC_G4_IO4/USART1_DE/USART1_RTS/USB_DP/PA12 33 3100 -1100 100 L 50 50 1 1 B
+X IR_OUT/SYS_SWDIO/USB_OE/PA13 34 3100 -1200 100 L 50 50 1 1 B
+X VSS 35 -100 -1800 100 U 50 50 1 1 W
+X VDDIO2 36 100 1800 100 D 50 50 1 1 W
+X SYS_SWCLK/USART2_TX/PA14 37 3100 -1300 100 L 50 50 1 1 B
+X I2S1_WS/SPI1_NSS/TIM2_CH1/TIM2_ETR/USART2_RX/USB_OE/PA15 38 3100 -1400 100 L 50 50 1 1 B
+X PB3/I2S1_CK/SPI1_SCK/TIM2_CH2/TSC_G5_IO1 39 -3100 -200 100 R 50 50 1 1 B
+X PC15/RCC_OSC32_OUT 4 -3100 300 100 R 50 50 1 1 B
+X PB4/I2S1_MCK/SPI1_MISO/TIM17_BKIN/TIM3_CH1/TSC_G5_IO2 40 -3100 -300 100 R 50 50 1 1 B
+X PB5/I2C1_SMBA/I2S1_SD/SPI1_MOSI/SYS_WKUP6/TIM16_BKIN/TIM3_CH2 41 -3100 -400 100 R 50 50 1 1 B
+X PB6/I2C1_SCL/TIM16_CH1N/TSC_G5_IO3/USART1_TX 42 -3100 -500 100 R 50 50 1 1 B
+X PB7/I2C1_SDA/TIM17_CH1N/TSC_G5_IO4/USART1_RX 43 -3100 -600 100 R 50 50 1 1 B
+X PF11 44 -3100 700 100 R 50 50 1 1 B
+X PB8/CAN_RX/CEC/I2C1_SCL/TIM16_CH1/TSC_SYNC 45 -3100 -700 100 R 50 50 1 1 B
+X PB9/CAN_TX/I2C1_SDA/IR_OUT/SPI2_NSS/TIM17_CH1 46 -3100 -800 100 R 50 50 1 1 B
+X VSS 47 0 -1800 100 U 50 50 1 1 W
+X VDD 48 -100 1800 100 D 50 50 1 1 W
+X PF0/CRS_SYNC/I2C1_SDA/RCC_OSC_IN 5 -3100 900 100 R 50 50 1 1 I
+X PF1/I2C1_SCL/RCC_OSC_OUT 6 -3100 800 100 R 50 50 1 1 I
+X NRST 7 -3100 1300 100 R 50 50 1 1 I
+X VSSA 8 100 -1800 100 U 50 50 1 1 W
+X VDDA 9 0 1800 100 D 50 50 1 1 W
+ENDDRAW
+ENDDEF
+#
+# SW_Push
+#
+DEF SW_Push SW 0 40 N N 1 F N
+F0 "SW" 50 100 50 H V L CNN
+F1 "SW_Push" 0 -60 50 H V C CNN
+F2 "" 0 200 50 H I C CNN
+F3 "" 0 200 50 H I C CNN
+DRAW
+C -80 0 20 0 1 0 N
+P 2 0 1 0 0 50 0 120 N
+P 2 0 1 0 100 50 -100 50 N
+C 80 0 20 0 1 0 N
+X 1 1 -200 0 100 R 50 50 0 1 P
+X 2 2 200 0 100 L 50 50 0 1 P
+ENDDRAW
+ENDDEF
+#
+# USB_A-RESCUE-stm32
+#
+DEF USB_A-RESCUE-stm32 P 0 40 Y Y 1 F N
+F0 "P" 200 -200 50 H V C CNN
+F1 "USB_A-RESCUE-stm32" -50 200 50 H V C CNN
+F2 "" -50 -100 50 V V C CNN
+F3 "" -50 -100 50 V V C CNN
+$FPLIST
+ USB*
+$ENDFPLIST
+DRAW
+S -250 -150 150 150 0 1 0 N
+S -205 -150 -195 -120 0 1 0 N
+S -105 -150 -95 -120 0 1 0 N
+S -5 -150 5 -120 0 1 0 N
+S 95 -150 105 -120 0 1 0 N
+X VBUS 1 -200 -300 150 U 50 50 1 1 W
+X D- 2 -100 -300 150 U 50 50 1 1 P
+X D+ 3 0 -300 150 U 50 50 1 1 P
+X GND 4 100 -300 150 U 50 50 1 1 W
+X shield 5 300 100 150 L 50 50 1 1 P
+ENDDRAW
+ENDDEF
+#
 #End Library

kicad/sym-lib-table

@@ -1,3 +1,4 @@
 (sym_lib_table
-  (lib (name tsys01-rescue)(type Legacy)(uri ${KIPRJMOD}/tsys01-rescue.lib)(options "")(descr ""))
+  (version 0)
+  (lib (name "tsys01-rescue")(type "Legacy")(uri "${KIPRJMOD}/tsys01-rescue.lib")(options "")(descr ""))
 )

kicad/tsys01-rescue.lib

@@ -133,8 +133,8 @@ F1 "VDD" 0 150 50 H V C CNN
 F2 "" 0 0 50 H I C CNN
 F3 "" 0 0 50 H I C CNN
 DRAW
-C 0 75 25 0 1 0 N
 P 2 0 1 0 0 0 0 50 N
+C 0 75 25 0 1 0 N
 X VDD 1 0 0 0 U 50 50 1 1 W N
 ENDDRAW
 ENDDEF