fhunleth
VintageNet - A new network configuration library for Nerves
VintageNet is new network configuration library built specifically for Nerves Project devices. It addresses shortcomings with NervesNetwork that made that library difficult to maintain and extend.
We’ve been working on VintageNet for a while and we’re finally ready for more people to try it out.
Currently, the library supports:
- Configuration for wired Ethernet, WiFi, and direct connections (to support USB gadget mode networking)
- WiFi AP mode use
- Network status and events via a simple get/subscribe interface
- Saving and restoring network configurations across reboots (you can turn this off if your application wants to take care of this)
- Connection monitoring and automatic switching between working interfaces. For example, you could set it up to prefer WiFi/Ethernet for internet access, but fail over to a metered connection should they not work.
If you would like to learn more about VintageNet, take a look at the following posts:
VintageNet is currently in production use. It is not yet in the Nerves documentation, examples, and new project generator. We will be working on making it easier to use in your projects over the coming months.
There are some caveats:
- VintageNet is not compatible with the
nerves_init_gadgetproject. See nerves_pack for something similar. - VintageNet requires minor Linux kernel and Busybox updates. We’ve updated the official Nerves systems, but if you’ve made a custom system, please see these notes. The error messages if you’re missing the updates are not easy to understand.
- Networking is harder than it looks especially when you need it to work unattended. If something seems weird or wrong, let us know. It could be in an area we haven’t verified (for example, WPA-EAP has a LOT of options and we’ve only deployed to two types of WPA-EAP setups so far).
- While not specifically VintageNet, if you’re using mDNS for discovery and it doesn’t work on WiFi, please check if your admin disabled multicast.
I’ve been wanting to update NervesNetwork for years, but it took SmartRent having a business need to make it happen. Thanks also to Connor Rigby, Matt Ludwigs, Jon Carstens and Justin Schneck, and also thanks to Le Tote and FarmBot who both put VintageNet into production early on and provided useful feedback.
Stay tuned for updates and let us know if you want to collaborate on supporting new types of networks or features.
Most Liked
fhunleth
We’ve made quite a bit of progress since the previous VintageNet. The current release is 0.7.7. While it’s currently pre-1.0, it is being used in production and API changes are expected to be small in the future. With the Nerves 1.6 release, it became the default network configuration library for new projects.
Since the previous announcement, the following are new:
- Cellular modem support via
vintage_net_mobile- Several modems are supported out-of-the-box including ones supporting LTE CAT M1 and NB1 service. That’s the “IoT” form of LTE (basically slower and less expensive than the data service that you get on your phone). - Enterprise WiFi support (WPA-EAP PEAP) in
vintage_net_wifiandvintage_net_wizard - WiFi captive portal creation - This is the network side. You’ll need to supply the webserver. The
vintage_net_wizardis an example. - Bug fixes and reliability improvements throughout
While the project README.md’s have the primary documentation, if you’re looking for copy-and-paste configuration examples, check out the cookbook.md.
fhunleth
My experience has been that the USB-based modems that support QMI tend to all basically work. The BG96 is a CAT-M1 modem so you might run into issues with service providers. The CAT-1 and better modules (EC21, EC25, etc) all should be low effort. I say “should” since error messages aren’t great for things like inactivated SIM cards or APN typos that will prevent the modem from connecting.
fhunleth
None of the SIMCom chipsets are currently supported. That doesn’t mean that you can’t use them, but they would require some work. It’s really hard to tell the level of effort until you plug a modem in since it could “just work” or require getting into Linux kernel drivers and usb_modeswitch. If you post a GitHub issue/PR to vintage_net_mobile, I can try to help.
At the moment, Quectel BG96 and EC25 modems are the best supported.
D4no0
Hey, any updates on this?
I want to make a personal project where I need internet connectivity and I was wondering what is the best non-enterprise hardware you can use these days with nerves + RPI? Are Quectel BG96 and EC25 modems still the optimal solution?
Popular in Libraries
Other popular topics
Latest Nerves Threads
Latest on Elixir Forum
Sponsor Spotlight
Develop your skills with books, videos, and courses.
Categories:
Sub Categories:
Forums
Our Sponsors
Build Elixir applications with speed and confidence.
Supporting innovation across the BEAM ecosystem.
We build reliable cloud platforms for business-critical systems.
Catch errors, track performance, monitor hosts and more.
Practical resources that improve the lives of professional developers.
Develop your skills with books, videos, and courses.
The deployment platform built for Elixir: PaaS ease, VPS control.
Courses that'll move you from confusion to "Aha, now I get it!"