Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 2 additions & 5 deletions docs/en/device-configuration/configure-edgerouter-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ router through; `eth4` is the WAN port, and the one that passes PoE back out to
<img src="../../assets/images/device-configs/erx/wiring.jpeg"
alt="ERX wiring - the power cable is plugged into the back, and the 'eth0' interface is plugged into the computer."
style="width: 50%;">
<figcaption></figcaption>
</figure>
<figure style="display: flex; align-items: center; flex-direction: column;">
<img src="../../assets/images/device-configs/erx/eth0.jpeg"
Expand All @@ -66,13 +65,12 @@ Follow the instructions here: [Setting a static IP for your computer](configure-
<img src="../../assets/images/device-configs/erx/wizard.jpeg"
alt="ERX configuration prompt"
style="width: 50%;">
<figcaption></figcaption>
</figure>

4. Change the `Port` from `eth0` to `eth4.` This configures the port to serve as the WAN for the Litebeam antenna.
5. Under `User Setup` create a new user and set the PCW username and password.
6. Press `Apply` and follow the instructions to reboot the device.
7. Return to the portal and log in with the PCW username and password (contact project maintainers for this info).
7. Return to the portal and log in with the PCW username and password (PCW staff will give you these).
8. At the `Dashboard,` click on `Actions` for `eth4` to turn on PoE.
9. Finally, Click on the `System` tab at the bottom left of the console.
10. Input the host name for the device.
Expand Down Expand Up @@ -125,7 +123,6 @@ This method allows the ERX to connect to the Internet through your home router.
<img src="../../assets/images/device-configs/erx/wizard.jpeg"
alt="ERX configuration prompt"
style="width: 50%;">
<figcaption></figcaption>
</figure>

4. Change the `Port` from `eth0` to `eth4.`
Expand All @@ -136,7 +133,7 @@ This method allows the ERX to connect to the Internet through your home router.

7. Reboot your router and reboot the ERX.

8. Return to the portal and log in with the PCW username and password (contact project maintainers for this info).
8. Return to the portal and log in with the PCW username and password (PCW staff will give you these).

9. Finally, Click on the `System` tab at the bottom left of the console.

Expand Down
2 changes: 1 addition & 1 deletion docs/en/device-configuration/troubleshoot-devices.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Each Unifi AP has an LED which indicates its current status.
* **Flashing Blue** - The AP has lost connectivity and is searching for a parent AP or uplink.
* **Rapid Flashing Blue/Off** - The 'Locate' feature was activated via the Unifi Controller.

Please see [this page](https://help.ui.com/hc/en-us/articles/204910134-Understanding-Device-LED-Status-Indicators) for more information on LED status indicators.
Ubiquiti's [Understanding Device LED Status Indicators](https://help.ui.com/hc/en-us/articles/204910134-Understanding-Device-LED-Status-Indicators) explains what each LED pattern means.

## Troubleshooting Access Points
### No power on access point; device power cycles but doesn't stay online
Expand Down
2 changes: 1 addition & 1 deletion docs/en/installations/green-tech/green-technology.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Programs, funding, and monitoring resources related to PCW's green-space work. F

!!! warning ""

Check the program page before pointing anyone at the rebate. As of August 2026 the City lists it as unfunded, with applications processed in order received only if funding is restored.
As of August 2026 the City lists this program as unfunded, with applications processed in order received only if funding is restored. Check the program page for its current status.

## Urban agriculture

Expand Down
121 changes: 34 additions & 87 deletions docs/en/installations/green-tech/solar-iot-devices.md

Large diffs are not rendered by default.

4 changes: 0 additions & 4 deletions docs/en/installations/handbook/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,6 @@ Involve each other. Even a first-time volunteer can participate in a meaningful

Debrief after installs or maintenance work to reflect on work done, areas of improvement, and any lessons learned.

<!-- subheading names above are Claude placeholders for Alex/Leanne to rename -->

## Install Policy

As a member of PCW’s staff or volunteer team, you represent our organization and the important work that we do: expanding internet access and adoption, and advocating for greater digital inclusion. Being respectful, proactive, and professional while interacting with community members is a positive contribution that can go a long way toward making a great lasting impact and supporting the work of PCW.
Expand Down Expand Up @@ -74,12 +72,10 @@ Clean up any mess made. If items were moved within the space, be sure to put the

Be sure to check-out with the host. If they are not present, send them a text or email to say thank you. On most occasions, install participants should unpack as a group back at HQ, ensuring the tool bags are in good condition and restocked for the next install.


### Outreach

Outreach items should be brought to every install. After the install work is complete:

- Stickers should be added to deployed devices. These include our “Do Not Touch – Community Internet” stickers and 3” or 4” circular PCW stickers, depending on device size.
- If there are people on the streets, let them know that there is free Wi-Fi there now. Give them a general PCW Information postcard if they’re interested.

<!-- image held: third-party Occam's razor cartoon and "looping" cycle diagram; needs a PCW-owned or licensed replacement -->
6 changes: 1 addition & 5 deletions docs/en/installations/handbook/risks-rooftop-ladder-drill.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,22 +12,18 @@ When pulling items up to the roof via rope, keep weight below ~25lbs per bag. Pe

Avoid dropping items off the roof. If mounting equipment to the side of a building, work in pairs, with one spotter holding the physical equipment while the other uses a fastening tool.

Learn more about best practices for roof safety in [this article](https://www.buildings.com/industry-news/article/10187943/best-practices-for-roof-safety) and [OSHA document](https://www.osha.gov/sites/default/files/publications/OSHA3755.pdf).
Learn more about best practices for roof safety in Buildings.com's [best practices for roof safety](https://www.buildings.com/industry-news/article/10187943/best-practices-for-roof-safety) and this [OSHA document](https://www.osha.gov/sites/default/files/publications/OSHA3755.pdf).

## Ladders

PCW uses ladders at most of our installs and maintenance visits. We have three kinds of ladders: step, telescoping, and folding extension.

Telescoping and unfolded extension ladders should be positioned at a 4-to-1 ratio, meaning the feet of the ladder should be 25% of total ladder height from the wall.

<!-- image held: third-party ladder infographic (4 to 1 rule); images to be sorted out later -->

Ladder climbers should wear shoes with grip on the bottom. Only one person on a ladder at one time. A person must be off and away from the ladder, unless they are holding it in place for safety, before the next person uses it.

The safest way to climb a ladder is using three points-of-contact at all times. Do not make sudden or quick movements. Movements should be made one foot or one hand at a time. The climber’s body should always face square with the ladder. Do not turn away from the ladder while on it.

<!-- image held: third-party ladder infographic (three points of contact); images to be sorted out later -->

Ladders should not be in front of doors that can open towards the ladder. If this is necessary at any point, the door must be propped open or guarded by a member of PCW.

Learn more about best practices for [ladder safety here](https://www.americanladderinstitute.org/page/BasicLadderSafety).
Expand Down
4 changes: 0 additions & 4 deletions docs/en/installations/handbook/safety-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ Volunteers are responsible for staying focused and on task while on site. Volunt

Poor or extreme weather has a direct impact on the safety of PCW’s work. Installs and maintenance work will be postponed if there is a high likelihood of poor weather, including extreme heat, rain, snow, ice, extreme cold, bad air quality, or fog.

<!-- image held: third-party CCOHS "Keep your cool" heat infographic; needs a PCW-owned or licensed replacement -->

During hot weather, stay hydrated with water and/or electrolytes, protect skin with sunscreen, and take breaks indoors or in the shade. Recognize the signs of heat exposure, such as dizziness, nausea, headache, confusion, and rapid shallow breathing.

During cold weather, protect skin with appropriate outerwear and take breaks indoors to warm up. Tread carefully to avoid slips and falls on any ice; stay away from icy patches when possible. Recognize the signs of cold stress, such as uncontrolled shivering, slurred speech, clumsy movements, fatigue, and confused behavior.
Expand Down Expand Up @@ -46,8 +44,6 @@ In addition, PCW Staff are responsible for packing:

Most of the equipment that PCW uses is lightweight, and bags should be packed in a way that none of them are particularly heavy. However, we do use large ladders and, at certain installs, cinderblocks for weighing down our non-penetrating roofmount. Here are some guidelines around carrying heavy equipment to minimize the risk of injury.

<!-- image held: third-party CCOHS "How to Lift Safely" poster and "power zone" diagram; needs a PCW-owned or licensed replacement -->

Before lifting or carrying a heavy or awkward object individually, consider: would this be less risky as a two-person job? Are there other ways to lift, carry, or move this object? (e.g., using a rope, a car, or a ramp). Before lifting, also identify available handholds. Some loads may not have adequate handholds; gloves and/or carrying objects as a team may reduce the risk of injury.

Long-duration or high frequency (repetitive) lifting can cause strain or injury, even if the load is light. Working in teams, rotating tasks, and taking regular breaks can help reduce the risk of injury. Cold temperatures can reduce muscle flexibility, whereas hot temperatures can lead to dehydration, fatigue, and increased metabolic load, and low visibility or poor lighting can increase the chance of trips or falls. Be especially careful to take breaks and rotate carrying tasks in more extreme weather conditions.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@

PCW often works in environments that have pre-existing Internet infrastructure. When doing our installations, we may be in proximity to existing cabling/networking infrastructure/etc that could be impacted or damaged by the work of our install.

<!-- Residential notes: still a placeholder in the Drive guide as of 2026-09-24; add when written. -->

### Commercial

In commercial buildings that already have Internet installed, you might see something like this:
Expand All @@ -22,7 +20,7 @@ Pictured above is a coaxial tap and splitter(s) – this is like a switch, but f

As a guiding principle, we never drill into parts of roofs that we can stand on.

The most important aspect of our roof work is to not allow moisture ingress, which can accumulate and damage a building from the inside-out without being visible until a leak or other damage appears. Learning about roof anatomy can help us understand the best way to mount our equipment without implicating the integrity of the roof. Learn more about the parts of a roof edge (flashing, drip edge, fascia, soffit) in [this guide](https://roofs.wiki/Roof_Anatomy_and_Parts_Explained).
The most important aspect of our roof work is to not allow moisture ingress, which can accumulate and damage a building from the inside-out without being visible until a leak or other damage appears. Learning about roof anatomy can help us understand the best way to mount our equipment without implicating the integrity of the roof. Learn more about the parts of a roof edge (flashing, drip edge, fascia, soffit) in [Roof Anatomy and Parts Explained](https://roofs.wiki/Roof_Anatomy_and_Parts_Explained).

## Fire Safety/Suppression Systems

Expand Down Expand Up @@ -50,14 +48,10 @@ Although PCW primarily works with low-voltage (50V or less) cable and devices, w

Romex - indoor power is often carried via this flat, non-metallic (NM) cable. Romex is color-coded based on the gauge and the amperage. Learn more about the color code in [this NEMA bulletin](https://www.nema.org/docs/default-source/technical-document-library/type-nm-b-cable-jacket-color-coding-for-conductor-size-idenification.pdf).

<!-- image held: third-party NM cable colour chart (The Spruce) and outlet-types photo; images to be sorted out later -->

### Conduit and You

Outdoors, electrical cable is usually encased in a conduit of some sort. We often see flexible conduit made of PVC, or straight conduit made of steel.

<!-- image held: third-party conduit-types photo grid; images to be sorted out later -->

### Avoiding Radio Frequency Interference Between Electrical Wires

Avoid running telecom and electrical cables through the same penetrations (have at least 2 inches of separation). If telecom and electrical cables must cross, cross them perpendicular to each other to minimize interference (only contact point is where they cross vs running in parallel). Ethernet is in twisted pairs to help deal with interference as well. Using shielded cable (FTP) helps reduce interference even more.
Expand Down
5 changes: 0 additions & 5 deletions docs/en/installations/hardware.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,11 +117,6 @@ Also used indoors: [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6
- [airMAX NanoBeam M5](https://store.ui.com/us/en/products/nbe-m5-16)
- [airMAX NanoStation M5 loco](https://store.ui.com/us/en/category/wireless-airmax-5ghz/products/locom5)

<!-- Ideas to note, 2026-09-27, from the retired Drive doc "Installation Overview - Public Docs". Unverified; staff to confirm before use.
4. Equipment per install type, as that doc listed it: hub = 1 EdgeRouter X, 1 UAP-AC-Mesh, 1 J-arm and mounting hardware (it also listed a clamshell for an outdoor ER-X, dropped: the ERX stays indoors); mesh node = 1 UAP-AC-Mesh, 1 J-arm and mounting hardware; mesh node + indoor AP = "Same as Mesh node, plus:" (the list was never finished). Check: which APs now (U6 Mesh, U6 LR, U7 Outdoor, AC-M-Pro are listed above); add an outdoor switch when a hub has more than one AP? The hub list is missing the LiteBeam, the PoE injector and the cable.
6. Cable: that doc said the LiteBeam "is powered via passive PoE through a single Cat 5 cable". Check what is run now (Cat 5e / Cat 6, outdoor-rated).
-->

### Mounts

- [Universal J-Arm Mount](https://store.ui.com/collections/operator-airmax-and-ltu-accessories/products/universal-antenna-mount)
Expand Down
7 changes: 0 additions & 7 deletions docs/en/installations/install-planning.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,13 +72,6 @@ wireless link back to a hub, which is what the rest of this page is about.

See also NYC Mesh's [typical installs](https://wiki.nycmesh.net/books/2-install-maintenance-guides/page/typical-installs) page for how a similar network describes its install types.

<!-- Ideas to note, 2026-09-27, from the retired Drive doc "Installation Overview - Public Docs" (its "Extra Notes on PCW install types"). Unverified; staff to confirm or rewrite before any of it goes visible.
1. Mesh node uses (doc's words): "Used for 1) relaying a signal to another mesh AP, and/or 2) providing a WiFi access point to a public, outdoor space. May provide a signal inside the building it is installed on, depending on placement and building construction."
2. A third type, mesh node + indoor AP (doc's words): "Same as a Mesh node, plus an additional access point installed inside the building to provide a home with stronger and more consistent signal indoors. The indoor AP may be another bunny ears, or any other home router." "PCW mounts a single Unifi Mesh AP with LOS to another Mesh AP, and runs an Ethernet cable into the home for a home router to be connected." Check: still offered? "any other home router" right?
3. Hubs (doc's words): "An indoor AP may also be installed if stronger and more consistent signal is required inside the house." "sometimes we use a 60ghz alternative" to the LiteBeam. Check: is 60 GHz still used?
5. PTMP installs are not described anywhere yet (Leanne, July 2026: "i'd add the newer PTMP to this too"). Needs a sentence or two from staff.
-->

### Considerations when installing a mesh node

Ubiquiti's [Considerations for Optimal Wireless Mesh Networks](https://help.ui.com/hc/en-us/articles/115002262328-Considerations-for-Optimal-Wireless-Mesh-Networks)
Expand Down
7 changes: 2 additions & 5 deletions docs/es/device-configuration/configure-edgerouter-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,6 @@ configura el router; `eth4` es el puerto WAN y el que envía PoE hacia una LiteB
<img src="../../../assets/images/device-configs/erx/wiring.jpeg"
alt="Cableado del ERX: el cable de alimentación está conectado en la parte trasera y la interfaz 'eth0' está conectada a la computadora."
style="width: 50%;">
<figcaption></figcaption>
</figure>
<figure style="display: flex; align-items: center; flex-direction: column;">
<img src="../../../assets/images/device-configs/erx/eth0.jpeg"
Expand All @@ -70,13 +69,12 @@ Siga estas instrucciones: [Configurar una IP estática en su computadora](config
<img src="../../../assets/images/device-configs/erx/wizard.jpeg"
alt="Pantalla de configuración del ERX"
style="width: 50%;">
<figcaption></figcaption>
</figure>

4. Cambie el `Port` (puerto) de `eth0` a `eth4`. Así el puerto funcionará como WAN para la antena LiteBeam.
5. En `User Setup` (configuración de usuario), cree un usuario nuevo y establezca el nombre de usuario y la contraseña de PCW.
6. Presione `Apply` (aplicar) y siga las instrucciones para reiniciar el dispositivo.
7. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (comuníquese con los responsables del proyecto para obtener estos datos).
7. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (el personal de PCW se los proporcionará).
8. En el `Dashboard` (panel), haga clic en `Actions` (acciones) de `eth4` para activar PoE.
9. Por último, haga clic en la pestaña `System` (sistema), en la parte inferior izquierda de la consola.
10. Escriba el nombre de host (*host name*) del dispositivo.
Expand Down Expand Up @@ -129,7 +127,6 @@ Este método permite que el ERX se conecte a Internet a través del router de su
<img src="../../../assets/images/device-configs/erx/wizard.jpeg"
alt="Pantalla de configuración del ERX"
style="width: 50%;">
<figcaption></figcaption>
</figure>

4. Cambie el `Port` (puerto) de `eth0` a `eth4`.
Expand All @@ -140,7 +137,7 @@ Este método permite que el ERX se conecte a Internet a través del router de su

7. Reinicie su router y reinicie el ERX.

8. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (comuníquese con los responsables del proyecto para obtener estos datos).
8. Vuelva al portal e inicie sesión con el nombre de usuario y la contraseña de PCW (el personal de PCW se los proporcionará).

9. Por último, haga clic en la pestaña `System` (sistema), en la parte inferior izquierda de la consola.

Expand Down
2 changes: 1 addition & 1 deletion docs/es/device-configuration/troubleshoot-devices.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Cada AP Unifi tiene un LED que indica su estado actual.
* **Azul intermitente** - El AP perdió la conectividad y está buscando un AP principal (*parent AP*) o un enlace ascendente (uplink).
* **Azul/apagado intermitente rápido** - Se activó la función 'Locate' (localizar) desde el controlador Unifi (Unifi Controller).

Consulte [esta página](https://help.ui.com/hc/en-us/articles/204910134-Understanding-Device-LED-Status-Indicators) (en inglés) para obtener más información sobre los indicadores LED de estado.
La guía de Ubiquiti [Understanding Device LED Status Indicators](https://help.ui.com/hc/en-us/articles/204910134-Understanding-Device-LED-Status-Indicators) (en inglés) explica qué significa cada patrón de los LED.

## Solución de problemas de puntos de acceso
### El punto de acceso no enciende; el dispositivo se reinicia pero no permanece en línea
Expand Down
2 changes: 0 additions & 2 deletions docs/es/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@ Si está buscando una **descripción no técnica del proyecto** o está interesa

Si tiene más preguntas, no dude en escribirnos a info@phillycommunitywireless.org.

<!-- TODO: Spanish review of the short italic descriptor lines below — for a fluent speaker at PR review. -->

## Por dónde empezar

### Para anfitriones de antena
Expand Down
Loading
Loading