Add macOS USB UART support

README.md

@@ -1,7 +1,7 @@
 # Location Plotter
 
-Qt6/C++ GUI that listens to `/dev/ttyUSB2`, parses normal debug lines, and plots live
-locations on a map.
+Qt6/C++ GUI that listens to a USB UART on Linux or macOS, parses normal debug lines,
+and plots live locations on a map.
 
 The application also includes an interactive 3D Earth/orbit view. It downloads the current
 stream-derived RINEX 3 navigation file from the BKG/IGS archive at startup and every 15
@@ -95,6 +95,50 @@ make platform_scenario_matrix_test
 Desteklenen senaryolar `stationary`, `pedestrian`, `car`, `aircraft`; GNSS
 periyotları 200/500/1000 ms, IMU periyotları 19/20/200/300 ms'dir.
 
+## macOS'ta kurulum (MacBook Air, Apple Silicon veya Intel)
+
+Guncel macOS surumunde once [Homebrew](https://brew.sh) kurulu olmalidir. Ardindan:
+
+```bash
+cd location_plotter
+chmod +x setup-macos.sh run.sh
+./setup-macos.sh
+./run.sh
+```
+
+Betik Homebrew ile guncel `cmake` ve `qt` paketlerini kurar, yerel mimari icin
+`location_plotter.app` paketini derler, gerekli Qt kutuphanelerini uygulama paketine
+ekler ve testleri calistirir.
+
+macOS USB UART aygitlarini genellikle iki adla gosterir:
+
+```text
+/dev/cu.usbserial-XXXXXXXX
+/dev/tty.usbserial-XXXXXXXX
+```
+
+veya bir CDC aygitinda:
+
+```text
+/dev/cu.usbmodemXXXX
+/dev/tty.usbmodemXXXX
+```
+
+Uygulama her iki bicimi de algilar. Mümkünse `cu.usb...` yolunu secin; macOS'ta
+disariya baglanti baslatan uygulamalar icin uygun olan aygit budur. UART uygulama
+acikken takildiysa port alaninin yanindaki `Yenile` dugmesine basin. Otomatik
+algilanmayan bir yol port alanina elle de yazilabilir.
+
+Istenen port baslatmadan once ortam degiskeniyle de secilebilir:
+
+```bash
+LOCATION_PLOTTER_PORT=/dev/cu.usbserial-XXXXXXXX ./run.sh
+```
+
+Port hic gorunmuyorsa `ls /dev/cu.usb* /dev/tty.usb*` ile macOS'un aygiti olusturup
+olusturmadigini kontrol edin. Hic sonuc yoksa kabloyu/veri baglantisini ve UART
+donaniminizin macOS surucusunu kontrol edin.
+
 ## Ubuntu'da kurulum
 
 Ubuntu 22.04 ve daha yeni surumlerde gerekli paketleri kurmak, uygulamayi derlemek ve
@@ -140,8 +184,10 @@ Uygulama Qt tabanli bir masaustu arayuzudur; grafik oturumu olan bir Ubuntu maki
 calistirilmalidir. Harita karolari ve guncel RINEX verisi icin internet erisimi gerekir,
 ancak son gecerli RINEX verisi ve harita onbellegiyle cevrimdisi kullanim da desteklenir.
 
-The port selector lists only detected `/dev/ttyUSB*` devices. The default selection is
-`/dev/ttyUSB2` and the default baud rate is `115200`.
+Port secici Linux'ta `/dev/ttyUSB*` ve `/dev/ttyACM*`; macOS'ta USB ile ilgili
+`/dev/cu.*` ve `/dev/tty.*` aygitlarini listeler. Hic aygit algilanmazsa Linux'ta
+`/dev/ttyUSB2`, macOS'ta `/dev/cu.usbserial` duzenlenebilir bir varsayilan yol olarak
+gosterilir. Varsayilan baud rate `115200`'dur.
 
 If the port cannot be opened, make sure the user has serial access: