Инструкция по сборке
Список компонентов
- 2U полка StarTech UNISLDSHF192
- Около 1.2 кг Ultimaker Tough PLA
- KVM-свитч TESmart HKS1601A1U-EUBK (The Elder Scrolls, кто в теме 🤣 )
- Raspberry Pi 4 4Gb
- PiKVM HAT
- Servo Driver HAT
- I2C OLED дисплей 0.91 дюйма для PiKVM
- Удлинитель GPIO для Raspberry Pi 4 (гребёнка 2×20 мама (длина пинов: 5.5 мм))
- 2x 19″ стоечных PDU по 9 розеток
- Оригинальный блок питания для Raspberry Pi
- MicroSD Sandisk 64GB Max Endurance
- Вентилятор 30x30x7мм 5v
- Небольшой радиатор на процессор Raspberry Pi
- 16x тонких HDMI кабелей 1м
- 16x кабелей USB 2.0 1м — USB-C в USB-B
- 16x тонких (~28AWG) сетевых патч-кордов, например
- 8x сервоприводов MG996R (DM996)
- Удлинители для кабелей сервоприводов вроде этих. Нужны будут не для всех сервоприводов. Лучше взять набор и подобрать оптимальную длину по месту
- Металлический пруток (думаю, обычная скрепка подойдёт). Нужен для соединения рычагов и сервоприводов
На github.com можно поставить звёздочку (✰), а потом клонировать репозиторий или скачать архив. Там все нужные модели для печати и мои скрипты, о которых расскажу ниже.
Надеюсь, сначала вы внимательно прочитаете статью. Возможно, какие-то шаги захочется поменять или добавить свои. Главное — осторожнее с сервоприводами, если торопитесь: они могут сломать что-нибудь или себя.
3D-печать
Начнём с печати крупных деталей. Нужно восемь двойных подставок.
Печать без поддержек, слой 0.2мм. Филамент Ultimaker Tough PLA. Думаю, хорошим аналогом будет любой PETG. Заполнения 5-10% со стенками 0.8мм должно хватить.
На большом принтере можно печатать так. Область печати Ultimaker S5: 11.8” (30 см) в высоту, 13” (33 см) в ширину, 9.84” (25 см) в глубину.


На маленьком тоже можно, но выйдет дольше. Область печати Ultimaker 3: 7.9″ (20 см) в высоту, 8.5” (21.6 см) в ширину, 8.5” (21.6 см) в глубину.

Затем нужно 16 рычагов. У них с одной стороны есть выступ. Печатать их лучше так. Без поддержек, слой 0.15мм

7 таких штифтов для соединения подставок

И 7 органайзеров для кабелей, их тоже можно печатать без поддержек.

Саму стойку уже можно собрать на напечатанных штифтах с помощью винтов M3 16-18мм

Не забудьте поставить органайзеры кабелей между подставками


С обратной стороны

Теперь ставим рычаги и сервоприводы. Но не спешите

Я использовал смазку, потому что смазка хороша везде, где есть трение.

Сервопривод можно закрепить болтами M3 примерно такой длины (можно и длиннее, глубины отверстия хватит). Рычаги одинаковые, и несмотря на смещение из-за выступа, на функциональность это никак не влияет.

Дальше можно надеть оригинальную качалку сервопривода и собрать конструкцию вот так. Можно использовать металлический пруток или просто разогнутую скрепку. Пруток должен проходить до самого низа рычага, длина около 38мм.
Обратите внимание, что от рычага к качалке сервопривода с каждой стороны по 2 отверстия.

Не крепите чёрный рычаг к сервоприводу. Оставьте так до первоначальной настройки (вернёмся к этому дальше по тексту)

Следующий шаг — собрать толкатель. Я пробовал несколько вариантов:

Идея в том, чтобы пружина компенсировала избыточное усилие нажатия, и рычаг не сдвигал Mac mini при нажатии кнопки.

В последних версиях я просто использовал болт, пружину и гайку вот так, без лишних гаек посередине, т.к. точная настройка делается в скрипте.

Финальная конструкция получается довольно крепкой.

Это важный момент! Вы ведь не прикрепили рычаги к сервоприводам? Это нужно делать после первоначальной калибровки сервоприводов! Приводы достаточно мощные, чтобы сломать себя, пластиковые детали и, возможно, продавить кнопку на Mac mini (и сломать её).
Корпус для Raspberry Pi и переднюю панель тоже можно напечатать (в репозитории в соответствующей папке).


И её подставка


Полка
Теперь подробнее про полку. К сожалению, при такой установке под полкой теряется ещё один юнит. Возможно, получится переставить направляющие, в следующий раз попробую. Это просто моя рекомендация по монтажу. Вам может показаться правильным собрать иначе. Советую смотреть по месту. Мне ещё пришлось перевернуть крепление направляющей для проводов, чтобы всё встало как надо; думаю, если вы дошли до этого шага, справитесь.
Статья получается довольно длинной. Надеюсь, оно того стоит.
Ну а теперь продолжаем собирать. Всю стойку к полке я закрепил двусторонним скотчем (но в пластиковых деталях есть отверстия под болты, если захотите прикрутить к полке).
Время первоначальной настройки и проверки Raspberry Pi
Соберите PiKVM (ссылка на документацию) и добавьте Servo HAT (через удлинитель GPIO). Можно сразу добавить OLED экран. И не забудьте адаптер USB-C сбоку!

Следуя официальной документации, прошейте SD-карту, ссылка.
Подключаем так (порядок сервоприводов пока не важен, главное — занять порты 0-7)

Снимите рычаги с сервоприводов и запустите Raspberry Pi. Я использую оригинальный блок питания Raspberry Pi.

Если всё хорошо, pikvm должен появиться в сети, и к нему можно подключиться по SSH.
Включите i2c для работы Servo HAT и watchdog, чтобы устройство могло автоматически перезагружаться в случае сбоев:
rw
echo 'dtparamw=watchdog=on' >> /boot/config.txt
echo 'dtparam=i2c_arm=on' >> /boot/config.txt
Перезагрузка
Положите мои скрипты в папку пользователя на pikvm и сделайте их исполняемыми:
rw
chmod u+x kvmctl.sh
chmod u+x servo.py
chmod u+x servo_all.py
- servo_all.py
Запускает все сервоприводы, чтобы по очереди нажать все 16 кнопок. В качестве аргумента принимает задержку нажатия - servo.py
Нажимает кнопку на выбранном Mac mini, в качестве аргументов — номер Mac mini (1-16) и задержка в секундах - kvmctl.sh
Я немного доработал оригинальный скрипт управления выбранным KVM-свитчем. Обратная связь нам не нужна (мы не знаем, какой Mac mini сейчас выбран), так что я отключил всё лишнее, это ускоряет переключение портов KVM-свитча.
Ещё раз проверьте, что рычаги сняты с сервоприводов!
Сначала установите pip:
rw
pacman -S python-pip
или
| wget https://bootstrap.pypa.io/get-pip.py --no-check-certificate | |
| python get-pip.py | |
| chmod u+x get-pip.py | |
| ./get-pip.py |
Установите adafruit-circuitpython-servokit:
rw
pip install adafruit-circuitpython-servokit
или (в случае ошибок)
rw
pip install adafruit-circuitpython-servokit --break-system-packages
Запустите скрипт, который выставит все сервоприводы в нулевое положение (все сервоприводы повернутся туда-обратно и встанут на 100°):
./servo_all.py 1
Если все повернулись, всё хорошо, и теперь можно ставить пластиковые рычаги. Не поворачивайте сервоприводы! Встанут они, может, и не идеально, но несколько градусов потом можно задать как поправку в файле servo_parameters.py.
Кабели
Можно всё выключить и продолжить сборку
Подставки KVM-свитча не требуют дополнительной фиксации или склейки.
Укладку кабелей можно сделать так:

Тут понадобятся удлинители для кабелей сервоприводов (места соединений можно замотать изолентой, но лучше надеть термоусадку). Также проложите сетевые кабели, питание, USB и HDMI. Не забудьте подписать кабели! Для кабелей сервоприводов это критично.


Теперь нужно подключить KVM-свитч к последовательному порту PiKVM. Для этого нужно сделать кабель-переходник. Или использовать кабель в стиле Cisco/Mikrotik:

В комплекте с KVM-свитчем идёт подходящий зелёный разъём. Понадобится кусок сетевого кабеля. Лучше жёсткий, с одножильными проводниками, с ним проще работать.
Итак, кабель втыкается в порт 8p8c (RJ45) над Ethernet-портом на Raspberry Pi. А другой конец — в KVM-свитч.

Наконец-то с кабелями закончили.
Собираем всё вместе, но переднюю панель пока не ставим.

Сервоприводы подключаются к servo HAT слева направо с 0 по 7. Ноль — ближе к передней панели, 7 — ближайший к Raspberry. (Я считаю с 1 до 8, но порты на servo HAT подписаны с 0, так что тут они названы с нуля)


Под Raspberry стоит вот такая подставка, чтобы без проблем втыкать в неё кабели

Ещё можно использовать угловой адаптер на 90 градусов для HDMI в PiKVM, чтобы порт от PiKVM смотрел вверх, но это может и не понадобиться.
Финишная прямая
На этом этапе всё собрано и готово к финальной точной настройке.
Включите Raspberry Pi и подключитесь к нему по SSH.
Установите последние обновления:
rw
pacman -Syu
Смените hostname:
rw
hostnamectl set-hostname yournewhostname.domain
И отредактируйте /etc/kvmd/meta.yaml, чтобы поменять отображаемое имя сервера в веб-интерфейсе
Смена паролей
rw
passwd root
kvmd-htpasswd set admin
Донастройка
Установите socat, он нужен для работы скрипта управления KVM-свитчем
pacman -S socat
Настройте watchdog (он перезагрузит Raspberry, например, при зависании или потере сети).
sudo nano /etc/watchdog.conf
min-memory = 1280
max-load-1 = 24
max-load-5 = 18
max-load-15 = 12
watchdog-device = /dev/watchdog
watchdog-timeout = 15
interval = 1
realtime = yes
priority = 1
ping = 8.8.8.8
Пинговать, наверное, лучше какой-нибудь сервер поблизости, ну вы поняли
sudo systemctl enable watchdog
sudo systemctl start watchdog
sudo systemctl status watchdog
Часовой пояс:
timedatectl set-timezone Europe/Berlin
Пара важных переносов файлов:
- переместите override.yaml в папку /etc/kvmd/
Этот файл отвечает за добавление своих компонентов в интерфейс. Он добавляет нужные драйверы и запускает нужные скрипты по нажатию кнопок в веб-интерфейсе. 436 строк! - переместите custom_commands в папку /etc/sudoers.d/
Добавляет возможность запускать нужные скрипты от имени администратора (это нужно для работы с servoHAT).
После этого можно перезагрузить Raspberry
Финальная настройка сервоприводов
В принципе, уже можно попробовать подключиться к веб-интерфейсу, и там уже будут кнопки для управления вашими Mac mini. Если при сборке вы были аккуратны, можно продолжать; если переживаете, можно временно убрать Mac mini из стойки.
После нажатия кнопки в интерфейсе сервопривод повернётся, нажмёт кнопку на Mac Mini и вернётся в положение 100 градусов.
Если вернулся неточно, нужно отредактировать файл:
servo_parameters.py
rw
nano servo_parameters.py
"""
Just a separate file with values to fine-tune
for each individual servo. But not the Mac mini!
"""
servo_adjustment = [0, 0, 0, 0, 0, 0, 0, 0]
Если сервопривод нужно довернуть вправо, вводите положительные значения. Влево — отрицательные. Добавляйте по 1-2 за раз! И для каждого сервопривода отдельно.
Пример итогового файла может быть таким:
servo_adjustment = [1, -4, 0, 8, -1, 6, 2, -3]
P.S. Были идеи оптимизировать первоначальную настройку каким-нибудь мастером, но боюсь, тогда статья не увидела бы свет в этом году. Да и вообще делается это один раз, так что считаю это лишним и реально оверинжинирингом. Но может, позже….
Как переименовать Mac mini в интерфейсе PiKVM?
Нужно отредактировать их имена в конце файла override.yaml

Главное — не сломать структуру файла, иначе сломается интерфейс
После редактирования этого файла нужно перезапустить веб-интерфейс командой
systemctl restart kvmd
Ну вот и всё.
Надеюсь, было интересно!
Буду благодарен, если присоединитесь к нашему Discord-серверу и подпишетесь на мой Instagram и/или X (Twitter). Это будет лучшее «спасибо», если статья понравилась 🙂 Спасибо, и да пребудет с вами Сила!
Ну и, конечно, оставляйте комментарии! Я читаю всё, их тут обычно немного )
Приложение. Красота (или оверинжиниринг) скриптов
Частью задачи было реализовать управление сервоприводом так, чтобы он обслуживал 2 Mac mini. Ниже привожу основной скрипт, который за это отвечает.
Из интерфейса мы передаём номер Mac mini и задержку в секундах. Выбор нужного сервопривода и добавление поправки реализованы внутри скрипта.
#! /usr/bin/python
"""
The number of Mac mini (from 1 to 16) and
the number of seconds for which the button
will be pressed on each mac are taken as arguments
"""
from sys import argv
import time
from adafruit_servokit import ServoKit
from servo_parameters import *
script, mac, delay = argv
mac = int(mac)
delay = float(delay)
port = mac // 2 + mac % 2 - 1 # for macs 1,2 servoHAT port is 0; 2,3 = 1; 3,4 = 2; etc..
zero_angle = 100
adj = servo_adjustment[port]
kit = ServoKit(channels=16)
print("Mac: ", mac, "; Delay: ", delay)
if mac % 2 != 0:
angle = 80
else:
angle = 120
print("Port: ", port, " ; Angle: ", angle)
kit.servo[port].angle = angle + adj
time.sleep(delay)
kit.servo[port].angle = zero_angle + adj
time.sleep(1)
kit.servo[port].angle = None
Вызов этого скрипта делается довольно просто через override.yaml (подробнее про драйвер CMD по ссылке docs.pikvm.org)

Вызов скрипта, который переключает порты на KVM-свитче, делается так же, после запятой — параметры.

Может, я выбрал не лучший способ, но работает хорошо. В первых версиях KVMac16 все настройки делались через файл override.yaml , и это отнимало очень много времени.
Я Head of Hardware в компании JetBrains. Основатель Uptime Lab. Рад видеть вас у себя на сайте! Пожалуйста подписывайтесь на мой Инстаграм и Твиттер, я публикую там самые свежие обновления.
Imagine if apple, Knowing these mini would sell like got cakes. Imagine if they put an external way to power them on remotely. Or even crazier never will happen out of band management.