Sensor GPS#

Perkenalan#

Sensor V5 GPS (Game Positioning System™) menyediakan pelacakan posisi dan orientasi yang akurat untuk robot di Lapangan VEX. Sensor ini menggunakan Kode Lapangan GPS di sekitar perimeter Lapangan untuk menghitung koordinat X dan Y serta arah robot secara real-time.

Sensor GPS mengembalikan posisi robot menggunakan titik referensi yang dihitung secara otomatis dari offset yang dimasukkan saat mengkonfigurasi Sensor GPS di jendela Perangkat.

Untuk informasi lebih lanjut mengenai Sensor GPS, baca Menggunakan Sensor GPS dengan VEX V5 di Pustaka VEX.

Titik referensi bertindak sebagai posisi (0, 0) Sensor GPS itu sendiri, di mana semua koordinat, arah, dan pergerakan yang dikembalikan oleh metode GPS bersifat relatif terhadap titik yang dikonfigurasi ini.

Sensor GPS VEX V5.

Halaman ini menggunakan gps_sensor sebagai contoh nama Sensor GPS. Ganti dengan nama yang Anda konfigurasi sendiri sesuai kebutuhan.

Berikut adalah daftar metode yang tersedia:

  • calibrate – Mengkalibrasi Sensor GPS untuk mengatur arahnya sesuai dengan arah penggerak saat ini.

  • set_origin – Mengatur posisi titik referensi pada robot.

  • set_location – Mengatur posisi dan arah titik referensi pada Lapangan.

  • x_position – Mengembalikan koordinat x titik referensi pada Field.

  • y_position – Mengembalikan koordinat y titik referensi pada Field.

  • heading – Mengembalikan heading titik referensi berdasarkan orientasi Field.

  • acceleration – Mengembalikan percepatan robot pada sumbu yang dipilih.

  • gyro_rate – Mengembalikan kecepatan rotasi robot pada sumbu yang dipilih.

  • orientation – Mengembalikan orientasi roll, pitch, atau yaw robot dalam derajat.

  • quality – Mengembalikan kekuatan sinyal Sensor GPS.

  • changed – Mendaftarkan fungsi yang akan dipanggil setiap kali Sensor GPS mendeteksi perubahan arah.

Konstruktor – Menginisialisasi Sensor GPS secara manual.

  • Gps – Membuat Sensor GPS.

menyesuaikan#

calibrate mengkalibrasi titik referensi, menetapkan arah yang telah dikonfigurasi sebagai arah penggerak saat ini. Selama waktu ini, robot harus tetap diam sepenuhnya karena pergerakan selama kalibrasi akan menghasilkan hasil yang tidak akurat.

Usage:
gps_sensor.calibrate()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

set_origin#

set_origin mengatur posisi titik referensi pada robot secara manual. Ini dapat dilakukan untuk mengatur lokasi Sensor GPS pada robot secara manual, bukan melalui pengaturan konfigurasi.

Usage:
gps_sensor.set_origin(x, y, distance_units)

Parameter

Keterangan

X

Koordinat x dari titik referensi pada robot.

y

Koordinat y dari titik referensi pada robot.

satuan_jarak

Satuan pengukuran untuk koordinat x dan y:

  • MM – milimeter
  • INCHES

# GPS Sensor is mounted 25mm forward
# from the reference point on a robot

gps.set_origin(0, 25, MM)

atur_lokasi#

set_location mengatur posisi dan arah titik referensi di Lapangan secara manual. Ini dapat dilakukan untuk membantu mengurangi ketidakakuratan jika Sensor GPS terlalu dekat dengan dinding Lapangan saat startup sehingga tidak dapat melihat Kode Lapangan GPS dalam jumlah yang cukup.

Tampilan dari atas bidang VEX V5 yang menunjukkan sensor menghadap Kode Bidang di sisi bidang.

Usage:
gps_sensor.set_location(x, y, distance_units, heading, heading_units)

Parameter

Keterangan

X

Koordinat x dari titik referensi pada Lapangan.

y

Koordinat y dari titik referensi pada Lapangan.

satuan_jarak

Satuan pengukuran untuk koordinat x dan y:

  • MM – milimeter
  • INCHES

menuju

Arah yang ditunjukkan oleh titik referensi relatif terhadap arah bidang absolut dari 0 hingga 359,9 derajat.

unit_penajaman

Satuan ukuran untuk judul:DEGREES

posisi x#

x_position mengembalikan koordinat x titik referensi pada Field.

Usage:
gps_sensor.x_position(units)

Parameter

Keterangan

satuan

Satuan pengukuran:

  • MM – milimeter
  • INCHES

posisi y#

y_position mengembalikan koordinat y titik referensi pada Field.

Usage:
gps_sensor.y_position(units)

Parameter

Keterangan

satuan

Satuan pengukuran:

  • MM – milimeter
  • INCHES

menuju#

heading mengembalikan arah titik referensi berdasarkan orientasi Field dari 0 hingga 359,9 derajat.

Arah haluan tersebut sesuai dengan arah haluan absolut lapangan, yang merupakan rentang 0º hingga 359,9º searah jarum jam. Titik 0º berada pada posisi pukul 12.

Tampilan dari atas bidang VEX V5 yang menunjukkan derajat di sekitar bidang.

Usage:
gps_sensor.heading()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

percepatan#

acceleration mengembalikan percepatan robot pada sumbu tertentu dari -4,0 hingga 4,0 Gs.

Usage:
gps_sensor.acceleration(axis)

Parameter

Keterangan

sumbu

Sumbu mana yang akan digunakan:

  • AxisType.XAXIS
  • AxisType.YAXIS
  • AxisType.ZAXIS

kecepatan_giroskop#

gyro_rate mengembalikan kecepatan rotasi robot pada sumbu yang dipilih.

Usage:
gps_sensor.gyro_rate(axis, units)

Parameter

Keterangan

sumbu

Sumbu mana yang akan digunakan:

  • AxisType.XAXIS
  • AxisType.YAXIS
  • AxisType.ZAXIS

satuan

Satuan pengukuran:

  • VelocityUnits.DPS – derajat per detik, dari -1000 hingga 1000
  • VelocityUnits.RPM – putaran per menit, dari -167 hingga 167

orientasi#

orientation mengembalikan orientasi roll, pitch, atau yaw robot dalam derajat.

Usage:
gps_sensor.orientation(axis, units)

Parameter

Keterangan

sumbu

Orientasi mana yang akan digunakan:

  • OrientationType.ROLL
  • OrientationType.PITCH
  • OrientationType.YAW

satuan

Satuan pengukuran:DEGREES

kualitas#

quality mengembalikan kekuatan sinyal Sensor GPS dalam bentuk persentase.

Nilai yang Mungkin

Keterangan

100

Semua data posisi dan arah yang dilaporkan dari Sensor GPS adalah valid.

~90

Data posisi tidak lagi dihitung dengan menangkap informasi dari Kode Lapangan GPS, melainkan melalui cara alternatif.

0 - 80

Hanya nilai arah dari Sensor GPS yang valid, tetapi seiring berjalannya waktu dan Sensor GPS tidak memindai cukup banyak Kode Medan GPS untuk menentukan informasi posisi dan arah secara akurat, kualitas sinyal yang dilaporkan akan terus menurun hingga 0, di mana semua data Sensor GPS secara efektif dibekukan dan tidak lagi valid.

Usage:
gps_sensor.quality()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

berubah#

changed mendaftarkan sebuah fungsi yang akan dipanggil setiap kali Sensor GPS mendeteksi perubahan arah.

Usage:
gps_sensor.changed(callback, arg)

Parameter

Keterangan

callback

Sebuah fungsi yang telah didefinisikan sebelumnya yang akan dieksekusi ketika arah Sensor GPS berubah.

arg

Opsional. Sebuah tuple yang berisi argumen untuk diteruskan ke fungsi callback. Lihat Menggunakan Fungsi dengan Parameter untuk informasi selengkapnya.

def my_function():
  brain.screen.print("GPS heading changed")

# Call my_function whenever gps_sensor's heading changes
gps_sensor.changed(my_function)

Konstruktor#

Konstruktor digunakan untuk membuat objek Gps secara manual, yang diperlukan untuk mengkonfigurasi Sensor GPS di luar VEXcode.

Gps#

Gps membuat Sensor GPS.

Usage:
Gps(smartport)

Parameter

Keterangan

smartport

Port Pintar yang terhubung dengan Sensor GPS, ditulis sebagai Ports.PORTx di mana x adalah nomor port.

# Create a GPS Sensor in Port 10
gps_sensor = Gps(Ports.PORT10)