This is the LibreMap submit agent for routers that run openwrt. The agent gathers information about your router and sends it to a LibreMap server (you can run your own!).
If your openwrt installation uses an opkg repository where the libremap-agent
package is included then simply run
opkg update && opkg install libremap-agent
The plain libremap-agent
package only uploads a minimal description of your router to a LibreMap server and you probably want to install some plugins that provide additional information (like community data, links of routing protocols like OLSR or batman-adv, ...). The following plugin packages are available:
luci-lib-libremap-babel
- Gathers links and neighbors information from the babel protocol on the routerluci-lib-libremap-contact
- Provide contact information of the router operatorluci-lib-libremap-location
- Provide latitude/longitude/elevation of the routerluci-lib-libremap-olsr
- Gathers links to OLSR neighbors (IPv4+IPv6) of the routerluci-lib-libremap-system
- Provide information about your router (hostname, hardware, memory)
Compilation is straight forward if you know openwrt. If you're not familiar with openwrt, then check out these steps:
-
Clone openwrt repo and change into new directory:
git clone git://git.openwrt.org/openwrt.git && cd openwrt
-
Add luci and libremap feeds to feeds.conf:
src-git luci git://nbd.name/luci.git src-git libremap https://github.com/libremap/libremap-agent-openwrt.git
and enable them:
./scripts/feeds update -a ./scripts/feeds install -p luci -a ./scripts/feeds install -p libremap -a
3. Configure with `make menuconfig`. The `libremap-agent` can be found under *Utilities* and all plugins `luci-lib-libremap-*` can be found under *LuCI / Libraries*.
4. Run `make`, grab a :coffee: and use your packages under `bin/xxxx/packages/`.
## Development
Bug reports and feature requests should be filed as issues in this repository.
Feel free to extend the submit agent by enhancing an already available plugin or by writing a new one. We'd be happy to include your plugin in this repository - please file a pull request!