Skip to content

Commit 37ee90b

Browse files
authored
Merge pull request #297 from liamcottle/docs/readme-update
A few adjustments to the readme
2 parents 885cfe9 + 86d1c80 commit 37ee90b

File tree

1 file changed

+48
-13
lines changed

1 file changed

+48
-13
lines changed

README.md

Lines changed: 48 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -25,18 +25,52 @@ MeshCore provides the ability to create wireless mesh networks, similar to Mesht
2525

2626
## 🚀 How to Get Started
2727

28-
Andy Kirby has published a very useful [intro video](https://www.youtube.com/watch?v=t1qne8uJBAc) which explains the steps for beginners.
28+
- Watch the [MeshCore Intro Video](https://www.youtube.com/watch?v=t1qne8uJBAc) by Andy Kirby.
29+
- Read through our [Frequently Asked Questions](./docs/faq.md) section.
30+
- Flash the MeshCore firmware on a supported device.
31+
- Connect with a supported client.
2932

30-
For developers, install [PlatformIO](https://docs.platformio.org) in Visual Studio Code.
31-
Download & Open the MeshCore repository.
32-
Select a Sample Application: Choose from chat, repeater, other example app.
33-
Monitor & Communicate using the Serial Monitor (e.g., Serial USB Terminal on Android).
33+
For developers;
3434

35-
📁 Included Example Applications
36-
* 📡 Terminal Chat: Secure text communication between devices.
37-
* 📡 Simple Repeater: Extends network coverage by relaying messages.
38-
* 📡 Companion Radio: For use with an external chat app, over BLE or USB.
39-
* 📡 Room Server: A simple BBS server for shared Posts.
35+
- Install [PlatformIO](https://docs.platformio.org) in [Visual Studio Code](https://code.visualstudio.com).
36+
- Clone and open the MeshCore repository in Visual Studio Code.
37+
- See the example applications you can modify and run:
38+
- [Companion Radio](./examples/companion_radio) - For use with an external chat app, over BLE, USB or WiFi.
39+
- [Simple Repeater](./examples/simple_repeater) - Extends network coverage by relaying messages.
40+
- [Simple Room Server](./examples/simple_room_server) - A simple BBS server for shared Posts.
41+
- [Simple Secure Chat](./examples/simple_secure_chat) - Secure terminal based text communication between devices.
42+
43+
The Simple Secure Chat example can be interacted with through the Serial Monitor in Visual Studio Code, or with a Serial USB Terminal on Android.
44+
45+
## ⚡️ MeshCore Flasher
46+
47+
We have prebuilt firmware ready to flash on supported devices.
48+
49+
- Launch https://flasher.meshcore.co.uk
50+
- Select a supported device
51+
- Flash one of the firmware types:
52+
- Companion, Repeater or Room Server
53+
- Once flashing is complete, you can connect with one of the MeshCore clients below.
54+
55+
## 📱 MeshCore Clients
56+
57+
**Companion Firmware**
58+
59+
The companion firmware can be connected to via BLE, USB or WiFi depending on the firmware type you flashed.
60+
61+
- Web: https://app.meshcore.nz
62+
- Android: https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android
63+
- iOS: https://apps.apple.com/us/app/meshcore/id6742354151?platform=iphone
64+
- NodeJS: https://github.com/liamcottle/meshcore.js
65+
- Python: https://github.com/fdlamotte/meshcore-cli
66+
67+
**Repeater and Room Server Firmware**
68+
69+
The repeater and room server firmwares can be setup via USB in the web config tool.
70+
71+
- https://config.meshcore.dev
72+
73+
They can also be managed via LoRa in the mobile app by using the Remote Management feature.
4074

4175
## 🛠 Hardware Compatibility
4276

@@ -53,6 +87,7 @@ MeshCore is designed for use with:
5387
* LilyGo TLora32 v1.6
5488

5589
## 📜 License
90+
5691
MeshCore is open-source software released under the MIT License. You are free to use, modify, and distribute it for personal and commercial projects.
5792

5893
## Contributing
@@ -62,9 +97,9 @@ For minor changes just submit your PR and I'll try to review it, but for anythin
6297

6398
## 📞 Get Support
6499

65-
Check out the GitHub Issues page to report bugs or request features.
66-
67-
You will be able to find additional guides and components at [my site](https://buymeacoffee.com/ripplebiz), or [join Andy Kirby's Discord](https://discord.gg/GBxVx2JMAy) for discussions.
100+
- Report bugs and request features on the [GitHub Issues](https://github.com/ripplebiz/MeshCore/issues) page.
101+
- Find additional guides and components on [my site](https://buymeacoffee.com/ripplebiz).
102+
- Join [Andy Kirby's Discord](https://discord.gg/GBxVx2JMAy) to chat with the developers and get help from the community.
68103

69104
## RAK Wireless Board Support in PlatformIO
70105

0 commit comments

Comments
 (0)