Net::G...tellite(3pm)

💖 Net::G...tellite(3pm) 💖

okay bestie, so this is a User Contributed Perl Documentation page for Net::GPSD3::Return::Satellite — the satellite object you get back from the Net::GPSD3 return crew. pull up a chair, we're decoding GPS sky data together 🛰️✨

---

✨ NAME ✨

Net::GPSD3::Return::Satellite — the Net::GPSD3 Return Satellite Object, no cap 🛰️💅

---

🌸 SYNOPSIS 🌸

use Net::GPSD3 0.13;
my $gpsd = Net::GPSD3->new;
my $poll = $gpsd->poll;  #new method in 0.12
my $sky  = $poll->sky;   #new method in 0.13
printf "Reported: %s, Used: %s\n", $sky->reported, $sky->used;
printf "PRN: %s\n", join(", ", map {$_->used ? $_->prn : "-".$_->prn} $sky->Satellites);

look at that glow-up ✨ poll showed up in 0.12, sky joined the group chat in 0.13, and now we're printing which satellites are actually being used versus the ones that are just... there. not me checking ->used to decide whether to slap a - in front of the PRN 😭 literally the main character energy of a signal report.

---

🦋 DESCRIPTION 🦋

so what even is this? it gives you a Perl object interface to the Satellite data structure that the GPSD daemon hands back. that's it, that's the vibe 🫶

here's an example JSON string, so you can see exactly what shape the tea is in:

{"PRN":15,"el":77,"az":123,"ss":0, "used":false},

see? PRN, el, az, ss, used. five little fields, one whole satellite bestie 💫

---

👑 METHODS 👑

💅 class

returns the object class. classic.

💅 string

returns the JSON string. the raw receipts.

💅 parent

returns the parent Net::GPSD object — yeah it knows its mom 🥹

💅 PRN, prn

returns the GPS Satellites Pseudo Random Number Identifier. that's the satellite's whole little name-tag 🏷️

💅 used

returns a JSON::XS::Boolean true or false object. note that it's a boolean object, not just some regular scalar — keep that in mind, bestie ⭐

💅 az, azimuth

returns the azimuth, degrees from true north. where it is on the compass 🧭

💅 el, elevation

returns the Elevation in degrees. how high up it's floating 📐

💅 ss

Signal strength in dBHz. that's the bars, essentially 🔥

Note: C/N0 is dBHz usually, but trimbles can also emit poorly specified Amplitude Measurement Units. so like... mostly dBHz, but Trimble said "we're gonna do our own thing" 🙈 don't assume, okay?

---

💀 BUGS 💀

Log on RT and Send to gpsd-dev email list. found a bug? RT it, then send it to the gpsd-dev email list. two steps, don't skip one 🫡

---

🌈 SUPPORT 🌈

DavisNetworks.com supports all Perl applications including this package. periodt 💪

Try gpsd-dev email list. that's the move.

---

🎀 AUTHOR 🎀

Michael R. Davis
CPAN ID: MRDVT
STOP, LLC
domain=>michaelrdavis,tld=>com,account=>perl
http://www.stopllc.com/

the icon who wrote this 👑 (and yes, that email is obfuscated in the most cursed-but-cute key=>value way imaginable, iykyk)

---

⭐ COPYRIGHT ⭐

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the LICENSE file included with this module. so like, it's free, it's BSD, go read the LICENSE file if you want the whole thing 📜

---

🔥 SEE ALSO 🔥

• Net::GPSD3
• Net::GPSD3::Return::Unknown

---

and that's the whole page, bestie 💖 this was perl v5.34.0, dated 2022-06-16, from the Net::G...tellite(3pm) file in your local perl docs. go forth and read your satellites 🌸🦋✨