diff --git a/commotionwireless.net/_config.yml b/commotionwireless.net/_config.yml index bc34d899..744a3a78 100644 --- a/commotionwireless.net/_config.yml +++ b/commotionwireless.net/_config.yml @@ -9,6 +9,8 @@ piwik: base_url: piwik.opentechinstitute.org site_id: 1 +markdown: kramdown + permalink: /blog/:year/:month/:day/:title category_dir: /blog/category pagination: 3 diff --git a/commotionwireless.net/_posts/2012-05-08-neighborhood-network-builders-summary.md b/commotionwireless.net/_posts/2012-05-08-neighborhood-network-builders-summary.md index 72895488..87fd0828 100644 --- a/commotionwireless.net/_posts/2012-05-08-neighborhood-network-builders-summary.md +++ b/commotionwireless.net/_posts/2012-05-08-neighborhood-network-builders-summary.md @@ -7,8 +7,26 @@ changed: 2013-07-26 post_author: The Work Department lang: en --- - As part of our research for the Commotion Human Interface Guidelines, we interviewed four people who have been involved in building community wireless networks around Detroit (see earlier blog posts for excerpts). Based on these interviews and our experience working with various users, we recommend that Commotion developers and organizers implement the following concepts: -**Building successful software** +As part of our research for the Commotion Human Interface Guidelines, we interviewed four people who have been involved in building community wireless networks around Detroit (see earlier blog posts). Based on these interviews and our experience working with various users, we recommend that Commotion developers and organizers implement the following concepts: + +## Building successful software Our interviews confirmed that users expect long-term reliability, speed, and ease of use when using wireless devices. The Commotion user interface should: -
  1. Walk a user through the setup process.
  2. Work well across platforms, browsers, and devices.
  3. Be as fast as using a non-mesh WiFi access point.
  4. Help users understand mesh network security.
  5. Allow for easy monitoring of network status in terms that users can understand.
  6. Offer troubleshooting suggestions when a network does not work correctly.
**Building a successful neighborhood network** -
  1. Start with dedicated individuals and neighborhood institutions (community centers, housing complexes, churches, and schools).
  2. Offer clear and accessible guidance or training for how to create a network without deep technical expertise.
  3. Give neighbors the tools to teach others about why a network is useful and how to use it.
  4. Engage young people as managers and/or promoters of a network.
  5. Offer simple but useful applications for neighbors to use in the early stages of a network. These should be applications that concretely improve their lives or communication with one another. Introduce more advanced applications only once a community has some experience and comfort using simple applications.
+ +
    +
  1. Walk a user through the setup process.
  2. +
  3. Work well across platforms, browsers, and devices.
  4. +
  5. Be as fast as using a non-mesh WiFi access point.
  6. +
  7. Help users understand mesh network security.
  8. +
  9. Allow for easy monitoring of network status in terms that users can understand.
  10. +
  11. Offer troubleshooting suggestions when a network does not work correctly.
  12. +
+ +## Building a successful neighborhood network + +
    +
  1. Start with dedicated individuals and neighborhood institutions (community centers, housing complexes, churches, and schools).
  2. +
  3. Offer clear and accessible guidance or training for how to create a network without deep technical expertise.
  4. +
  5. Give neighbors the tools to teach others about why a network is useful and how to use it.
  6. +
  7. Engage young people as managers and/or promoters of a network.
  8. +
  9. Offer simple but useful applications for neighbors to use in the early stages of a network. These should be applications that concretely improve their lives or communication with one another. Introduce more advanced applications only once a community has some experience and comfort using simple applications.
  10. +
diff --git a/commotionwireless.net/about/faq/index.md b/commotionwireless.net/about/faq/index.md index 2df5ea8e..78b0442c 100644 --- a/commotionwireless.net/about/faq/index.md +++ b/commotionwireless.net/about/faq/index.md @@ -8,23 +8,33 @@ changed: 2014-04-14 post_author: Chris Ritzo 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.

-

How does commotion provide internet access?

-

Commotion does not provide Internet access. Commotion helps by sharing one or multiple internet connection(s) across any device on the mesh network.

+

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

How does Commotion work?

Commotion is software that is installed on existing feature phones, 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.

+

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/

+

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).

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.

+

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.

+

How can I hear about the latest Commotion developments?

In addition to the project website, there are three Commotion mailing lists designed for varying levels of interest:

@@ -38,17 +48,24 @@ lang: en

Access & Installation

-

What equipment is necessary to use this technology?

+

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.

+

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.

+ +

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 (https://wiki.commotionwireless.net/doku.php?id=development_resources:router:hardware_compatibility_list). 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.

+

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.

Is there a charge or cost to use Commotion?

No. The software will always be available free of charge, and our documentation is available under a Creative Commons, Share-Alike license. Communities or individuals using Commotion assume the cost of purchasing routers and other hardware used in building their networks. There may also be a cost for a connection to the public Internet from a local provider. The size, scope and operation of a Commotion network is largely up to the community that deploys it.

-

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 buy a Commotion Construction Kit?

No. The Commotion Construction Kit is a set of documentation that can be downloaded from this website. It is not a kit of hardware, but a planning and implementation tool intended for communities interested in organizing and building community wireless networks.

@@ -58,10 +75,6 @@ lang: en

Is Commotion only usable in urban areas? What about rural or remote communities?

Commotion is in use in a variety of communities, both urban and rural, and in all types of terrain. Note that in remote areas additional network planning and cost may be necessary to address the challenges of building infrastructure in remote regions, such as limited access to power sources, rough terrain, or large distances in between wireless links.

-

Do you have suggestions for hardware to purchase? What vendors do you use for purchasing hardware?

-

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. We maintain a list of potentially compatible routers on our developer wiki.

-

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.

-

Security

Is Commotion Secure?

@@ -70,6 +83,9 @@ lang: en

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.

+

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.

+

Features & Capabilities

What connection speed will this service provide?

@@ -82,13 +98,19 @@ lang: en

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.

+

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.

+

Using this kind of service how large an area can be covered?

This type of service can scale quite well. However, sufficiently large networks do require care and planning for smooth operation. A mesh network’s scalability varies greatly depending on the hardware used, the design of the network, and the network’s physical environment. Though they do not use Commotion software, two examples of large scale mesh networks are the Athens Wireless Metropolitan Network (AWMN) with over 1100 backbone nodes and over 2400 client computers and Spain’s Guifi.net, which has over 19,000 nodes.

How many users can use a single node?

This depends on the capacity of each device, both in terms of simultaneous wireless connections and total bandwidth consumed by each user.

-

Please explain about the telephone service of this project: does it use sim cards, Skype, or another technique?

+

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?

The network will interconnect via Wi-Fi with Wi-Fi-enabled smartphones, and via GSM with standard mobile phones. If VOIP services are available on the internet or locally, users may place calls using Skype, Jitsy, or local VoIP services. Otherwise, users may place calls to other phones on the Commotion network if there is a nearby Commotion enabled GSM device.

Development

@@ -107,6 +129,25 @@ Users with compatible Android phones may choose to download and install the 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.

+

I would like to contribute translations of the Commotion interface and documentation. How can I get involved?

+

You can find out more about getting involved in translation of Commotion on our Commotion Localization page.

+ +

Building Networks

+

Does OTI build networks?

+

No. OTI creates resources and tools for communities to design, build and govern their own communications tools and infrastructure, and conducts hands-on trainings with people and communities building their own networks.

+ +

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 (http://commotionwireless.net/docs/cck) 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.

+ +

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.

+

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?

@@ -117,4 +158,21 @@ Users with compatible Android phones may choose to download and install the 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.

- + +

Press, Research or Collaboration

+

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

+

Thank you for your interest in learning more about Commotion. Please feel free to reach out to Jenny Lu Mallamo, New America’s Media Relations Associate,at mallamo@newamerica.org or (202) 596-3368. Jenny can help direct you to the right information and experts, and can help coordinate interviews

+ +

I am a researcher, community group, non-profit, civic entity, etc. interested in collaborating with OTI/Commotion.

+

Thanks for reaching out! Before getting started, we recommend that you explore our resources on the Commotion Website. If you are thinking about starting a network, the Commotion Construction Kit is designed to help you through the planning, building, installation, and networking basics needed for starting a wireless network using Commotion.

+
+ +

Can you tell me about/connect me with communities doing mesh networks?

+

Yes. Nearly all Commotion users are on the Commotion discussion list and we have compiled a set of case studies on specific projects.

+ +
diff --git a/commotionwireless.net/css/commotion.css b/commotionwireless.net/css/commotion.css index 0e738e12..44e711c2 100644 --- a/commotionwireless.net/css/commotion.css +++ b/commotionwireless.net/css/commotion.css @@ -775,4 +775,9 @@ table.infotable td.highlight { background-color: #E6E6E6; text-align: left; } - +.faq-content h3 { + margin-left: .5em; +} +.faq-content p { + margin-left: 3em; +}