APRS i-gate in a Box (APRS 403)

APRS i-Gate in a Box (APRS 403)

i-GATE Box untuk APRS menggunakan Linksys Wireless Router

Suryono Adisoemarta YD0NXX / N5SNN

Suryono Adisoemarta YD0NXX / N5SNN [email protected]

Apakah itu APRS

Automatic Position Reporting System Radio paket - unconnected mode Pengiriman data (posisi / telemetri) One-to-many (tanpa tujuan tertentu) Ringan (network load) Mudah dibuat

Rev 1.4 – 12aug2008

APRS iGATE Box – Suryono Adisoemarta YD0NXX / N5SNN

Mailing-list APRS

Untuk berdiskusi lebih dalam mengenai APRS, dalam bahasa Indonesia, silakan bergabung di: [email protected]

Kirim email kosong ke: [email protected]

Rev 1.4 – 12aug2008


i-Gate untuk APRS

Memasukkan traffic APRS ke Internet Server Perlu komputer (laptop / desktop) Perlu link ke Internet yang selalu on Bandwidth kecil sekali

Rev 1.4 – 12aug2008


Pilihan i-Gate dengan Komputer

Windows { { {

UI-View AGWUIDigi dll

Linux { {

Xastir APRSd

Rev 1.4 – 12aug2008


APRS i-Gate Box

Stand-alone {

Wireless router { {

Linksys WRT54GL Langsung sambung ke ethernet

Relatif murah Reliable { {

tidak perlu komputer

Tidak ada harddisk Otomatis hidup kalau setelah mati listrik

Option lain: dengan Serial-over-IP Extender

Rev 1.4 – 12aug2008


Pilihan Hardware

Linksys WRT54GL { {

Linksys WRT54GS { {

RAM : 8 MB Filesystem: 8 MB RAM: 16 MB Filesystem: 16 MB

Linksys …

Rev 1.4 – 12aug2008


Maklumat!

Semua perubahan, baik software maupun hardware di router, akan membuat GARANSI menjadi HILANG (void the warranty) Anda bertanggung-jawab sendiri atas kegiatan perubahan (“hacking”) ini, penulis hanya membantu, you are on your own.

Rev 1.4 – 12aug2008


Prosedur Instalasi 1.

Mengganti Operating System {

2.

Modifikasi Hardware {

3.

OS di router diganti dengan Linux – paket dari OpenWrt Menambah dua serial port RS-232 untuk menghubungkan ke TNC / radio

Memasang APRS4R, software i-Gate {

Software yang berbicara dengan APRS-IS (Internet Server)

Rev 1.4 – 12aug2008


Persiapan

Unduh (download): { { {

telnet/SSH client, putty Serial port software, Tera Term Pro Software OpenWrt untuk Linksys WRT54G(L)/GS

Rev 1.4 – 12aug2008

Situs: openwrt.org WRT54GL: openwrt-wrt54g-2.4-squashfs.bin GS: APRS iGATE Box – Suryono Adisoemarta YD0NXX / N5SNN

Mengganti Operating System

Sambung, connect, ke router (lewat ethernet atau wireless) { {

Ethernet: port LAN di WRT54 ke port di komputer Wireless: gunakan SSID: linksys

Login: admin dan password: admin Dengan web browser, buka halaman ini: http://192.168.1.1/Upgrade.asp atau { http://192.168.1.1 -> Administration -> Firmware Upgrade {

Pilih openwrt-wrt54g-2.4-squashfs.bin Klik Open, lalu tekan tombol Upgrade Tunggu 2 menit, router akan reboot Telnet ke 192.168.1.1 Lanjut dengan melakukan konfigurasi

Rev 1.4 – 12aug2008


Reload Operating System

Prosedur ini untuk reload / upgrade kalau sudah terinstall OpenWrt:s { {

{

cd /tmp/ wget http://downloads.openwrt.org/kamikaze/7.09/ brcm-2.4/openwrt-brcm-2.4-squashfs.trx mtd write /tmp/openwrt-brcm-2.4squashfs.trx linux && reboot

Box akan otomatis reboot Telnet ke 192.168.1.1

Rev 1.4 – 12aug2008


Konfigurasi Dasar

Ganti katakunci (password) { {

telnet ke 192.168.1.1 Ketik passwd

{

Ketik katakunci yang baru Ketik ulang katakunci yang baru

Setelah katakunci diganti, sekarang harus menggunakan SSH untuk login username: root, dan password yang baru

Ganti IP number {

vi /etc/config/network

{

i: untuk insert ESC; untuk keluar dari insert mode :wq untuk write and quit dan kembali ke prompt

/etc/init.d/network reload untuk membaca IP baru

Rev 1.4 – 12aug2008


Konfigurasi Wireless

Enable WiFi { {

Configure wireless { { { {

uci uci uci uci

set wireless.cfg2.encryption=wep set wireless.cfg2.key1=0123456789 set wireless.cfg2.key=1 commit wireless && wifi

Cabut kabel ethernet Join ke Router { {

uci set wireless.wl0.disabled=0 uci commit wireless && wifi

SSID: OpenWrt Password: 0123456789 (Open, 64-bit)

Lalu ping melalui wireless

Rev 1.4 – 12aug2008


Memasang Software iGate 1. 2. 3.

4. 5.

Jangan gunakan APRS4R automatic installation script Edit file konfigurasi: vi /etc/ipkg.conf tambahkan "src aprs4r http://www.aprs4r.org/openwrt/kamikaze " (dalam satu baris) Save and quit (ESC, lalu :wq) ipkg update

Rev 1.4 – 12aug2008


Pasang Software

Jika mendapat error host unknown, maka perlu set DNS manually vi /etc/resolv.conf Isi dengan: nameserver 202.73.99.8 nameserver 61.247.0.8 nameserver 202.43.160.50 Save and exit (:wq)

Rev 1.4 – 12aug2008


Memasang Software iGate (2) 5. Install Ruby { ipkg install ruby ruby-core rubyyaml ruby-cgi

{ back to prompt

6. Install APRS4R Core { ipkg install aprs4r

7. Selesai { jangan install aprs4r-web dan aprs4web, karena tidak ada space lagi Rev 1.4 – 12aug2008


Modifikasi Hardware

Memasang serial port, untuk koneksi ke TNC atau radio Cara membuka box: { { {

{

Lepaskan kedua antena dibelakang Box dibalik (bawah menghadap atas) Dengan jempol kiri dan kanan, tekan kaki box yang kiri dan kanan kearah depan Box akan terbuka

Rev 1.4 – 12aug2008


Tekan Kaki untuk Membuka

Rev 1.4 – 12aug2008


Box Telah Terbuka

Rev 1.4 – 12aug2008


Pin Out di Board

Cari Jumper JP2 di board Pin Out Jumper JP2 adalah: Pin Pin Pin Pin

1: 3: 5: 7:

3.3V Tx (ttyS1) Rx (ttyS1) NC

Pin 9: GND

Pin Pin Pin Pin

2: 4: 6: 8:

3.3V Tx (ttyS0) Rx (ttyS0) NC

Pin 10: GND

Perhatikan, ttyS0 ada di Pin 4 dan 6

Rev 1.4 – 12aug2008


Lokasi Jumper JP2

Rev 1.4 – 12aug2008


Level Converter Modifikasi untuk Dual-serial port: •Pin 18 dan 19 adalah Output RS232 kedua •Input adalah pin 1 dan 20

Rev 1.4 – 12aug2008


AD233 – Level Converter Kit

Level Converter Board { {

Kit AD233AK Single-serial port yang akan dimodifikasi menjadi dual serial port Port 2 (ttyS1) Input

Rev 1.4 – 12aug2008


Port 2 Output

Kit Level Converter

Konektor DB9F dan right-angle header tidak dipakai

Rev 1.4 – 12aug2008


.

Menghubungkan ke Converter

Rev 1.4 – 12aug2008


Uji Serial Port 1

Gunakan Hyperterminal / Tera Term (Windows) atau Minicom (linux) Set port ke: 115200,8,N,1

Colok kabel, power on, akan muncul login banner

Rev 1.4 – 12aug2008


Uji Serial Port 2

telnet ke box (192.168.1.2) Buka Tera Term Pro / Hyperterminal, dan set di 9600,8,N,1 Di OpenWrt, kirim string lewat serial port root@OpenWrt:~# cat resolv.conf > /dev/tts/1

Lihat di Terminal apa ada tulisan yang muncul dilayar. Modifikasi hardware sudah selesai

Rev 1.4 – 12aug2008


Serial Port Keluar

Gunakan Stereo 3.5mm jack Pin-out: { { {

Tip: Ring: Base:

Rev 1.4 – 12aug2008

TX Data (ke Pin2 di DB9F) RX Data (ke Pin3 di DB9F) Ground (ke Pin5 di DB9F)


Serial Port di Belakang

Rev 1.4 – 12aug2008


Koneksi ke Radio

Serial Port: Serial 2 {

Serial 1 adalah Unix Console

Setting di TNC (Tracker2): { { {

amode auto abaud 4800 Gunakan otwincfg

Rev 1.4 – 12aug2008


Konfigurasi APRS4R

File konfigurasi ada difolder /etc/aprs4r, dengan ekstensi .yaml Ada beberapa contoh di folder templates cd /etc/aprs4r/templates Copy file di templates menjadi file kita cp gateway.yaml ../[callsign]-1.yaml Start file adalah /etc/default/aprs4r, yang menunjuk ke config file yang akan dipergunakan Menghidupkan APRS4R: /etc/init.d/aprs4r [start | stop | status ]

Rev 1.4 – 12aug2008


Konfigurasi untuk APRS4R

File /etc/default/aprs4r # # aprs4r # START_DAEMON="true" # log4r configuration - temporarily unused LOG="default.log4r" # active profile PROFILE="ABCDEF-X.yaml"

Profile adalah nama config file yang dipergunakan

Rev 1.4 – 12aug2008


Struktur File Konfigurasi

File konfigurasi, misalnya yd0nxx-1.yaml, untuk i-Gate akan berisi, paling minimum: { Devices: rf0 (radio port pertama) is0 (sambungan ke APRS-IS) {

Plugins: rf0Beacons (untuk beacon di RF) is0Beacons (untuk beacon di APRS-IS) rf0is0Gateway (Modul RF to APRS-IS)

Rev 1.4 – 12aug2008


Device rf0

enable: true

Pilihan Serial port { {

COM1: /dev/tts/0 COM2: /dev/tts/1

Mode: kiss/ot2 Baudrate: 4800

Call: callsign anda-SSID

Rev 1.4 – 12aug2008


Device is0

enable: true

Hosts: tidak perlu diubah Username: callsign (boleh + SSID) Filter: “# filter a/5.5/95/-11/141”

{

{

Untuk membatasi Internet traffic, bisa gunakan: "# filter m/100“

Rev 1.4 – 12aug2008


Modules

Rf02is0gateway (membacanya “rf0 to is0 gateway”) input: rf0 output: is0 enable: true

Rev 1.4 – 12aug2008


Ujicoba 1 – Beacon di Internet

Set is0beacon { { {

Hidupkan aprs4r {

/etc/init.d/aprs4r start

Check status {

Enable: true Set koordinat Set interval: 60

/etc/init.d/aprs4r status

Lihat di aprs.fi

Rev 1.4 – 12aug2008


Ujicoba 2 – Baca Traffic RF

Set rf0beacon { {

Hidupkan aprs4r {

Enable: true Set interval: 60 /etc/init.d/aprs4r start

Lihat di UI-View, apakah ada paket diterima via RF dari igate.

Rev 1.4 – 12aug2008


Ujicoba 3 – RF Gate

Set port rf0 dan is0 enable Set rf02is0gateway enable Hidupkan aprs4r Setelah beberapa saat, check aprs.fi dan lihat apakah traffic sudah masuk melalui gateway ini.

Rev 1.4 – 12aug2008


Hasil Akhir Linksys WRT54GL disamping laptop Ubuntu, igate YD0NXX-1 yang lama.

Rev 1.4 – 12aug2008


Perkembangan Dokumen Ini

Dokumen ini, dan dokumen APRS lainnya, akan terus diperbarui, karena teknologi yang terus berkembang Versi terakhir dapat diunduh dari situs: { {

http://files.orari.net dalam folder APRS Folder FILES / APRS dari mailing-list:

[email protected] [email protected]

Diskusi tentang APRS yang men-detil ada di: {

[email protected]

Rev 1.4 – 12aug2008


Referensi

Operating System {

http://openwrt.org

{

http://wiki.openwrt.org/OpenWrtDocs http://wiki.openwrt.org/OpenWrtDocs/KamikazeConfiguration

{

Modifikasi Hardware { { { {

http://wiki.openwrt.org/OpenWrtDocs/Hardware/Linksys/WRT54GL http://www.rwhitby.net/projects/wrt54gs http://voidmain.is-a-geek.net/redhat/wrt54g_revival.html http://www.compsys1.com/workbench/On_top_of_the_Bench/Max233_A dapter/max233_adapter.html

Software iGate { { {

http://aprs4r.org http://aprs4r.org/cgi-bin/trac.cgi/wiki/APRS4RConfigurationHowTo http://martybugs.net/wireless/openwrt/timesync.cgi

Rev 1.4 – 12aug2008


Appendix

Variasi setting router Set clock otomatis Biaya Perintah di Unix Perintah penyuntingan di vi Failsafe Mode Konfigurasi di YD0NXX-1

Rev 1.4 – 12aug2008


Konfigurasi Wireless non-AP

Setting jika bukan sebagai Access Point {

Sebagai AP-client

File /etc/config/wireless option mode sta (tadinya ap)

Rev 1.4 – 12aug2008


Set Clock Otomatis (NTP Time)

Set timezone {

Install ntpclient {

echo WIB-7 > /etc/TZ ipkg install ntpclient

Modifying the startup script {

vi /etc/init.d/ntpclient #!/bin/sh # kill any existing ntpclient processes # (they can get stuck if no route to target host) /usr/bin/killall ntpclient # do time sync /usr/sbin/ntpclient -l -h pool.ntp.org -c 1 -s &

Rev 1.4 – 12aug2008


Set Clock Otomatis (2)

Set to executable {

Supaya autostart waktu boot { {

chmod a+x /etc/init.d/ntpclient cd /etc/rc.d ln -s /etc/init.d/ntpclient S55ntpclient

Setup crontab {

Buat file /etc/crontabs/root dengan isi: # to timesync every 10 minutes */10 * * * * /etc/init.d/ntpclient

Restart crond {

killall crond; /etc/rd.d/S60cron

Rev 1.4 – 12aug2008


Biaya

Wireless Router AD233AK Kit Option lain: { {

Max232 Max233

Rev 1.4 – 12aug2008

Rp 650 ribu USD 19 + 5 Rp 20.000 Rp 90.000


Beberapa Perintah Unix

ls:list, melihat isi folder cd: change directory, masuk atau keluar dari folder cp: copy, membuat duplikat file rm: remove, menghapus file ps: process list, melihat program yang aktif df: disk find, melihat status space dari filesystem vi: masuk ke visual editor reboot: restart operating system

Rev 1.4 – 12aug2008


Menyunting dengan vi di Unix

Command Mode { { { {

Edit mode { {

diawali titik-dua (:) w(rite) q(uit) i(nsert) Tekan I untuk masuk ke insert mode, sekarang bisa melakukan editing Tekan ESC untuk keluar dari Edit mode dan kembali ke Command mode

Keluar dan simpan file Æ :wq Abort editing (keluar tanpa simpan file) Æ :q!

Rev 1.4 – 12aug2008


Module dari APRS4R

Status 24 Juli 2008

Rev 1.4 – 12aug2008


Failsafe Mode

Untuk Recovery kalau box kacau karena salah setup Prosedur: { { { { { { {

Cabut kabel power ke router Sambung router ke PC via kabel lewat LAN1 port. Set PC dengan static IP address ke 192.168.1.3 (gateway dan DNS tidak perlu). Colok kabel power dan tunggu sampai DMZ LED hidup. Sewaktu DMZ LED hidup, tekan tombol Reset atau Secure Easy Setup, beberapa kali. Kalau berhasil, lampu DMZ LED akan berkedip 3 kali setiap detik. Sekarang telnet ke router di 192.168.1.1

Rev 1.4 – 12aug2008


APRS4R di YD0NXX-1 --- !ruby/object:APRS4R::APRS4RConfiguration devices: device0: !ruby/object:APRS4R::AX25SocketConfiguration name: rf0 type: AX25Socket enable: true device: /dev/tts/1 baudrate: 4800 mode: kiss/ot2 speed: 1200 call: YD0NXX-1 duplicatePeriod: 20 timeout: 300 device1: !ruby/object:APRS4R::ISSocketConfiguration name: is0 type: ISSocket enable: false hosts: [germany.aprs2.net, dl.aprs2.net, swiss.aprs2.net] port: 14580 username: YD0NXX-1 filter: "# filter m/100“ duplicatePeriod: 20 timeout: 60 Rev 1.4 – 12aug2008


APRS4R di YD0NXX-1 (2) plugins: plugin1: !ruby/object:APRS4R::BeaconPluginConfiguration name: igate is beacon type: BeaconPlugin enable: false device: is0 offset: 0 period: 300 message: !ruby/object:APRS4R::APRSMessage destination: AP4R10 payload: "!0615.20SI10646.20E&APRS4R IGATE on Linksys WRT54GL" source: YD0NXX-1 path: [] plugin10: !ruby/object:APRS4R::GatewayPluginConfiguration name: rf02is0 Gateway type: GatewayPlugin enable: false inDevice: rf0 outDevice: is0

Rev 1.4 – 12aug2008


APRS i-gate in a Box (APRS 403)

Recommend Documents