70 lines
3.1 KiB
Nix
70 lines
3.1 KiB
Nix
# pinephone GPS happens in EG25 modem
|
|
# serial control interface to modem is /dev/ttyUSB2
|
|
# after enabling GPS, readout is /dev/ttyUSB1
|
|
#
|
|
# minimal process to enable modem and GPS:
|
|
# - `echo 1 > /sys/class/modem-power/modem-power/device/powered`
|
|
# - `screen /dev/ttyUSB2 115200`
|
|
# - `AT+QGPSCFG="nmeasrc",1`
|
|
# - `AT+QGPS=1`
|
|
# this process is automated by my `eg25-control` program and services (`eg25-control-powered`, `eg25-control-gps`)
|
|
# - see the `modules/` directory further up this repository.
|
|
#
|
|
# now, something like `gpsd` can directly read from /dev/ttyUSB1,
|
|
# or geoclue can query the GPS directly through modem-manager
|
|
#
|
|
# initial GPS fix can take 15+ minutes.
|
|
# meanwhile, services like eg25-manager or eg25-control-freshen-agps can speed this up by uploading assisted GPS data to the modem.
|
|
#
|
|
# support/help:
|
|
# - geoclue, gnome-maps
|
|
# - irc: #gnome-maps on irc.gimp.org
|
|
# - Matrix: #gnome-maps:gnome.org (unclear if bridged to IRC)
|
|
#
|
|
# programs to pair this with:
|
|
# - `satellite-gtk`: <https://codeberg.org/tpikonen/satellite>
|
|
# - shows/tracks which satellites the GPS is connected to; useful to understand fix characteristics
|
|
# - `gnome-maps`: uses geoclue, has route planning
|
|
# - `mepo`: uses gpsd, minimalist, flaky, and buttons are kinda hard to activate on mobile
|
|
# - puremaps?
|
|
# - osmin?
|
|
#
|
|
# known/outstanding bugs:
|
|
# - `systemctl start eg25-control-gps` can the hang the whole system (2023/10/06)
|
|
# - i think it's actually `eg25-control-powered` which does this (started by the gps)
|
|
# - best guess is modem draws so much power at launch that other parts of the system see undervoltage
|
|
# - workaround is to hard power-cycle the system. the modem may not bring up after reboot: leave unpowered for 60s and boot again.
|
|
#
|
|
# future work:
|
|
# - integrate with [wigle](https://www.wigle.net/) for offline equivalent to Mozilla Location Services
|
|
|
|
{ config, lib, ... }:
|
|
{
|
|
# test gpsd with `gpspipe -w -n 10 2> /dev/null | grep -m 1 TPV | jq '.lat, .lon' | tr '\n' ' '`
|
|
# ^ should return <lat> <long>
|
|
services.gpsd.enable = true;
|
|
services.gpsd.devices = [ "/dev/ttyUSB1" ];
|
|
|
|
# test geoclue2 by building `geoclue2-with-demo-agent`
|
|
# and running "${geoclue2-with-demo-agent}/libexec/geoclue-2.0/demos/where-am-i"
|
|
# note that geoclue is dbus-activated, and auto-stops after 60s with no caller
|
|
services.geoclue2.enable = true;
|
|
services.geoclue2.appConfig.where-am-i = {
|
|
# this is the default "agent", shipped by geoclue package: allow it to use location
|
|
isAllowed = true;
|
|
isSystem = false;
|
|
# XXX: setting users != [] might be causing `where-am-i` to time out
|
|
users = [
|
|
# restrict to only one set of users. empty array (default) means "allow any user to access geolocation".
|
|
(builtins.toString config.users.users.colin.uid)
|
|
];
|
|
};
|
|
systemd.services.geoclue.after = lib.mkForce []; #< defaults to network-online, but not all my sources require network
|
|
users.users.geoclue.extraGroups = [
|
|
"dialout" # TODO: figure out if dialout is required. that's for /dev/ttyUSB1, but geoclue probably doesn't read that?
|
|
];
|
|
|
|
sane.services.eg25-control.enable = true;
|
|
sane.programs.where-am-i.enableFor.user.colin = true;
|
|
}
|