macmini/README.md

130 lines
6.3 KiB
Markdown

<p align="center">
<img align="center" width="300px" height="auto" src="./images/mm2_sd.gif">
</p>
# Mac(intosh) mini
## Build Instruction
- Print the outer shell.
- PLA, 0.2 mm, 180 ℃ (See also [./openscad/README.md](./openscad/README.md))
- `macintosh-mini-part-a.stl` ([stl](./openscad/macintosh-mini-part-a.stl))
- `macintosh-mini-part-b.stl` ([stl](./openscad/macintosh-mini-part-b.stl))
<img align="center" width="60%" height="auto" src="./openscad/images/models.png">
- Setup your Orange Pi Zero Plus 2 (H3)
- Install Armbian Bionic. https://www.armbian.com/orange-pi-zero-plus-2-h3/
- Then SSH into the device.
```bash
$ sudo apt install -y git tightvncserver
# Install Node.js
$ git clone https://github.com/tj/n /tmp/n && cd /tmp/n && sudo make install
$ sudo n v10
# Install https://github.com/xpertsavenue/WiringOP-Zero
$ cd ~/
$ git clone https://github.com/xpertsavenue/WiringOP-Zero
## Please refer to https://github.com/xpertsavenue/WiringOP-Zero
# Enable SPI1 interface
$ sudo vi /boot/armbianEnv.txt # or use armbian-config
! overlays=spi-spidev analog-codec usbhost2 usbhost3
+ param_spidev_spi_bus=1
# Setup vncserver
$ mkdir ~/.vnc
$ vncpasswd ~/.vnc/passwd
# Install the dependencies & config files
$ git clone https://github.com/likeablob/macmini ~/macmini
$ cd ~/macmini
$ sudo ./install.sh
# Copy your assets
$ cp /path/to/vmac.rom ~/macmini/minivmac/vMac.ROM # Mini vMac ROM file
$ cp /path/to/vmac.dsk ~/macmini/minivmac/system.dsk # Mini vMac disk file
$ cp /path/to/.basilisk_ii_prefs ~/.basilisk_ii_prefs # Basilisk II config file
$ cp /path/to/macboot.wav ~/macmini/macboot.wav # Boot sound (optional)
# Reboot to apply the settings
$ sudo reboot now
# Select LineOut as the default sink
$ pacmd list-sinks | grep -e 'name:' -e 'index:'
index: 0
name: <alsa_output.platform-1c22c00.codec.analog-mono> # LineOut
* index: 1
name: <alsa_output.platform-soc_sound.stereo-fallback> # HDMI
$ pactl set-default-sink 0 # or use `DISPLAY=:1 pavucontrol` and `alsamixer` to adjust volume
```
- [Tips]: Here is my working [.basilisk_ii_prefs](basilisk_ii_prefs.md).
- Wire the display & USB boards to the OPi
<img align="center" width="auto" height="400px" src="./images/mm_s_8.jpg">
| OPi | Peripherals |
| -------------- | -------------------------- |
| PA15/SPI1_MOSI | LCD MOSI |
| PA16/SPI1_MISO | LCD MISO |
| PA14/SPI1_CLK | LCD CLK |
| PA13/SPI1_CS | LCD CS |
| PS12 | LCD RESET |
| PA11 | LCD DC |
| PA06 | Push Switch |
| GND | Push Switch |
| USB-DP2 | USB (Front) Data+ |
| USB-DM2 | USB (Front) Data- |
| 5V | USB (Front/Rear) 5V |
| GND | USB (Front/Rear) GND |
| LINEOUTL | (Optional) Amplifier Input |
- [Tips]: Pinout can be found below.
- OPiZero
- https://linux-sunxi.org/Xunlong_Orange_Pi_Zero_Plus
- http://www.orangepi.org/orangepibbsen/forum.php?mod=viewthread&tid=2236
- LCD (Note that there might be some variants.)
- [link1](https://www.solidrop.net/product/free-ship-5pc-lot-2-4inch-spi-tft-lcd-screen-18pin-240-320-color-lcd-drive-ic-ili9341-4io-only-for-stm32-mcu-raspberry-pi.html) [link2](https://github.com/myelin/tiny-tft/blob/master/TJC-024-9341-18-pin-SPI-240x320-ili9341-2.4-inch-touch/chinese-driver/TJC-024-9341.pdf)
- [backup](./images/lcd-ili9341-pinout.jpg)
## Basic Concepts
1. At system boot, [`fbtft_device`](./config/fbtft.conf) kernel module is loaded and it initializes the LCD as `/dev/fb0`.
2. `nodm` starts an X session and `~/.xinitrc` get executed.
3. `~/.xinitrc` launchs `matchbox-window-manager` and `~/macmini/switcher/*js`.
4. `~/macmini/switcher/index.js` reads the scripts [`~/macmini/switcher/sh.d/*sh`](./switcher/sh.d/) and spawns them one by one when there is a HTTP GET request at `localhost:5501/`.
5. `~/macmini/switcher/gpio-reader.js` watchs the push SW at GPIO7(PA06) and send a request to `localhost:5501/`.
### How does the low-res LCD(320x240) handle 512x384 resolution?
Internally `tightvncserver` and `ssvncviewer` are used to scale the display.
- e.g. [`1_large_minimac.sh`](./switcher/sh.d/1_large_minimac.sh) launches:
- `tightvncserver` to create a virtual display (512x384) at `DISPLAY=:1` (`:5901`)
- `minivmac` in `DISPLAY:1`
- `ssvncviewer -scale 0.625` in `DISPLAY:0` (By the `-scale` option, low-res LED get upscaled)
## Gallery
| <img align="center" width="auto" height="200px" src="./images/mm_s_5.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm_s_7.jpg"> |
| :-------------------------------------------------------------------------: | :-------------------------------------------------------------------------: |
| <img align="center" width="auto" height="200px" src="./images/mm_s_20.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm_s_14.jpg"> |
| <img align="center" width="auto" height="200px" src="./images/mm_s_10.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm_s_23.jpg"> |
| <img align="center" width="auto" height="200px" src="./images/mm_s_9.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm3_sd.gif"> |
## BOM
| Name | Quantity | Descriptions |
| ------------------------------------------------------- | :------: | ----------------------- |
| OrangePi Zero Plus 2 (H3) | 1 | H5 ver. might work too. |
| 2.4inch SPI Display (ili9341, 320x240, with flat cable) | 1 | |
| Generic micro-USB Breakout Board | 2 | |
| M2 x 6 mm Self Tapping Screw | 16 | |
| D10mm Rounding Magnet | 2 | |
| 7x7 mm Push Switch | 1 | |
| 2W Small Speaker | 1 | (Optional) |
| ClassD Audio Amplifier Board | 1 | (Optional) PAM8403 |
## Acknowledgments
- Mini vMac https://www.gryphel.com/c/minivmac/
- Basilisk II https://basilisk.cebix.net/
- Kudos to all the devs!