From 95a777db7e7053b7510eb85e7f0cb765d0fd8380 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Mon, 13 Oct 2014 17:18:06 -0400 Subject: [PATCH 01/20] update about page to remove references to GSM and desktop clients; updated OTI logo and links --- commotionwireless.net/about/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/commotionwireless.net/about/index.md b/commotionwireless.net/about/index.md index ae1e15ac..ab01d08e 100644 --- a/commotionwireless.net/about/index.md +++ b/commotionwireless.net/about/index.md @@ -8,7 +8,7 @@ changed: 2013-12-18 post_author: admin lang: en --- -

Commotion is a free, open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks. Commotion provides a way for you to share your Internet connection with the people around you, but it is not a replacement for your Internet connection. Read more about how Commotion works on our Frequently Asked Questions page.

+

Commotion is a free, open-source communication tool that uses wireless devices to create decentralized mesh networks. Commotion provides a way for you to share your Internet connection with the people around you, but it is not a replacement for your Internet connection. Read more about how Commotion works on our Frequently Asked Questions page.

Mesh Networking Across Devices

@@ -32,7 +32,7 @@ lang: en

Feel free to contact us.

-

Commotion is led by the Open Technology Institute.

+

Commotion is led by the Open Technology Institute.

-

Open Technology Institute logo

+

Open Technology Institute logo

From cf0f31a0f14df5c36b7e6eaf780ed77964a66d47 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Mon, 13 Oct 2014 17:33:05 -0400 Subject: [PATCH 02/20] added new OTI logo --- .../files/opentechnology_black.png | Bin 0 -> 7678 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 commotionwireless.net/files/opentechnology_black.png diff --git a/commotionwireless.net/files/opentechnology_black.png b/commotionwireless.net/files/opentechnology_black.png new file mode 100644 index 0000000000000000000000000000000000000000..0b6a38d323b4f0bda6f5687ad7ccb976f47265a6 GIT binary patch literal 7678 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 literal 0 HcmV?d00001 From aff09efdfcef69c81b410fcfd47c1d603e5ea0e8 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Mon, 13 Oct 2014 17:33:40 -0400 Subject: [PATCH 03/20] updated FAQ to remove references to GSM and desktop clients; copy edits; added entry about bash bug --- commotionwireless.net/about/faq/index.md | 53 +++++++++++------------- 1 file changed, 24 insertions(+), 29 deletions(-) diff --git a/commotionwireless.net/about/faq/index.md b/commotionwireless.net/about/faq/index.md index 224efa83..4fa47e77 100644 --- a/commotionwireless.net/about/faq/index.md +++ b/commotionwireless.net/about/faq/index.md @@ -12,25 +12,25 @@ lang: en

General

What is Commotion?

-

Commotion is a suite of open-source communications tools that use mobile phones, computers, and other wireless devices to create decentralized mesh networks and share local services. Read more about the devices Commotion supports and more about how it works below.

+

Commotion is a suite of open-source communications tools that use wireless devices to create decentralized mesh networks and share local services. Read more about the devices Commotion supports and more about how it works below.

Does commotion provide Internet access? Is it possible to share Internet access with Commotion?

Commotion does not provide Internet access.

-

You can certainly share Internet access using Commotion, though we recommend that you consult the Terms of Service from your ISP. All that is required is to connect a router with Commotion installed to an existing Internet connection to provide an Internet gateway. The Commotion router will share bandwidth with other devices on the mesh network from that connection. Multiple routers can be used to do this on a mesh network to provide multiple gateways and additional bandwidth. See the section "Commotion Node Connected to a Home or Business Router" on the Common Configurations page

+

You can certainly share Internet access using Commotion, though we recommend that you consult the Terms of Service from your ISP. All that is required is to connect a router with Commotion installed to an existing Internet connection to provide an Internet gateway. The Commotion router will share bandwidth with other devices on the mesh network from that connection. Multiple routers can be used to do this on a mesh network to provide multiple gateways and additional bandwidth. See the section "One or more nodes connected to a gateway" on the Common Hardware Setups page.

How does Commotion work?

-

Commotion is software that is installed on smartphones, Wi-Fi enabled computers, wireless routers and other wireless-capable personal devices. It enables the creation of peer-to-peer (mesh) communications networks. The Commotion Project's goal is to provide an easy-to-assemble package of software and documentation that makes building mesh networks accessible for a wide audience.

+

Commotion is software that is installed on wireless routers. It enables the creation of peer-to-peer (mesh) communications networks. The Commotion Project's goal is to provide an easy-to-assemble package of software and documentation that makes building mesh networks accessible for a wide audience.

What is mesh? What is a mesh network? How does it work?

-

There are many different types of networks. Most networks that we interact with everyday are based on a hub and spoke model. Mesh networks are based on the idea that any point in the network, or node, can talk to any other point in the network, similar to how human networks work. You can read more about mesh networks in the Commotion Construction Kit: http://commotionwireless.net/docs/cck/networking/intro-to-mesh/

+

There are many different types of networks. Most networks that we interact with everyday are based on a hub and spoke model. Mesh networks are based on the idea that any point in the network, or node, can talk to any other point in the network, similar to how human networks work. You can read more about mesh networks in the Commotion Construction Kit's Introduction to Mesh.

What are the core components of Commotion?

-

Commotion integrates and extends several open source software projects. Among its core components are OLSRd (the mesh routing protocol upon which Commotion is built), OpenWRT (the embedded Linux distribution used to install Commotion on routers), OpenBTS (the software that enables Commotion’s GSM cell phone functionality), and Serval (which enables secure and distributed mesh applications and routing).

+

Commotion integrates and extends several open source software projects. Among its core components are OLSRd (the mesh routing protocol upon which Commotion is built), OpenWRT (the embedded Linux distribution used to install Commotion on routers), Serval (which enables secure and distributed mesh applications and routing), as well as a number of custom built components.

Will using Commotion allow access to services and websites blocked by our local ISP?

While Commotion does not attempt to block websites or Internet services by default, Commotion networks may be subject to whatever restrictions are in place on that Internet connection. However, it will allow users with an uncensored Internet connection to share that connection with other network users. Users may also share information directly with each other and store that data until such time as an uncensored Internet connection is available.

-

Is there any difference between your technology and other low cost mesh vendors or firmwares like open-mesh, ddwrt, Freifunk, etc.

+

Is there any difference between your technology and other low cost mesh vendors or firmwares like Open-Mesh, DD-WRT, Freifunk, etc.

The short answer is yes, there are many differences, but there is also a significant amount of overlap. For example, both Commotion and Freifunk use OpenWRT as a base but have different feature sets due to their different use cases.

Each of these projects has goals and priorities that are reflected in their design choices. Commotion is primarily designed to package well-supported, free, open source firmware with default configurations and administrative tools that make it possible for new users to build and maintain a network with minimal outside support.

@@ -44,21 +44,19 @@ lang: en
  • commotion-dev: for those who want to discuss improvements the Commotion software
    • -

    You can also join us on irc in #commotion on the freenode.net server

    +

    You can also join us on IRC in #commotion on the freenode.net server

    Access & Installation

    -

    What kind of equipment do I need to use Commotion? I have a specific router- Is it compatible with Commotion? Do you have images for it?

    -

    At minimum Commotion requires two or more Wi-Fi enabled devices, such as laptops, routers, or smartphones, to create a standalone network. New users may join an existing network using other Wi-Fi devices or standard GSM mobile phones.

    +

    What kind of equipment do I need to use Commotion? I have a specific router—Is it compatible with Commotion? Do you have images for it?

    +

    At minimum Commotion requires two or more Wi-Fi enabled routers in order to create a standalone network. New users may join an existing network as clients using other Wi-Fi devices such as laptops or mobile phones.

    -

    Our development has focused on supporting Ubiquiti devices, and we are testing other brands with similar hardware such as TP-Link, Mikrotik and others. Technically, any router that's ar71xx and capable of OpenWRT Attitude Adjustment should work. See our list of potentially compatible routers on our developer wiki for more information.

    +

    Our development has focused on supporting Ubiquiti devices, and we are testing other brands with similar hardware such as TP-Link, Mikrotik, and others. Technically, any router that uses the ar71xx chipset and supports OpenWRT Attitude Adjustment should work. See our list of potentially compatible routers on our developer wiki for more information. If you have a router on the list and would like to help test new devices, contact us and we might be able to build a custom image for you to test!

    As new platforms are tested and confirmed working, we add them to our supported hardware lists and publish pre-compiled images for them. You can view a list of hardware currently in testing on our developer wiki. If you have suggestions of hardware that we should look into, or that you'd like to experiment with, please contact us.

    -

    If you don't find your router on the Commotion Router downloads page, check our Developer Hardware in testing wiki page which lists devices being tested with Commotion Router by the development team and other project contributors. We also maintain a list of potentially compatible routers on our developer wiki. If you have a router on the list and would like to help test new devices, contact us and we might be able to build a custom image for you to test!

    -

    Does Commotion support routers with multiple radios (5Ghz and 2.4Ghz)?

    -

    Since version 1.0 of Commotion-Router, support is available for dual radio devices. We test and release images for new supported routers as we have available devices. Check our Developer Hardware in testing wiki page for devices being tested with Commotion Router by the development team and project other contributors. We also maintain a list of potentially compatible routers on our developer wiki.

    +

    Since version 1.0 of Commotion-Router, support is available for dual radio devices. We test and release images for new supported routers as we have available devices. Check our Developer Hardware in testing wiki page for devices being tested with Commotion Router by the development team and other project contributors. We also maintain a list of potentially compatible routers on our developer wiki.

    Who can download and use this software?

    Anyone. Commotion is an open source project and a central goal of the project team is to ensure that it is freely available to those who need it, that it works properly on available hardware, and that it can be extended to suit local needs. We strive to make it easily accessible and distributable.

    @@ -78,7 +76,7 @@ lang: en

    Security

    Is Commotion Secure?

    -

    Commotion's security features are constantly evolving. For up-to-date information on Commotion's security model and features, please see: https://commotionwireless.net/understanding-commotions-warning-label

    +

    Commotion's security features are constantly evolving. For up-to-date information on Commotion's security model and features, please see Understanding Commotion's Warning Label.

    How can users differentiate fake Commotion networks from legitimate mesh networks?

    Individuals should treat new networks, based on Commotion or otherwise, with the degree of trust that they deserve. They should only use networks that they trust and, if they doubt the trustworthiness of the network, use standard end-to-end encryption technology like HTTPS to secure their data as it passes over that network.

    @@ -86,6 +84,9 @@ lang: en

    Is Commotion susceptible to the Heartbleed OpenSSL bug?

    No, Commotion's wireless router implementations use CyaSSL, which is a separate implementation of SSL. A developer of CyaSSL posted a note about this. We also tested it ourselves using the nmap scripting engine’s heartbleed vulnerability detector, and determined Commotion is not vulnerable.

    +

    Is Commotion susceptible to the Bash Bug/Shell Shock vulnerabilities?

    +

    No, Commotion uses the ash shell that comes with BusyBox and is packaged by default with OpenWRT. We have tested and confirmed that this version of the ash shell is not vulnerable to the bash bug vulnerabilities. +

    Features & Capabilities

    What connection speed will this service provide?

    @@ -95,8 +96,7 @@ lang: en

    The overall capacity is dictated by the number, distribution, and type of devices used and, in the case of Internet access, the amount of bandwidth available to the network. However, the software is efficient at distributing load throughout the network.

    Is it possible for Wi-Fi enabled mobile phones to access this service? If so, will they have any way to block the service?

    -

    A Commotion network is just like any other Wi-Fi network. It is necessary for a Wi-Fi enabled mobile device of any kind to choose to join the network.
    -Users with compatible Android phones may choose to download and install the Commotion client for Android as well.

    +

    A Commotion network is just like any other Wi-Fi network. It is necessary for a Wi-Fi enabled mobile device of any kind to choose to join the network.

    How scalable are Commotion networks?

    Commotion is theoretically scalable to thousands of nodes across an urban area or multiple rural villages. In practice, however, network scalability is highly dependent on the specific situation: network design, physical environment, management strategies and hardware. The larger the network becomes, the more important it will be to minimize radio interference, balance load on individual nodes, manage node density, and decentralize troubleshooting. Most large scale mesh networks use other technologies, such as point-to-point backhaul links, to bridge clusters of mesh nodes to Internet gateways. Engineered solutions such as these help large networks maintain more consistent performance.

    @@ -108,12 +108,7 @@ Users with compatible Android phones may choose to download and install the This depends on the capacity of each device, both in terms of simultaneous wireless connections and total bandwidth consumed by each user.

    I want to run applications on a Commotion mesh network. How do you set up Application X on a Commotion mesh?

    -

    Running network applications on a local mesh network is very similar to running applications on the Internet or any local area network (LAN), and requires at a minimum a local server hosting the app or service. That service can then be advertised between Commotion mesh routers so people connecting to the network can find that application or service. OTI is working on a guides on how to set up an application server for various applications and provide those services on a Commotion mesh network. Preliminary instructions for some applications is available on our developer wiki.

    - -

    Please explain the cell phone component of this project: does it use sim cards, Skype, or another technique?

    -

    OpenGSM integration with Commotion is in development. The network will interconnect via Wi-Fi with Wi-Fi-enabled smartphones, and it is planned to integrate with standard mobile phones when an OpenGSM base station is deployed and connected to a Commotion network.

    - -

    If VOIP services are available on the Internet or hosted locally, users may place calls using Skype, Jitsy, or local VoIP services.

    +

    Running network applications on a local mesh network is very similar to running applications on the Internet or any local area network (LAN), and requires at a minimum a local server hosting the app or service. That service can then be advertised between Commotion mesh routers so people connecting to the network can find that application or service. You can check out our Local Applications Guide or the Local Applications CCK module for more information.

    Development

    @@ -121,13 +116,13 @@ Users with compatible Android phones may choose to download and install the Commotion has been tested and is in use in multiple locations around the world.

    How will the software programming for this project be done?

    -

    The project is structured as a traditional open-source project. We are working to coordinate and integrate many different open-source projects operating in this field.

    +

    The project is structured as a traditional open-source project. We are working to coordinate and integrate many different open-source projects operating in this field. You can find all of the Commotion source code on our Github page.

    How is Commotion development funded?

    Commotion is funded from a variety of sources but as an open source project has an independent life regardless of any particular funding. Commotion has had and will have other funders. The active funding at any particular moment is a consequence of timing, not reflective of how we approach securing support for the work.

    Which operating systems are supported by Commotion?

    -

    The Commotion project is currently targeting reasonably current versions of Windows, Mac, GNU/Linux, Android, embedded routers, and OpenGSM platforms. In addition, any device may connect to a standard access point provided by the network as a client without having to run the software, thereby utilizing the network without being part of it.

    +

    Any WiFi-enabled device, regardless of its operating system, may connect to a standard access point provided by a Commotoin network without having to run the software, thereby utilizing the network without being part of it.

    Officially supported software images for Commotion Router can be found on the Commotion Router Download page. Information about platforms under active development can be found in the For Developers section of this site.

    @@ -139,14 +134,14 @@ Users with compatible Android phones may choose to download and install the OTI does not deploy Commotion. OTI supports the work of communities by providing trainings, tools, and resources. OTI looks to community partners to decide how they want to engage and how they want to use our tools. We follow their lead.

    We have partnered with individuals and groups who work on a wide range of social justice issues. OTI promotes affordable, universal, and ubiquitous communications through partnerships with communities, researchers, industry, and public interest groups, and is committed to maximizing the potentials of innovative open technologies. In the field, OTI works directly with communities by using the tools of project-based learning and participatory design to build and support community controlled tech infrastructure as means of self-governance. Community partners decide how they want to engage and how they want to use our tools. OTI only lists partners and projects that would like to be listed on our website.

    -

    I read about {Community Network X} - how can I do that in my community?

    -

    OTI and partners have developed a set of learning tools - the Commotion Construction Kit - to help other communities in thinking about how to build sustainable community networks. The CCK is freely available on our website and is continually updated along with the Commotion software. To start, we recommend working with other individuals and groups in your community and starting with the Planning section. If there is a specific network or case study that you think is a model for your community, you should definitely join the Commotion discussion email list to connect directly with the groups that have done those implementations.

    +

    I read about {Community Network X}—how can I do that in my community?

    +

    OTI and partners have developed a set of learning tools—the Commotion Construction Kit—to help other communities in thinking about how to build sustainable community networks. The CCK is freely available on our website and is continually updated along with the Commotion software. To start, we recommend working with other individuals and groups in your community and starting with the Planning section. If there is a specific network or case study that you think is a model for your community, you should definitely join the Commotion discussion email list to connect directly with the groups that have done those implementations.

    How much does it cost to build a Commotion network?

    Please refer to the blog post on this subject for more information on the various costs associated with building a Commotion network.

    Can I supply Internet access to my whole community through my home router?

    -

    You can certainly share Internet access using Commotion, although you will not be able to scale to your whole community with just your home Internet connection. A Commotion router will share bandwidth with other meshed devices on a network if it is connected to the Internet (in that case it’s called a “gateway”). For a community network, you will most likely want to have multiple Internet gateways. This can be accomplished using multiple routers on a mesh network to provide multiple gateways and additional bandwidth. See the section "Commotion Node Connected to a Home or Business Router" on the Common Configurations page.

    +

    You can certainly share Internet access using Commotion, although you will not be able to scale to your whole community with just your home Internet connection. A Commotion router will share bandwidth with other meshed devices on a network if it is connected to the Internet (in that case it’s called a “gateway”). For a community network, you will most likely want to have multiple Internet gateways. This can be accomplished using multiple routers on a mesh network to provide multiple gateways and additional bandwidth. See the section "One or more nodes connected to a gateway" on the Common Hardware Setups page.

    How much will it cost to supply Internet access to my whole community?

    It depends. Determining the cost of a community wireless network is complicated as it involves many factors, such as the number of people you need to serve, how much area you want to cover in your community, and options in your community for how to connect your network to the Internet, as well as hardware, installation, and labor costs. For a few examples of these costs, please refer to the blog post How much does it cost? To begin thinking about what you want your community network to look like, we recommend bringing your community together to work through the Every Network Tells a Story module from the Commotion Construction Kit, which will help you in your initial planning exercises.

    @@ -154,13 +149,13 @@ Users with compatible Android phones may choose to download and install the Similar Technologies

    Assuming Commotion is implemented successfully, how can users be tracked? If users are untraceable, won't that make it a good tool for criminals?

    -

    There is no such thing as perfect security and anonymity, but we strive to make the network as secure and anonymous as possible while clearly informing users of all of the strengths, weaknesses, and ramifications of the network. Such a tool is powerful in the hands of whatever individuals and communities use it. Software is not inherently good or evil and can be utilized by people with a variety of intents. Activists under an oppressive regime might be considered criminals by the government that they oppose.

    +

    There is no such thing as perfect security and anonymity, but we strive to make the network as secure as possible while clearly informing users of all of the strengths, weaknesses, and ramifications of the network. Such a tool is powerful in the hands of whatever individuals and communities use it. Software is not inherently good or evil and can be utilized by people with a variety of intents. Activists under an oppressive regime might be considered criminals by the government that they oppose.

    Will this project be accessible only during periods of unrest?

    This technology is permanent. In fact, many of the underlying components are currently in use around the world today as a means of connecting communities.

    What advantage does this method have over satellite Internet?

    -

    Commotion is a suite of tools designed to take advantage of any available satellite Internet service, and that connection may be shared with anyone on the network. If no Internet connection is available, network users may still communicate securely and anonymously with each other. Finally, the network is designed to be self-healing, allowing users to join and leave the network as needed.

    +

    Commotion is a suite of tools designed to use any connected Internet service, including via satellite, and that connection may be shared with anyone on the network. If no Internet connection is available, network users may still communicate securely and anonymously with each other. Finally, the network is designed to be self-healing, allowing users to join and leave the network as needed.

    Press, Research or Collaboration

    I am a journalist and would like to interview someone about Commotion.

    From 8e5286b2bb714f3e109032523d368053ea4f019e Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 10:57:37 -0400 Subject: [PATCH 04/20] updated commotion logo link --- commotionwireless.net/about/press/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commotionwireless.net/about/press/index.md b/commotionwireless.net/about/press/index.md index 5f044072..f7a57adb 100644 --- a/commotionwireless.net/about/press/index.md +++ b/commotionwireless.net/about/press/index.md @@ -30,7 +30,7 @@ Media Relations Associate

    Logos & Images

    Video

    From f4ff475d0f6e08dffe765f7e9ca26e31270871a1 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 10:58:57 -0400 Subject: [PATCH 05/20] update get-started page, added local apps cck link, removed redundant cck links --- commotionwireless.net/docs/get-started/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/commotionwireless.net/docs/get-started/index.md b/commotionwireless.net/docs/get-started/index.md index 8ee196cd..00538410 100644 --- a/commotionwireless.net/docs/get-started/index.md +++ b/commotionwireless.net/docs/get-started/index.md @@ -86,11 +86,10 @@ Community networks are built by a coalition of community anchor institutions, co
  • Installing + Configuring
  • Building + Mounting
  • Networking
    • +
  • Local Applications
  • Commotion Supported Devices
  • Download Commotion Software
    • -
  • Installing Commotion on Wireless Routers
    • -
  • Configuring Commotion on your Router
    • From c35bb7f348853db468aadf86118e3369e05695ee Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 11:51:30 -0400 Subject: [PATCH 06/20] remove links to openbts downloads page --- commotionwireless.net/_includes/downloads_menu.html | 2 +- commotionwireless.net/_includes/menu.html | 2 +- commotionwireless.net/download/index.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/commotionwireless.net/_includes/downloads_menu.html b/commotionwireless.net/_includes/downloads_menu.html index bdbb3d5f..2750e79c 100644 --- a/commotionwireless.net/_includes/downloads_menu.html +++ b/commotionwireless.net/_includes/downloads_menu.html @@ -5,6 +5,6 @@

    Download

  • Routers
  • Phones
  • Computers
    • -
  • Cellular Networks
    • +
  • Verifying Downloads
    • diff --git a/commotionwireless.net/_includes/menu.html b/commotionwireless.net/_includes/menu.html index 79aaef73..7d085609 100644 --- a/commotionwireless.net/_includes/menu.html +++ b/commotionwireless.net/_includes/menu.html @@ -42,7 +42,7 @@
  • Routers
  • Phones
  • Computers
    • -
  • Cellular Networks
    • +
  • Verifying Downloads
    • diff --git a/commotionwireless.net/download/index.md b/commotionwireless.net/download/index.md index 2d1e39dc..51d916d2 100644 --- a/commotionwireless.net/download/index.md +++ b/commotionwireless.net/download/index.md @@ -43,13 +43,13 @@ lang: en

     

    -
    +

     

    From d0b01a936d9ab4ef0b4ad63b64b04a600f0cbff0 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 11:57:08 -0400 Subject: [PATCH 07/20] update broken seal image link --- commotionwireless.net/download/verify-signatures/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commotionwireless.net/download/verify-signatures/index.md b/commotionwireless.net/download/verify-signatures/index.md index 1baaef60..d5d68076 100644 --- a/commotionwireless.net/download/verify-signatures/index.md +++ b/commotionwireless.net/download/verify-signatures/index.md @@ -15,7 +15,7 @@ lang: en

    Some software sites, including Commotion, list md5 hashes alongside the software on their website, so users can verify that they downloaded the file without any errors. These "checksums" help you answer the question "Did I download this file correctly from whoever sent it to me?" They do a good job at making sure you didn't have any random errors in your download, but they don't help you figure out whether you were downloading it from the attacker. The better question to answer is: "Is this file that I just downloaded the file that Commotion intended me to get?"

    Where do I get the signatures and the keys that made them?

    -

    Each file on our download page is accompanied by a signature, which you can download by clicking on the seal icon () next to the image name.

    +

    Each file on our download page is accompanied by a signature, which you can download by clicking on the seal icon () next to the image name.

    The signature file will have the same name as the image file, but with the extension ".asc". These .asc files are GPG signatures. They allow you to verify the file you've downloaded is exactly the one that we intended you to get. For example, openwrt-ar71xx-generic-ubnt-bullet-m-squashfs-factory.bin is accompanied by openwrt-ar71xx-generic-ubnt-bullet-m-squashfs-factory.bin.asc.

    Below are instructions for how to verify these signatures, depending on your operating system.

    From f2a7238932f8bac1bd8c3d7e87dd52f7fbc18665 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:13:15 -0400 Subject: [PATCH 08/20] android download: update broken supported devices link; remove extra whitespace --- commotionwireless.net/download/android/index.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/commotionwireless.net/download/android/index.md b/commotionwireless.net/download/android/index.md index 6b2d7a0c..df002493 100644 --- a/commotionwireless.net/download/android/index.md +++ b/commotionwireless.net/download/android/index.md @@ -23,7 +23,7 @@ lang: en
  • Does not provide strong security against monitoring over the mesh
  • Can be jammed with radio/data-interference
    • -For More Info Click Here
    +For More Info Click Here

    Pre-built downloads for the Commotion android devices we currently support are listed below.

    @@ -32,21 +32,13 @@ lang: en * Your phone must be rooted to run this package. * Commotion Android will connect to Commotion networks up to Commotion Router PR3. However, it is not fully feature compatible with Commotion Router 1.0 or higher. - * See the Commotion Android Supported Hardware page for device-specific information. + * See the Commotion Android Supported Hardware page for device-specific information.

    -

     

    -

    Current Release = (PR3)  Pre-Release 3
    Next Release = v1.0

    -

     

    - -

     

    - -

     

    -

    Stable Builds:

    From 8a835306e12575b2e0d1fb7b423d2563fd65e2f7 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:19:48 -0400 Subject: [PATCH 09/20] fix broken github workflow link --- .../developer/resources/commotion-router/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commotionwireless.net/developer/resources/commotion-router/index.md b/commotionwireless.net/developer/resources/commotion-router/index.md index 0f50d05f..fa299454 100644 --- a/commotionwireless.net/developer/resources/commotion-router/index.md +++ b/commotionwireless.net/developer/resources/commotion-router/index.md @@ -13,7 +13,7 @@ lang: en

    Overview

    Commotion-Router is a highly customized version of the OpenWRT embedded Linux distribution. The main project repository (commotion-router) contains only the scripts and default files needed to download OpenWRT and add Commotion's packages to the OpenWRT build system. Those Commotion packages are defined in the packages directory of the Commotion Feed repo. Source code for individual Commotion-Router packages can be found in the repositories (PKG_SOURCE_URL) and branches (PKG_VERSION) specified in their respective Commotion Feed Makefiles.

    -

    By default, Commotion-Router is configured to build images for Ubiquiti devices using the master branch of each project repo. New development takes place in feature branches, which are merged to master after function testing. See the GitHub Workflow document on the Commotion Wiki for information on branching and submitting patches.

    +

    By default, Commotion-Router is configured to build images for Ubiquiti devices using the master branch of each project repo. New development takes place in feature branches, which are merged to master after function testing. See the GitHub Workflow document on the Commotion Wiki for information on branching and submitting patches.

    Commotion-Router can theoretically be built for any OpenWRT-compatible device with sufficient flash storage to install the 5.4MB Commotion image. However, at present, devices using the ar7xxx/ar9xxx have the best wireless driver compatibility.

    From b3547875604bbe8f4286864fd5affe6fbb407da4 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:27:45 -0400 Subject: [PATCH 10/20] dev resources: fix broken links, update language --- commotionwireless.net/developer/resources/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/commotionwireless.net/developer/resources/index.md b/commotionwireless.net/developer/resources/index.md index 3ebe3232..05cf737e 100644 --- a/commotionwireless.net/developer/resources/index.md +++ b/commotionwireless.net/developer/resources/index.md @@ -12,7 +12,7 @@ If you are interested in helping develop the Commotion Wireless software, or wan

    Platforms

    -

    Commotion runs on multiple software and hardware platforms: Some network routers, smart phones, desktops and laptops, and open source GSM basestations. Software development on each platform moves at a different pace, but we are working towards unifying the code across all of the platforms. Where possible, a common set of tools are used to develop Commotion, no matter the platform. However, there are certain platforms where unique tools are required.

    +

    Commotion runs on multiple software and hardware platforms: Some wireless routers, smart phones, and desktops and laptops. Software development on each platform moves at a different pace, but we are working towards unifying the code across all of the platforms. Where possible, a common set of tools are used to develop Commotion, no matter the platform. However, there are certain platforms where unique tools are required.

    • Commotion-Router development guide
      • @@ -31,11 +31,11 @@ If you are interested in helping develop the Commotion Wireless software, or wan

      Commotion is written in a combination of C, Lua, Javascript, Python, Java, shell, Objective-C, PHP. All of our source code is hosted on Github. To see the relationship between code repositories and the Commotion architecture, read the architecture documents above.

      -

      See the GitHub Workflow page on the Commotion Wiki for information on the Commotion team's GitHub workflow.

      +

      See the GitHub Workflow page on the Commotion Wiki for information on the Commotion team's GitHub workflow.

      Debugging Tools

      -

      Commotion developers rely on a combination of tools, experience, and intuition to debug. We use gdb, ddms and unit testing. Read more about our testing procedures and methodologies and procedures for lab testing on the Developer Wiki.

      +

      Commotion developers rely on a combination of tools, experience, and intuition to debug. We use gdb, ddms and unit testing. Read more about our testing procedures and methodologies and procedures for lab testing on the Developer Wiki.

      -

      Read more about common debugging procedures we use on the Developer Wiki. To report bugs and submit fixes, use our issue tracker.

      +

      Read more about common debugging procedures we use on the Developer Wiki. To report bugs and submit fixes, use our issue tracker.

      From 30939bd6d58f609428419a8cc393f94b25ba858b Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:29:57 -0400 Subject: [PATCH 11/20] update language on dev resources router page --- .../developer/resources/commotion-router/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/commotionwireless.net/developer/resources/commotion-router/index.md b/commotionwireless.net/developer/resources/commotion-router/index.md index fa299454..620dfbc0 100644 --- a/commotionwireless.net/developer/resources/commotion-router/index.md +++ b/commotionwireless.net/developer/resources/commotion-router/index.md @@ -11,11 +11,11 @@ lang: en ---

      Overview

      -

      Commotion-Router is a highly customized version of the OpenWRT embedded Linux distribution. The main project repository (commotion-router) contains only the scripts and default files needed to download OpenWRT and add Commotion's packages to the OpenWRT build system. Those Commotion packages are defined in the packages directory of the Commotion Feed repo. Source code for individual Commotion-Router packages can be found in the repositories (PKG_SOURCE_URL) and branches (PKG_VERSION) specified in their respective Commotion Feed Makefiles.

      +

      Commotion-Router is a highly customized version of the OpenWRT embedded Linux distribution. The main project repository (Commotion-Router) contains only the scripts and default files needed to download OpenWRT and add Commotion's packages to the OpenWRT build system. Those Commotion packages are defined in the packages directory of the Commotion Feed repo. Source code for individual Commotion-Router packages can be found in the repositories (PKG_SOURCE_URL) and branches (PKG_VERSION) specified in their respective Commotion Feed Makefiles.

      By default, Commotion-Router is configured to build images for Ubiquiti devices using the master branch of each project repo. New development takes place in feature branches, which are merged to master after function testing. See the GitHub Workflow document on the Commotion Wiki for information on branching and submitting patches.

      -

      Commotion-Router can theoretically be built for any OpenWRT-compatible device with sufficient flash storage to install the 5.4MB Commotion image. However, at present, devices using the ar7xxx/ar9xxx have the best wireless driver compatibility.

      +

      Commotion-Router can theoretically be built for any OpenWRT-compatible device with sufficient flash storage to install the 5.4MB Commotion image. However, at present, devices using the ar7xxx/ar9xxx chipsets have the best wireless driver compatibility.

      Prerequisites

      See the OpenWRT Easy Build guide for OpenWRT's minimum build prerequisites. You may encounter additional dependencies when building or developing specific Commotion packages.

      From fe2340bcc3340a98b54d374a8a2c969f5328ac10 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:34:16 -0400 Subject: [PATCH 12/20] dev resources mac: fix broken link; update language --- .../developer/resources/commotion-mac/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/commotionwireless.net/developer/resources/commotion-mac/index.md b/commotionwireless.net/developer/resources/commotion-mac/index.md index e5a8a63f..0d690383 100644 --- a/commotionwireless.net/developer/resources/commotion-mac/index.md +++ b/commotionwireless.net/developer/resources/commotion-mac/index.md @@ -12,7 +12,7 @@ lang: en

      Overview

      Commotion is currently in a pure proof-of-concept state for Mac OS X and iOS devices. The Commotion-Meshbook and -Commotion-iOS apps are simply a GUI wrappers for basic OLSRD and is +Commotion-iOS apps are simply GUI wrappers for basic OLSRD and are not compatible with Commotion-Router 1.1.

      Commotion-Meshbook and Commotion-iOS developers should use the @@ -26,4 +26,4 @@ as a guide for porting commotion.

    Build Environment

    -

    See OS X Development Environment

    +

    See OS X Development Environment

    From be6e890223bd22d35809da386a554f27792280fd Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:41:42 -0400 Subject: [PATCH 13/20] update broken links in HIG pages --- commotionwireless.net/developer/hig/introduction/index.md | 4 ++-- commotionwireless.net/developer/hig/key-concepts/index.md | 2 +- commotionwireless.net/developer/hig/style/index.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/commotionwireless.net/developer/hig/introduction/index.md b/commotionwireless.net/developer/hig/introduction/index.md index 7185db85..5abd3a63 100644 --- a/commotionwireless.net/developer/hig/introduction/index.md +++ b/commotionwireless.net/developer/hig/introduction/index.md @@ -11,7 +11,7 @@ lang: en ---

    Introduction

    -

    Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks. It is currently being developed by multiple organizations around the globe, including the Open Technology Institute, The Work Department, The Guardian Project, and The Serval Project.

    +

    Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks. It is currently being developed by multiple organizations around the globe, including the Open Technology Institute, The Work Department, The Guardian Project, and The Serval Project.

    These Human Interface Guidelines are intended to unite developers and designers in creating a consistent and accessible user experience across Commotion tools. People working on Commotion software should adhere to these guidelines and make suggestions for improving them as needed. We want Commotion to be accessible to a broad population of users around the world, and a coordinated design approach can facilitate widespread adoption.

    @@ -36,7 +36,7 @@ lang: en

    Now, consider how this user experience might be different for someone joining an existing network with a mobile phone in order to access a service somewhere on the local network.

    -

    (See Developing a use case for tips on brainstorming user scenarios.)

    +

    (See Developing a use case for tips on brainstorming user scenarios.)

    These different user experiences will, of course, require slightly different interfaces. The neighbor setting up four routers on rooftops will require different tools than a visiting friend who wants to log into the network and access a community file server, but both of these users should experience some shared elements. Both of these users will encounter the Commotion product name, and both will learn a few key terms. In the case of the neighbor who is setting up the network, much of this learning will happen while they read through documentation or use the OpenWRT configuration interface. They will spend quite a bit of time entering settings and becoming familiar with user interface look and feel.

    diff --git a/commotionwireless.net/developer/hig/key-concepts/index.md b/commotionwireless.net/developer/hig/key-concepts/index.md index 09f38e82..e82a458c 100644 --- a/commotionwireless.net/developer/hig/key-concepts/index.md +++ b/commotionwireless.net/developer/hig/key-concepts/index.md @@ -79,7 +79,7 @@ Commotion documentation should clearly discuss any issues of privacy and data re

    In addition to abilities that Commotion can offer at the network level, the documentation should point to privacy and anonymity resources above the mesh network layer. While software can prevent some attacks against privacy and anonymity, the documentation should outline any vulnerabilities associated with traffic analysis and radio monitoring.

    -

    Read more about Commotion Security Architecture.

    +

    Read more about Commotion Security Architecture.

    Common footer

    diff --git a/commotionwireless.net/developer/hig/style/index.md b/commotionwireless.net/developer/hig/style/index.md index a3443995..26e4f8fb 100644 --- a/commotionwireless.net/developer/hig/style/index.md +++ b/commotionwireless.net/developer/hig/style/index.md @@ -23,7 +23,7 @@ lang: en

    Since a mesh network is flexible and can change shape, so can the logo. The main difference between the digital and print version of the mid logo is that the digital version has a slight drop shadow. This helps it to stand out more on a screen. Otherwise they are exactly the same.

    -

    +

     

    From c89978213f60f56d178bf0b569b29e495a65d58c Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:43:01 -0400 Subject: [PATCH 14/20] update broken link to github open issues --- commotionwireless.net/_includes/developers_menu.html | 2 +- commotionwireless.net/_includes/menu.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/commotionwireless.net/_includes/developers_menu.html b/commotionwireless.net/_includes/developers_menu.html index 6c502577..27d6a1e0 100644 --- a/commotionwireless.net/_includes/developers_menu.html +++ b/commotionwireless.net/_includes/developers_menu.html @@ -13,7 +13,7 @@

    For Developers

    {% endif %}
  • Wiki
    • -
  • Issue tracker
    • +
  • Issue tracker
  • Human Interface Guidelines {% if page.sub_section contains 'hig' %} {% include developers_hig_menu.html %} diff --git a/commotionwireless.net/_includes/menu.html b/commotionwireless.net/_includes/menu.html index 7d085609..e4660839 100644 --- a/commotionwireless.net/_includes/menu.html +++ b/commotionwireless.net/_includes/menu.html @@ -70,7 +70,7 @@
  • Source Code
  • API Reference
  • Wiki
    • -
  • Issue Tracker
    • +
  • Issue Tracker
  • Human Interface Guide
  • Requests for Proposals
    • From b94b1b09ab86baa5de23aa8626297d93c1f90709 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 12:47:17 -0400 Subject: [PATCH 15/20] remove more references to GSM work --- .../_includes/developers_resources_menu.html | 2 +- commotionwireless.net/_includes/download-nav.html | 4 ++-- commotionwireless.net/contact/contactthanks.php | 2 +- commotionwireless.net/developer/resources/index.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/commotionwireless.net/_includes/developers_resources_menu.html b/commotionwireless.net/_includes/developers_resources_menu.html index 87dd185a..92f0d9ed 100644 --- a/commotionwireless.net/_includes/developers_resources_menu.html +++ b/commotionwireless.net/_includes/developers_resources_menu.html @@ -4,5 +4,5 @@
  • Linux
  • Windows
  • MacOS/iOS
    • -
  • OpenGSM
    • + diff --git a/commotionwireless.net/_includes/download-nav.html b/commotionwireless.net/_includes/download-nav.html index 4260ee26..21f8e62d 100644 --- a/commotionwireless.net/_includes/download-nav.html +++ b/commotionwireless.net/_includes/download-nav.html @@ -15,8 +15,8 @@ Computers {% endif %} {% if page.url == "/download/openbts/index.html" %} - OpenBTS + {% else %} - OpenBTS + {% endif %} diff --git a/commotionwireless.net/contact/contactthanks.php b/commotionwireless.net/contact/contactthanks.php index 5ee9bb7c..970d8e5c 100644 --- a/commotionwireless.net/contact/contactthanks.php +++ b/commotionwireless.net/contact/contactthanks.php @@ -74,7 +74,7 @@
  • Routers
  • Phones
  • Computers
    • -
  • Cellular Networks
    • +
  • Verifying Downloads
    • diff --git a/commotionwireless.net/developer/resources/index.md b/commotionwireless.net/developer/resources/index.md index 05cf737e..39eee289 100644 --- a/commotionwireless.net/developer/resources/index.md +++ b/commotionwireless.net/developer/resources/index.md @@ -20,7 +20,7 @@ If you are interested in helping develop the Commotion Wireless software, or wan
  • Linux app development guide
  • Windows app development guide
  • Mac OS X and iOS app development guide
    • -
  • Open GSM development guide
    • +

    Architectures

    From 4e56cb0a754cbf48d917963f632a5e334325f679 Mon Sep 17 00:00:00 2001 From: Josh King Date: Tue, 14 Oct 2014 13:38:56 -0400 Subject: [PATCH 16/20] Add v1.1 release notes blog post. --- ...mmotion-router-v1.1-final-release-notes.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 commotionwireless.net/_posts/2014-10-15-commotion-router-v1.1-final-release-notes.md diff --git a/commotionwireless.net/_posts/2014-10-15-commotion-router-v1.1-final-release-notes.md b/commotionwireless.net/_posts/2014-10-15-commotion-router-v1.1-final-release-notes.md new file mode 100644 index 00000000..cf61cafd --- /dev/null +++ b/commotionwireless.net/_posts/2014-10-15-commotion-router-v1.1-final-release-notes.md @@ -0,0 +1,53 @@ +--- +layout: blog +title: Commotion Router v1.1 "Grumpy Cat" Released! +categories: [release] +created: 2014-10-15 +changed: 2014-10-15 +teaser_image: commotion_logo_100x100.png +post_author: Josh King +lang: en +--- +We are very pleased to announce the [v1.1 release for our Commotion Router firmware!](/download/routers) This release finalizes many bugfixes and stability enhancements in our stable v1.x "Grumpy Cat" branch. + +### Changes since v1.1rc2: +* Fixed a memory leak in the Commotion client API. +* Improved handling of bridge interfaces. +* Numerous fixes to input validation in the web interface. +* Upgrade to OLSRd v0.6.6. +* More reliable handling of app announcements. +* Updated user documentation. +* Official support for TP-Link WDR3600, TP-Link WDR4300, and Mikrotik RB411AH + +### Components +Commotion Router v1.1 is built on [OpenWRT Attitude Adjustment trunk](http://openwrt.org), [OLSRd v0.6.6](http://olsr.org), [libserval](http://servalproject.org), and other software. It also includes the Commotion-specific components listed below (with links to their release notes): + +* [commotiond v0.2.4](https://github.com/opentechinstitute/commotiond/releases/tag/0.2.4) +* [commotion-service-manager v0.4.1](https://github.com/opentechinstitute/commotion-service-manager/releases/tag/0.4.1) +* [luci-commotion v1.1.4](https://github.com/opentechinstitute/luci-commotion/releases/tag/1.1.4) +* [luci-i18n-commotion v0.2.3](https://github.com/opentechinstitute/luci-i18n-commotion/releases/tag/0.2.3) +* [olsrd-dnssd v0.5](https://github.com/opentechinstitute/olsrd/releases/tag/commotion-0.5) +* [olsrd-mdp v0.5](https://github.com/opentechinstitute/olsrd/releases/tag/commotion-0.5) + +### Contributors +A huge thank you to the development team, our implementors, and our community that contributed to the v1.1 release series. Just a few of the people to recognize: + +* [Andrew Reynolds](https://github.com/areynold) +* [Andy Gunn](https://github.com/andygunn) +* [Ben West](https://github.com/westbywest) +* [Chris Ritzo](https://github.com/critzo) +* [Dan Staples](https://github.com/dismantl) +* [Georgia Bullen](https://github.com/georgiamoon) +* [Grady Johnson](https://github.com/gradyoti) +* [Griffin Boyce](https://github.com/glamrock) +* [Jordan McCarthy](https://github.com/technosopher) +* [Nat Meysenburg](https://github.com/natmey) +* Ryan Gerety +* [Seamus Tuohy](https://github.com/elationfoundation) +* [Will Hawkins](https://github.com/hawkinswnaf) +* Our [Code for Progress](http://codeforprogress.org) fellows. +* Our [GNOME OPW](https://wiki.gnome.org/OutreachProgramForWomen) interns. +* All of our other contributors, community members, and users of our software. + +This release is backwards-compatible with v1.1rc2, and we encourage all our users to upgrade. You can find images available for download on [our downloads page](/download/routers). For more information about fixes and improvements since v1.0, please see the release notes for [v1.1rc1]({% post_url 2014-04-11-commotion-router-1.1rc1-release-notes %}) and [v1.1rc2]({% post_url 2014-06-13-commotion-router-1.1rc2-release-notes %}). Source code for the project is available via [Github](https://github.com/opentechinstitute). + From bca7b7fe270a58f7592bae335cb77430cac58081 Mon Sep 17 00:00:00 2001 From: Josh King Date: Tue, 14 Oct 2014 14:10:23 -0400 Subject: [PATCH 17/20] Update download page for v1.1 release. --- .../download/routers/index.md | 175 +++++++++++------- 1 file changed, 112 insertions(+), 63 deletions(-) diff --git a/commotionwireless.net/download/routers/index.md b/commotionwireless.net/download/routers/index.md index 0be6a992..a01c02cb 100644 --- a/commotionwireless.net/download/routers/index.md +++ b/commotionwireless.net/download/routers/index.md @@ -34,9 +34,9 @@ lang: en

     

    -

    Version 1.1rc2 Downloads

    +

    Version 1.1 Downloads

    -

    Version 1.1rc2 was released in June 2014.

    +

    Version 1.1 was released in October 2014.

    Manufacturer: Ubiquiti

    @@ -52,81 +52,80 @@ lang: en
    - - - - - + + + + + - - - - + Ubiquiti Picostation M2 and Bullet M2/M5 - Upgrade + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - + + + + - - - - + + + +
    Ubiquiti Picostation M2 and Bullet M2/M5 - Factory Install(sig)b6047973c87f56ec54abd599e4f09d8e06-13-145.2 MBUbiquiti Picostation M2 and Bullet M2/M5 - Factory Install(sig)0a6a078613d1c98a44d9eefa81eea02210-10-145.1 MB
    - Ubiquiti Picostation M2 and Bullet M2/M5 - Upgrade(sig)fa8534feab980b451c18aafbf91a2cf906-13-145.2 MB(sig)d73edd5c9b6606f029a50d5a8cf57edb10-10-145.1 MB
    Ubiquiti Nanostation M2/M5 - Factory Install(sig)b1929478043d881cd80b884570c3db4706-13-145.2 MBUbiquiti Nanostation M2/M5 - Factory Install(sig)b5eff94d6ab9434e340e3e4ed19c695d10-10-145.1 MB
    Ubiquiti Nanostation M2/M5 - Upgrade(sig)9058172429c4d241222ff571bced316306-13-145.2 MBUbiquiti Nanostation M2/M5 - Upgrade(sig)96b8b4f96670fa4449a9ec30fefa0f9010-10-145.1 MB
    Ubiquiti Rocket M2/M5 - Factory Install(sig)dc23ce3de7ff397ac15fb03cf2984c8006-13-145.2 MBUbiquiti Rocket M2/M5 - Factory Install(sig)b1cd3beb898e465915116103969ab41e10-10-145.1 MB
    Ubiquiti Rocket M2/M5 - Upgrade(sig)4ac4603a0f6e78b8dab14e2c1655466906-13-145.2 MBUbiquiti Rocket M2/M5 - Upgrade(sig)f31ebbe137da96976efe0062332699af10-10-145.1 MB
    Ubiquiti Unifi Outdoor - Factory Install(sig)33162024ba71c5411de118d0520af68406-13-145.2 MBUbiquiti Unifi Outdoor - Factory Install(sig)afe2d1e69b5c84820efd5dbed6c4243410-10-145.1 MB
    Ubiquiti Unifi Outdoor - Upgrade(sig)f871fb570c59d4f8a8373dff1b0d760406-13-145.2 MBUbiquiti Unifi Outdoor - Upgrade(sig)5d13188412eb1b4f94bceec0e3b281ec10-10-145.1 MB
    Ubiquiti Unifi - Factory Install(sig)2191c456a04ad37df36dfd2a6880f0b506-13-14Ubiquiti Unifi - Factory Install(sig)3a0fbd689dbaf7f4df84650e27d7dc5710-10-14 5.1 MB
    Ubiquiti Unifi - Upgrade(sig)8f841d5206a635ecc32bf867b936444106-13-14Ubiquiti Unifi - Upgrade(sig)48d8225f2a7b19f18f34dd75f3cca8d110-10-14 5.1 MB
    - - + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    RouterMD5SignatureDateSize
    Mikrotik RB411AH - PXE Boot Image(sig)33a8ba7a24fcf48993387639d712c3ff10-13-146.6 MB
    Mikrotik RB411AH - Kernel Image(sig)374f098948ff5b296092dc6ac7301b0410-13-142.7 MB
    Mikrotik RB411AH - Filesystem Tarball(sig)4b5f3089d5f9c3faedc601ef2d2c054810-13-145.4 MB
    +


    Don't see your device listed? Check the router hardware "in testing" wiki page for a full list of devices being tested with Commotion OpenWRT.

    Other Versions

    @@ -170,6 +218,7 @@ lang: en

    Previous versions:

      +
    • Version 1.1rc2
    • Version 1.1rc1
    • Version 1.0
    • Developer Release 2
      • From b45d6a4b8291861c0c4e9d2ec98ec1abb72a4841 Mon Sep 17 00:00:00 2001 From: Dan Staples Date: Tue, 14 Oct 2014 14:57:39 -0400 Subject: [PATCH 18/20] change tagline to remove/de-emphasize mobile phones and computers --- commotionwireless.net/_config.yml | 2 +- commotionwireless.net/content/about-commotion/index.md | 2 +- commotionwireless.net/developer/hig/introduction/index.md | 2 +- commotionwireless.net/developer/hig/key-concepts/index.md | 2 +- commotionwireless.net/index.md | 4 ++-- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/commotionwireless.net/_config.yml b/commotionwireless.net/_config.yml index e675e1bd..d3cc7e0c 100644 --- a/commotionwireless.net/_config.yml +++ b/commotionwireless.net/_config.yml @@ -1,5 +1,5 @@ name: "Commotion Wireless" -description: "Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks." +description: "Commotion is an open-source communication tool that uses wireless devices to create decentralized mesh networks." encoding: utf-8 url: "commotionwireless.net" diff --git a/commotionwireless.net/content/about-commotion/index.md b/commotionwireless.net/content/about-commotion/index.md index 8c0658b9..529c9287 100644 --- a/commotionwireless.net/content/about-commotion/index.md +++ b/commotionwireless.net/content/about-commotion/index.md @@ -7,6 +7,6 @@ changed: 2013-12-11 post_author: critzo lang: en --- -

      Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks.
      +

      Commotion is an open-source communication tool that uses wireless devices to create decentralized mesh networks.

      diff --git a/commotionwireless.net/developer/hig/introduction/index.md b/commotionwireless.net/developer/hig/introduction/index.md index 5abd3a63..3f232376 100644 --- a/commotionwireless.net/developer/hig/introduction/index.md +++ b/commotionwireless.net/developer/hig/introduction/index.md @@ -11,7 +11,7 @@ lang: en ---

      Introduction

      -

      Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks. It is currently being developed by multiple organizations around the globe, including the Open Technology Institute, The Work Department, The Guardian Project, and The Serval Project.

      +

      Commotion is an open-source communication tool that uses wireless devices to create decentralized mesh networks. It is currently being developed by multiple organizations around the globe, including the Open Technology Institute, The Work Department, The Guardian Project, and The Serval Project.

      These Human Interface Guidelines are intended to unite developers and designers in creating a consistent and accessible user experience across Commotion tools. People working on Commotion software should adhere to these guidelines and make suggestions for improving them as needed. We want Commotion to be accessible to a broad population of users around the world, and a coordinated design approach can facilitate widespread adoption.

      diff --git a/commotionwireless.net/developer/hig/key-concepts/index.md b/commotionwireless.net/developer/hig/key-concepts/index.md index e82a458c..0179ce3d 100644 --- a/commotionwireless.net/developer/hig/key-concepts/index.md +++ b/commotionwireless.net/developer/hig/key-concepts/index.md @@ -15,7 +15,7 @@ lang: en
      • This language should be used when including a short description of the project:
        - Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks. More at www.commotionwireless.net.
        + Commotion is an open-source communication tool that uses wireless devices to create decentralized mesh networks. More at www.commotionwireless.net.
         
      • This language should be added when you have more space or on “about” pages:
        The project is collaboratively developed by The Open Technology Initiative, The Work Department, The Guardian Project, The Serval Project, and volunteers within the community.
        • diff --git a/commotionwireless.net/index.md b/commotionwireless.net/index.md index 857039c3..11e150e4 100644 --- a/commotionwireless.net/index.md +++ b/commotionwireless.net/index.md @@ -8,7 +8,7 @@ lang: en
        • Commotion 1.1rc2 Bugfix Release
          Get the most current version of Commotion Router, 1.1rc2, available for download.
          • -
        • Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks.
          • +
        • Commotion is an open-source communication tool that uses wireless devices to create decentralized mesh networks.
        • Interested in trying Commotion or learning more? Our Get Started guide will explain how.
        • Are you interested in contributing to Commotion?
          Get Involved!
        • Have Questions about Commotion? Our Frequently Asked Questions covers many of them.
          • @@ -16,7 +16,7 @@ lang: en From a6f56e94dc1ad232d029ee64eed6a2c02d768029 Mon Sep 17 00:00:00 2001 From: Josh King Date: Wed, 15 Oct 2014 13:48:47 -0400 Subject: [PATCH 19/20] Update scrolling header to reference v1.1. --- commotionwireless.net/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/commotionwireless.net/index.md b/commotionwireless.net/index.md index 857039c3..4a8f9f86 100644 --- a/commotionwireless.net/index.md +++ b/commotionwireless.net/index.md @@ -6,10 +6,10 @@ lang: en