diff --git a/docs/assets/images/equipment/nanoswitch-ports.svg b/docs/assets/images/equipment/nanoswitch-ports.svg new file mode 100644 index 0000000..618f167 --- /dev/null +++ b/docs/assets/images/equipment/nanoswitch-ports.svg @@ -0,0 +1,1251 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/assets/images/equipment/nanoswitch.svg b/docs/assets/images/equipment/nanoswitch.svg new file mode 100644 index 0000000..2bafd39 --- /dev/null +++ b/docs/assets/images/equipment/nanoswitch.svg @@ -0,0 +1,12 @@ + + nanoswitch + + + + + + + \ No newline at end of file diff --git a/docs/assets/images/installations/handbook/coax-tap-and-splitter-box.jpg b/docs/assets/images/installations/handbook/coax-tap-and-splitter-box.jpg new file mode 100644 index 0000000..5363950 Binary files /dev/null and b/docs/assets/images/installations/handbook/coax-tap-and-splitter-box.jpg differ diff --git a/docs/assets/images/installations/handbook/drill-speed-torque-controls.jpg b/docs/assets/images/installations/handbook/drill-speed-torque-controls.jpg new file mode 100644 index 0000000..9b79481 Binary files /dev/null and b/docs/assets/images/installations/handbook/drill-speed-torque-controls.jpg differ diff --git a/docs/assets/images/installations/handbook/fiber-enclosure-and-line-amplifier.jpg b/docs/assets/images/installations/handbook/fiber-enclosure-and-line-amplifier.jpg new file mode 100644 index 0000000..2442e0d Binary files /dev/null and b/docs/assets/images/installations/handbook/fiber-enclosure-and-line-amplifier.jpg differ diff --git a/docs/assets/images/installations/handbook/firestop-on-conduit.jpg b/docs/assets/images/installations/handbook/firestop-on-conduit.jpg new file mode 100644 index 0000000..d0c8d64 Binary files /dev/null and b/docs/assets/images/installations/handbook/firestop-on-conduit.jpg differ diff --git a/docs/en/device-configuration/troubleshoot-devices.md b/docs/en/device-configuration/troubleshoot-devices.md index 131edcc..5e3850d 100644 --- a/docs/en/device-configuration/troubleshoot-devices.md +++ b/docs/en/device-configuration/troubleshoot-devices.md @@ -4,6 +4,18 @@ title: Troubleshoot Unifi Devices Not every device will work perfectly. Additionally, devices deployed outdoors will be exposed to the elements, primarily heat and moisture, and degrade naturally over time. With that said, outdoor access points have often lasted 5 years or longer. In Philadelphia, we rarely encounter inclement weather that damages our radios. +## Maintenance and Troubleshooting + +Here are some considerations for maintenance and troubleshooting work: + +* Start with identifying the problem. What evidence can we use to understand why equipment may not be functioning properly? + * Check the power source. + * Check to ensure all equipment is properly plugged in. + * Check for water damage. + * Check the settings in the Controller. +* Always try the easiest solution first. +* Don’t be afraid to schedule a follow-up visit if a problem cannot be solved day-of. + ## Unifi AP LED Status Indicators Each Unifi AP has an LED which indicates its current status. @@ -51,7 +63,7 @@ Please see [this page](https://help.ui.com/hc/en-us/articles/204910134-Understan **Observations**: No lights, device is offline/missing from UISP. **Potential Causes and Fixes**: -* **Flawed power connection/Ethernet cable if PoE** - Test the ERX with a different 9v power supply and check if the ERX comes online. Try switching to a different 9v power supply. If using PoE, ensure the voltage is correct. +* **Flawed power connection/Ethernet cable if PoE** - Test the ERX with a different 12V power supply and check if the ERX comes online. Try switching to a different 12V power supply. If using PoE, ensure the voltage is correct. ## Useful Terminal Commands for Networking * `ipconfig` (Windows)/`ifconfig` (Unix) - display network interfaces and related information - IP address, subnet mask, and default gateway. diff --git a/docs/en/glossary.md b/docs/en/glossary.md index 94652d2..09e6ef8 100644 --- a/docs/en/glossary.md +++ b/docs/en/glossary.md @@ -39,7 +39,7 @@ hover any dotted-underlined term on a page to see its definition without leaving : The brand of WiFi equipment that PCW uses; a family of wireless access points, switches, routers, controller devices, VoIP phones, and access control products. [Unifi product line](https://techspecs.ui.com/unifi) **EdgeRouter-X (ERX)** -: The router PCW uses as a switch; a switch moves data between devices. [EdgeRouter X product page](https://store.ui.com/us/en/pro/category/wired-edge-max-routing/products/er-x) +: The router PCW uses. [EdgeRouter X product page](https://store.ui.com/us/en/pro/category/wired-edge-max-routing/products/er-x) **Power over Ethernet (PoE)** : Passing electric power along with data on Ethernet cabling, so an outdoor device can be powered from an indoor outlet. [PoE injector product page](https://store.ui.com/us/en/pro/products/poe-24) diff --git a/docs/en/index.md b/docs/en/index.md index 8e796df..4892d25 100644 --- a/docs/en/index.md +++ b/docs/en/index.md @@ -5,7 +5,7 @@ title: Home # Welcome to the Philly Community Wireless Docs! -**Philly Community Wireless** (PCW) is building community-controlled wireless internet networks in Philadelphia. We aim to provide a baseline of internet access for everyone, enhancing quality of life today and positioning communities for a more healthy and prosperous tomorrow. With the help of [**PhillyWisper**](https://phillywisper.net/), a pro-net neutrality, wireless internet service provider, we are actively installing internet throughout **Kensington** and **Fairhill**, in public and private areas of North Philadelphia. You can see our network's geographic scope on our [webmap](https://phillycommunitywireless.org/networkmap). +**Philly Community Wireless** (PCW) is building community-controlled wireless internet networks in Philadelphia. We aim to provide a baseline of internet access for everyone, enhancing quality of life today and positioning communities for a more healthy and prosperous tomorrow. With the help of [**PhillyWisper**](https://phillywisper.net/), a pro-net neutrality, wireless internet service provider, we are actively installing internet throughout **Norris Square**, **Fairhill**, and **Kensington**, in public and private areas of North Philadelphia. You can see our network's geographic scope on our [webmap](https://phillycommunitywireless.org/networkmap). Our community wireless mesh network allows us to share Internet connections among a broader group of users with very little cost for the infrastructure. This docs page provides technical information and guides for individuals or organizations looking to contribute to or replicate elsewhere the organization's configuration and installation of routers and antennas for building a large-scale public wireless mesh network. @@ -27,9 +27,13 @@ If you have additional questions, please don't hesitate to reach out at info@phi **Installations** -- [Building Assessments](installations/buildingassessment.md) -- [Access Point Placement](installations/ap-placement.md) +- [Guiding Principles](installations/handbook/overview.md) +- [Safety Basics](installations/handbook/safety-basics.md) +- [Rooftop, Ladder & Drill Safety](installations/handbook/risks-rooftop-ladder-drill.md) +- [Building & Electrical Safety](installations/handbook/safety-buildings-electrical.md) +- [Install Planning](installations/install-planning.md) - [Hardware](installations/hardware.md) +- [Cabling and Mounting](installations/cabling-and-mounting.md) **Networking and device configuration** diff --git a/docs/en/installations/ap-placement.md b/docs/en/installations/ap-placement.md deleted file mode 100644 index 46e822e..0000000 --- a/docs/en/installations/ap-placement.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Access Point Placement ---- - -# Access Point Placement - -Where an access point goes matters as much as which access point it is. This page covers how PCW -decides where to put APs — the difference between a hub and a node, and what to consider when a -node meshes wirelessly rather than being wired in. - -## Hubs and nodes - -Mesh nodes are installations where we do not use a Litebeam, but instead set up a wireless access -point that meshes from a nearby access point wired to a router and Litebeam at a local hub. - -Whether a site can be a hub is decided during the [building assessment](buildingassessment.md) — -a hub needs line-of-sight to a PhillyWisper high site. A node does not, but it does need a good -wireless link back to a hub, which is what the rest of this page is about. - -## 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) -is the reference we work from. The points that come up most often on PCW installs: - -* **Mesh networks should be supplemental** - Although mesh networks can operate comparably to a hard-wired network, connection quality and speed can be greatly affected by radiofrequency (RF) noise and obstructions between APs such as walls, trees, or other structures. -* **Mesh 'hops' should be minimized** - A meshed AP should only have one 'parent' - each mesh 'hop', or mesh connection between APs, results in a significant performance decrease. Ideally, there should be a maximum of two 'hops' - e.g, a mesh AP meshes with another mesh AP, which then meshes to a hard-wired AP. -* **Limit concurrent connections to a 'parent'** - Similarly, meshing too many APs to the same 'parent' creates additional RF noise and performance demands on the parent, resulting in decreased performance and stability. -* **Ensure strong signal strength between meshed APs** - Ideally, a meshed AP will have clear line-of-sight (LoS) to its mesh parent. A signal strength of -60 dBm is recommended for ideal performance. Ensure minimal obstructions between the meshed AP and the parent, such as walls, trees, furniture, etc. - -## Outdoor placement - -Outdoor APs should be mounted where they are radio-visible to the mesh APs at the home installs in -range, and high enough to clear whatever is around them. On [solar nodes](solar.md), that usually -means the AP sits at the top of the mast with the panel and enclosure mounted below it. - -For how to configure an AP once it is placed, see the -[Configure Unifi APs](../device-configuration/configure-ap-mesh.md) guide. diff --git a/docs/en/installations/buildingassessment.md b/docs/en/installations/buildingassessment.md deleted file mode 100644 index db7d793..0000000 --- a/docs/en/installations/buildingassessment.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Building Assessments ---- - -PCW regularly installs WiFi at a wide range of building types, such as rowhomes, multi-dwelling units (MDUs), community centers, and public spaces such as parks and gardens. - -To assess a building for installation, we have to ask the following questions: - -* **Does the building have line-of-sight (LoS) to a PhillyWisper high site or close proximity to a current PCW mesh node?** - * Without direct LoS to a high site or existing node, the uplink radio's performance will be significantly degraded (if it can connect at all). - * Google Earth can be a useful tool for determining potential LoS, but in many cases a site visit may be necessary. - * Foliage from trees can cause significant interference - sites that are viable in the winter may be blocked by foliage in the summer! - * New construction also pops up suddenly. It is important to verify the conditions of the location in person, as Google maps etc may not have the latest surroundings up to date. - -* **Does the building have easy, safe, and simple roof/top floor access?** - * Are ladders required? Are there stairs/a roof access hatch? - * LiteBeams are ideally installed on the roof, either via pre-existing roof structure, j-arm mount on the wall, or non-penetrating roof mount. - * Do we have permission to mount on the building or on structures on the roof? - * PCW only installs on flat roofs, with rare exceptions. - -* **Is there access to power?** - * If outdoors, is the power source protected? - * Will the power source need to be used by something else? Is it accessible to others who could unplug our equipment? - * Are there pre-existing penetrations we can reuse to run power-over-Ethernet from indoors? - * PCW does NOT drill through roofs as they are too difficult to waterproof. - -* **Are there easy ways to mount access points?** - * eg: existing poles we could simply ziptie APs to VS bringing a non-penetrating roof mount or j-arm. - * How much cable will we have to run? - * What sort of access points will be necessary? Some are not weatherproof and can only be used indoors. - * Is there a chance mounting access points could damage the roof or walls? - * Is there pre-existing Internet infrastructure (previous coaxial or fiber installations) we need to be mindful of? Cables running in parallel can interfere with each other, degrading performance for both connections - -* **If maintenance is required, will we be able to return in the future?** - -As an example, this is an ideal install site: - -
- An ideal roof install location -
An ideal roof install location in Kensington
-
- -* The roof is clear of debris and is flat, with plenty of space for non-penetrating roof mounts. -* The building is taller than almost every other building in the area, giving it free LoS to both PhillyWisper high sites and other potential PtP/PtMP sites. -* There is power on the roof, in this case covered GFCIs. diff --git a/docs/en/installations/cabling-and-mounting.md b/docs/en/installations/cabling-and-mounting.md new file mode 100644 index 0000000..30f4c2f --- /dev/null +++ b/docs/en/installations/cabling-and-mounting.md @@ -0,0 +1,41 @@ +# Cabling and Mounting + +Follow the order of operations: don’t pin cables until it’s fully run and tested; don’t secure mounts until cables have been run. + +## Run Ethernet cable end-to-end + +- Run cable along the intended route, measuring out the length needed. +- If the cable run passes between inside and outside, determine where. + - Look for pre-existing holes that we can use to avoid drilling where possible. + - Look for previous cable runs to potentially drill next to, keeping the cabling around the building consistent. + - If drilling is necessary, see [When drilling inside](handbook/risks-rooftop-ladder-drill.md#when-drilling-inside). +- While running cable, temporarily secure the cable to existing objects to help guide the cable where necessary. +- Snip cable once length has been determined, leaving additional slack on both ends. + +## Crimp and Test Ethernet + +- PCW crimps Ethernet cable according to the T568B crimping pattern, which is the most commonly used. See [NYC Mesh’s Book section on Ethernet](https://wiki.nycmesh.net/books/3-hardware-firmware/page/ethernet-cable) for more. +- When finished ordering the cable’s wires, push them through pass-thru RJ45s with the window side facing you. Ensure the RJ45 is pulled over the cable’s rubber sheath as much as possible. +- Test Ethernet using the Klein Tools tester and make sure the cable passes. + - Note: The top row visible on the tester screen shows the Ethernet end that is plugged into the main tester end. The bottom row shows the Ethernet end plugged into the remote end (the piece that separates). + +## Test devices + +- Plug devices into crimped cable. Ensure that they are receiving the correct amount of power via PoE. +- Test to make sure the device is receiving data and Wi-Fi is working. + - White and/or blue lights are usually a good sign. + - Phones can be used to ensure that a device is broadcasting Wi-Fi. + - Devices will come up in PCW’s UniFi controller and should say “Adopted.” + +## Mount access points and pin cable + +- Install the access point mount, if using a J-arm or a mounting plate. + - We never drill into a roof for mounting. If using a non-penetrating roof mount, this mount should be built before or while running Ethernet cable. +- Add access points to their mounts. + - We always aim to leave extra slack for the Ethernet cable. This slack should be coiled neatly and attached to the mount (or nearby) using zip ties or electrical tape. + - In some cases, cables should be positioned to create a “drip loop” right before the Ethernet enters a device. [Learn more about drip loops here](https://support.huawei.com/enterprise/en/doc/EDOC1100278610/f5d86b9c/guide-to-making-drip-loops). +- Secure the Ethernet cable as best as possible to avoid damage (via wind, etc.) over time. Here are some best practices about cable clipping: + - Clip cables as inconspicuously as possible. Indoors, that often means running cables next to baseboards, door frames, or where walls meet ceilings. + - Use screw clips in outdoor scenarios. Clip every 1-2 feet. + - For brick, concrete, and other harder materials, pre-drill using Tapcon drillbits and then add Tapcons (blue screws) to the black plastic clips, removing the existing screws. + - For indoor installs, using “plastic staples” (ie. nails with plastic cable holders) is preferable, due to its ease and creation of smaller holes. Use black pins with black cable, and white pins with white cable. diff --git a/docs/en/installations/handbook/assessment-planning.md b/docs/en/installations/handbook/assessment-planning.md deleted file mode 100644 index 0a4674d..0000000 --- a/docs/en/installations/handbook/assessment-planning.md +++ /dev/null @@ -1 +0,0 @@ -# Assessment & Planning diff --git a/docs/en/installations/handbook/etiquette.md b/docs/en/installations/handbook/etiquette.md deleted file mode 100644 index 9e1b6fb..0000000 --- a/docs/en/installations/handbook/etiquette.md +++ /dev/null @@ -1 +0,0 @@ -# Etiquette On Site diff --git a/docs/en/installations/handbook/install-day-and-maintenance.md b/docs/en/installations/handbook/install-day-and-maintenance.md deleted file mode 100644 index 7a689a5..0000000 --- a/docs/en/installations/handbook/install-day-and-maintenance.md +++ /dev/null @@ -1 +0,0 @@ -# Install Day & Maintenance diff --git a/docs/en/installations/handbook/overview.md b/docs/en/installations/handbook/overview.md index 07dd0c5..3b8765c 100644 --- a/docs/en/installations/handbook/overview.md +++ b/docs/en/installations/handbook/overview.md @@ -1 +1,85 @@ -# Overview +# Guiding Principles + +PCW’s goal is to perform successful, good work in the safest and most efficient way possible, while facilitating learning for our community. Here are some guiding principles to help achieve this goal. + +## Keep it simple + +Occam’s razor: keep things simple. Don’t do anything unsafe that isn’t necessary. Try to do the easiest version of each task. Reduce variables that introduce new or challenging factors where possible. Each install already involves a wide range of variables: the physical space, the people involved, the equipment and tools being used, the environment, and more. In consideration of how much needs to be managed during an install, do not introduce multiple new or experimental things at once. Make changes iteratively. + +Each install should have a minimum viable product (MVP), identified during the prep phase. Sometimes this means just getting a PhillyWisper LiteBeam online. Sometimes this means installing just one access point (AP). + +Pause to think. At any decision point, stop and ask (yourself and/or your fellow installers), “What is the purpose of doing this? Is there a better way to do this that I’m not immediately seeing?” + +Always consider what we can do to minimize and avoid risks, both individually and collectively. + +Slowing down can help maintain control and awareness on site. Don’t make fast movements (e.g. running, jumping) and don’t rush through tasks. + +## Stay focused + +Focus on the install. Don’t get stuck in people or events external to the work being done. + +Situational awareness is a critical component of staying safe. Maintain awareness of what’s happening around you as much as possible. Distractions can increase the possibility of injury. + +## Communicate + +Prioritize teamwork and staying on the same page. Make eye contact when speaking to one another. Use the “looping” technique to ensure understanding — listen to someone, and then restate what you heard back to ensure that you both understand. Do not change plans without communicating those changes to the team. If splitting up, use phones to communicate. + +Communication is a crucial part of safety. It is imperative that everyone involved in an install or maintenance activity listens, asks questions, speaks up if they think something could be changed or if they are uncomfortable, and checks in before moving to another location. + +Notify the site supervisor before leaving the worksite. + +Don’t be afraid to tell someone not to do something if you think they should pause or stop. + +## Look after each other + +PCW staff are the leaders, supervising all participants. They will give direction and feedback. + +Check-in repeatedly with how people are doing. Scan environments and use situational awareness to identify potential pain points to check in about: the weather, the working conditions, heights, insects, etc. Have snacks and water accessible. + +## Learn as we go + +Involve each other. Even a first-time volunteer can participate in a meaningful way by learning to crimp, plugging in a device, etc. Invite everyone to have a role in the work. + +Debrief after installs or maintenance work to reflect on work done, areas of improvement, and any lessons learned. + + + +## 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. + +See also: [Code of Conduct](https://phillycommunitywireless.org/code-of-conduct/) + +### Before an Install or Maintenance Visit + +Arrive at HQ at the designated time (usually 1 hour prior to the scheduled on-site start time). If you are running late, you must communicate your new estimated arrival time with PCW staff via Slack. Volunteers who are more than 15 minutes late may not be able to participate. + +At HQ, before packing the car(s), review the install plan and have a safety check-in. Review any potential risks associated with the day’s work. Establishing an understanding of everyone’s comfort level with ladders, heights, drills, and other elements of on-site work. All install participants must help pack and load equipment. Please don't bring your own tools to an install. If we're missing a tool, feel free to let us know. + +### During Install or Maintenance Visit + +Our installation or maintenance work is done in community spaces. All install participants must be friendly, polite, and mindful while entering someone else’s space. If doing primarily indoor work, check in with the host if we should take off our shoes while inside a host’s home, especially during winter. + +All members of the Staff Install Team should verbally introduce themselves to the host. Staff can introduce volunteers, or volunteers can introduce themselves. PCW staff should explain some basic information about the install or maintenance plan to the site host, communicate an estimated timeline, and then ask if the host has any questions before getting started. + +Watch your language and noise level. Do not touch anything in the host’s space, big or small, without asking. It is usually evident if a host prefers to be asked every time, or gives a general blanket instruction (e.g. “I would prefer if you don’t touch anything” or “No need to ask again!”). Maintain a tidy workspace; clean up garbage as you go. + +Prioritize “Work Mode” over everything else. All participants should be responsive to direction and feedback. Avoid personal phone use where possible. Each member of the install team should have a charged phone and stay in touch with PCW staff members via Slack or Signal. + +PCW's policies and workflows may differ from your past experiences. We welcome feedback, but please understand any changes to our install protocols will require further discussion. + +### Install or Maintenance Wrap-Up + +Clean up any mess made. If items were moved within the space, be sure to put them back in their place. Be mindful while packing up not to leave any tools, equipment, or other items behind. Take photos of the work done that day. Remember that these photos may be shared to our public communications channels, so try to take photos that are visually pleasing. + +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. + + diff --git a/docs/en/installations/handbook/phases-overview.md b/docs/en/installations/handbook/phases-overview.md deleted file mode 100644 index 80109f5..0000000 --- a/docs/en/installations/handbook/phases-overview.md +++ /dev/null @@ -1 +0,0 @@ -# Install Phases Overview diff --git a/docs/en/installations/handbook/risks-rooftop-ladder-drill.md b/docs/en/installations/handbook/risks-rooftop-ladder-drill.md index 41f96f6..7c17ac2 100644 --- a/docs/en/installations/handbook/risks-rooftop-ladder-drill.md +++ b/docs/en/installations/handbook/risks-rooftop-ladder-drill.md @@ -1 +1,92 @@ # Rooftop, Ladder & Drill Safety + +## Rooftops + +Our install and maintenance work often involves going onto rooftops of buildings. Regardless of the roof access, size, material, roof “edges,” or other factors, PCW uses the following rules and guidelines to ensure safety while on rooftops. + +Stay away from the edge of the roof as much as possible. Do not lean over the roof to look down or inspect the area for tasks like cable clipping unless absolutely necessary. If you are nearing a roof edge for work purposes, lower your center of gravity the closer you get. Work on your knees, while sitting, or if right by the edge, lay flat on your stomach. + +Never move quickly on a roof. Do not run. + +When pulling items up to the roof via rope, keep weight below ~25lbs per bag. People on the roof pulling up a bag must be sitting or lying down when doing so. + +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). + +## 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. + + + +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. + + + +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). + +## Drills + +Drills are the only power tool that PCW uses on installs. Power tools can inherently be more risky than other types of tools, and should be taken seriously at all times. + +Maintain situational awareness. Distractions while drilling or being around a powered drill are one of the easiest ways to lead to injury. + +After adding a drillbit, test the drillbit’s position before using it to create a penetration. Move the drill into “forward” and point it down towards the ground, away from others, to see that the bit is turning properly, and it’s not wobbly or “spiraling.” Drills should always be kept in “neutral” when not in use. + +Always check and double check what’s on the other side of where you’re drilling. Make sure to use the appropriate drill bit for the material. See more information in the [Recommendations for Drilling into Buildings](#recommendations-for-drilling-into-buildings) section. + +Keep drills to low speed and power when possible. Start low and speed up until at necessary speeds and torque. Remove sawdust/debris from the penetration regularly. During or after usage, give the drill time to cool down before touching a drill bit. + +When using the drill on a ladder, climb the ladder first and then have the drill handed to you by someone on the ground (when possible from them to reach you/when your position on the ladder is reachable by someone on the ground). + +To learn more about how to safely use a drill, [watch this YouTube video](https://www.youtube.com/watch?v=GGZ9zJkFOCg). + +### Recommendations for Drilling into Buildings + +Drilling penetrations into buildings, either for running cables from indoors to outside or mounting enclosures and J-arms, are most likely where we have the largest chance of potentially damaging a building. Only drill when needed, always look for pre-existing penetrations and cable runs. + +#### Start with a minimum amount of force + +Start slow and gradually increase speed/torque if you aren’t making progress. You can add more force either through the drill or by using extra pressure from behind the drill with your hand/core/body. + +How do you adjust speed and torque on the drill? You’ll see numbers and switches like so on our Milwaukee cordless drills: + +![A Milwaukee cordless drill with the rear speed switch and the numbered clutch dial outlined in red.](../../../assets/images/installations/handbook/drill-speed-torque-controls.jpg) + +These two controls control speed and torque: + +- Speed (rear switch) - how fast the drill turns. 1 is low speed/high torque; 2 is high speed/low torque. +- Torque (dial, technically called the “clutch”) - how much force is applied. Also controls the limit of torque before the drill stops. + +#### Consider the material you are drilling through + +For small holes and soft wood, drill fast instead of slow to prevent chewing through them. For hard and other soft materials like plastic/ceramic/tiles, drill slowly to prevent friction, heat, and/or vibration that destroy the material. Going slow usually makes it easier to make the penetration look pretty/even on the edges. + +#### Only drill as long as your screw or bolt + +Making the penetration longer than the actual length of the screw/bolt leaves empty space for water and moisture. You can fill a hole with sealant and then insert/drill the screw, which will fill the gaps in the screw with sealant. Seal under the head of the screw to prevent moisture ingress from the top of the penetration as well. + +#### Choose the right drill bit + +Wood bits have a sharp, point center tip (brad point) for precise positioning, along with outer spurs designed to sever wood fibers for clean, splinter-free holes. Sometimes also called a “spade bit” since it resembles a spade. + +Masonry bits have a wide, durable tungsten carbide tip that often resembles an arrowhead. When drilling into concrete, you’ll most likely need to pre-drill a hole. Use the proper masonry bit (usually the Tapcon drill bit corresponding to the masonry screw you’re using). Use the hammer drill setting when pre-drilling. Consider the size/width of the drill bit – make sure it matches or is slightly under the width of the screw. + +#### When drilling inside + +Drill near window and door frames to stay away from HVAC, electrical wires, and any sort of plumbing. It also allows for the shortest distance when drilling through to the other side. + +If it is not ideal or feasible to drill near window and door frames, here are some considerations: + +- Look for other penetrations or cable runs to follow a similar pathway. +- Check what’s on both sides of the area to ensure clearance, and to look for potential opportunities to cause damage. +- Be considerate of placement for ease of use for PCW, to avoid putting us in risky positions. +- Don’t drill immediately next to an existing power outlet or electrical cable. +- Drilling through the floor should only be considered if we know what’s inside the floor, or we can clearly see where cables and other items have been run. Measure distances where and when possible to ensure floor drilling is matching expectations between floors. diff --git a/docs/en/installations/handbook/risks-weather-environment.md b/docs/en/installations/handbook/risks-weather-environment.md deleted file mode 100644 index 067d3e9..0000000 --- a/docs/en/installations/handbook/risks-weather-environment.md +++ /dev/null @@ -1 +0,0 @@ -# Weather & Environmental Risks diff --git a/docs/en/installations/handbook/safety-basics.md b/docs/en/installations/handbook/safety-basics.md index 9b9ad9e..cf4f6c3 100644 --- a/docs/en/installations/handbook/safety-basics.md +++ b/docs/en/installations/handbook/safety-basics.md @@ -1 +1,67 @@ # Safety Basics + +As an organization supported by volunteers, we work with people who have differing levels of comfort and experience. PCW staff are committed to doing all they can to ensure a safe environment for everyone during installs and maintenance work. + +PCW staff are responsible for preparing for the install or maintenance, considering risk factors of the install site, and the environment; communicating among staff about potential risks before an install visit, and reiterating these risks with participants on the day of work; maintaining supervisory leadership during an install or maintenance visit, and having policies in place to manage potential challenges; and teaching lessons integrated into training on site (eg. “Let’s use the drill on a low speed here because…” or “Who’s going to hold the ladder while others are climbing?”). + +Volunteers are responsible for staying focused and on task while on site. Volunteers are also responsible for communicating about needs, concerns, and questions. If a volunteer needs to take a break, take a call, leave, or otherwise go off on their own at any point during an install or maintenance visit, this must be communicated to PCW staff. + +## Weather + +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. + + + +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. + +During windy conditions, stay even further away from roof edges and maintain space between bodies. Keep lightweight equipment inside a bag so it does not blow away; do not chase items while on a roof or into a street. Consider canceling the install or maintenance work if wind is creating unsafe conditions. + +If it begins to rain, leave rooftop/outdoors work immediately, and cancel the install or maintenance work if necessary. + +## Environmental + +PCW installs and maintenance work is done in community spaces within our service area, including private homes and organization headquarters. Remaining mindful and smart about environmental safety considerations can help us reduce risks when working in different neighborhoods and locations. + +Always ensure to look both ways before crossing a street, even on a one-way street. Our work has us climbing stairs and entering spaces that are sometimes disorganized. Be conscientious of where you step to avoid tripping on the stairs or over loose objects. + +Move in a team or pairs. PCW staff and volunteers should not be on the streets alone. Immediately leave any situation that is uncomfortable or inappropriate. There’s no reason to give out your personal information, even to PCW community members, other than your first name. + +## Pre-Install or Maintenance Checklist + +All participants are responsible for bringing: + +- Appropriate clothing/layers for the weather +- Closed-toe shoes with grip + +In addition, PCW Staff are responsible for packing: + +- First aid kit +- Other PPE: gloves, eye protection, and masks +- Snacks and water +- Sunscreen + +## Carrying Equipment + +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. + + + +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. + +Use the “power zone” for lifting: close to the body, between mid-thigh and mid-chest height. This zone is where arms and back can lift the most with the least amount of effort. Where possible, avoid placing items low or on the ground. Lifting items from a location that is close to the height of your core is less risky than from a low angle. + +Before lifting or carrying an item, evaluate how to keep your spine in a neutral position (i.e., without twisting or reaching) for the duration of the lift. Keep the load symmetrical (hold with both hands, or, for a backpack, with straps on both shoulders) and close to your body. Be mindful of items that can fall out of a bag while lifting it. Zip up bags before lifting where possible. + +## Injury Protocol + +Follow “Check, Call, Care” protocol: + +1. Check and assess the scene. Look for hazards before approaching an injured individual. Ask the individual “are you okay?” and assess the level of injury. +1. Call emergency services (911) for life-threatening conditions. Call any emergency contact for the person(s) injured. Call PCW’s Executive Director to report the incident (see the emergency cards in the tool bag for contact information). +1. Care for the individual(s). PCW has a first aid kit in our tool bag. Keep an injured person still and comfortable; do not move them unless they are in immediate danger. + +Once a scene is safe, document the incident however possible. Write notes about what happened with as many facts as possible – where, when, what happened (if known), what was said or done, who was involved. Take photos where appropriate. diff --git a/docs/en/installations/handbook/safety-buildings-electrical.md b/docs/en/installations/handbook/safety-buildings-electrical.md index d46799c..0870456 100644 --- a/docs/en/installations/handbook/safety-buildings-electrical.md +++ b/docs/en/installations/handbook/safety-buildings-electrical.md @@ -1 +1,65 @@ # Building & Electrical Safety + +## Notes on Pre-Installed Internet Infrastructure + +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. + + + +### Commercial + +In commercial buildings that already have Internet installed, you might see something like this: + +![A fiber-optic splice enclosure mounted on a wall above a grey line amplifier, with coaxial cables running out of it.](../../../assets/images/installations/handbook/fiber-enclosure-and-line-amplifier.jpg) + +Pictured above is a fiber-optic enclosure, used with a hybrid fiber-coax system. The black box on the top contains fiber from the fiber provider, and the line amplifier converts fiber-optic signals (beams of light) to electrical radio frequency signals to be carried over coaxial cable downstream. It will probably be connected to something like this: + +![An open metal utility box holding a coaxial tap and splitters, with labelled coaxial cables leading out to subscribers.](../../../assets/images/installations/handbook/coax-tap-and-splitter-box.jpg) + +Pictured above is a coaxial tap and splitter(s) – this is like a switch, but for coax. It gets its uplink internet connection through the large coaxial cables on the bottom, and then the devices that each labelled coaxial cable is plugged into goes to each individual subscriber. + +## Roofs and Roofing + +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). + +## Fire Safety/Suppression Systems + +Working in telecommunications or mechanical closets, we often are in close proximity to fire alarms and suppression systems. Generally, if a cable/conduit is colored red, it’s likely to be related to a fire suppression system or fire alarm, although this is not a hard and fast rule. + +### Fireblocking Foam (AKA “Fireblock” or “Firestop”) + +Fireblocking foam is often installed on/in conduit to assist with preventing fire spreading between floors of a building. The foam expands and hardens when exposed to high heat, creating a seal. In order to be compliant, the foam/firestop must be a complete seal around the penetration. + +Generally, installed on conduits like so: firestop on the top, then insulation or mineral wool to also act as a backing/filler, while the firestop prevents the actual spread of smoke and fire. + +![Orange firestop foam sealing the top of a metal conduit, with yellow insulation visible inside.](../../../assets/images/installations/handbook/firestop-on-conduit.jpg) + +In this image, the firestop is the orange foam on the top of the conduit; see the yellow insulation visible below inside the actual conduit. + +### Fire Doors + +We never drill through or immediately next to fire doors as this violates their fireblocking integrity. + +## Electrical + +Although PCW primarily works with low-voltage (50V or less) cable and devices, we are often in environments where we are in close proximity to higher voltages/amperages. + +### Common Electrical Cable Types + +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). + + + +### 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. + + + +### 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. + +See also: [Applicable codes | Department of Licenses and Inspections | City of Philadelphia](https://www.phila.gov/departments/department-of-licenses-and-inspections/resources/applicable-codes/) diff --git a/docs/en/installations/hardware.md b/docs/en/installations/hardware.md index b91aa68..9a7a8c1 100644 --- a/docs/en/installations/hardware.md +++ b/docs/en/installations/hardware.md @@ -47,12 +47,12 @@ mounted at the site.
Line drawing of a round ceiling-mounted access point, seen face on as a plain disc with a narrow inner ring. -
Round, ceiling or wall
nanoHD, U6 Lite, U6+, U6 Pro, U7 Lite, U7 Pro
+
Round, ceiling or wall
nanoHD, U6 Lite, U6+, U6 Pro, U7 Lite, U7 Pro
Line drawing of an in-wall access point, a small rectangular faceplate with an Ethernet port on its lower edge. -
In-wall faceplate
UAP-AC-IW, U7 In-Wall
+
In-wall faceplate
UAP-AC-IW, U7 In-Wall
-- [Ubiquiti UAP-nanoHD](https://store.ui.com/us/en/products/uap-nanohd) -- [Ubiquiti UAP-AC-Inwall](https://store.ui.com/us/en/products/uap-ac-iw) -- [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6-extender) -- [Ubiquiti U6+](https://store.ui.com/us/en/products/u6-plus) -- [Ubiquiti U6 Lite](https://store.ui.com/us/en/products/u6-lite) -- [Ubiquiti U6 Pro - 'UFO AP'](https://store.ui.com/us/en/category/wifi-flagship/products/u6-pro) -- [Ubiquiti U7 Lite](https://store.ui.com/us/en/products/u7-lite) -- [Ubiquiti U7 Pro](https://store.ui.com/us/en/products/u7-pro) -- [Ubiquiti U7 Pro Max](https://store.ui.com/us/en/products/u7-pro-max) -- [Ubiquiti U7 In-Wall](https://store.ui.com/us/en/products/u7-iw) -- [Ubiquiti U7 Long Range](https://store.ui.com/us/en/products/u7-lr) -- [Ubiquiti UAP-BeaconHD](https://store.ui.com/us/en/products/uap-beaconhd) +Also used indoors: [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6-extender), [Ubiquiti U7 Pro Max](https://store.ui.com/us/en/products/u7-pro-max), [Ubiquiti U7 Long Range](https://store.ui.com/us/en/products/u7-lr). ### Switches - [Ubiquiti USW Flex Mini](https://store.ui.com/us/en/products/usw-flex-mini) - [Ubiquiti USW Flex](https://store.ui.com/us/en/category/switching-utility/products/usw-flex) +- [Ubiquiti NanoSwitch](https://store.ui.com/us/en/products/n-sw) - an outdoor four-port switch; three of its ports supply 24V passive PoE. Used occasionally.
USW Flex Mini ports. Port 1 accepts PoE in and powers the switch, so it is the one that goes back toward the router.
+
+
+ Line drawing of a Ubiquiti NanoSwitch, a flat rounded rectangular enclosure with a round mounting point and a small status light. +
NanoSwitch
Outdoor enclosure
+
+
+ Line drawing of the NanoSwitch port face, showing four Ethernet ports in a row, each with a green and a red status light. +
NanoSwitch ports
+
+
+ ### Routers - [Ubiquiti EdgeRouter X](https://store.ui.com/collections/operator-edgemax-routers/products/edgerouter-x) - [Ubiquiti EdgePoint R6](https://store.ui.com/collections/operator-edgemax-control-points/products/edgepoint-r6) - see [NYC Mesh's doc](https://wiki.nycmesh.net/books/3-hardware-firmware/page/ubiquiti-edgepoint-r6) on this alternative to ER-X's. @@ -114,6 +117,11 @@ mounted at the site. - [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) + + ### Mounts - [Universal J-Arm Mount](https://store.ui.com/collections/operator-airmax-and-ltu-accessories/products/universal-antenna-mount) @@ -129,6 +137,12 @@ mounted at the site.
A PoE injector powers an AP over its Ethernet cable, so the AP needs no outlet of its own.
+Identify what voltage and wattage of Power-over-Ethernet (PoE) will be needed for the equipment. Notes on voltage: + +- ERXs (and, by extension, LiteBeams) are 24V +- Almost all access points are 48V + - UAP-AC-Mesh (colloquially known as “Bunny Ears”) can accept 48V or 24V + - Short-to-medium length Ethernet cable(s) - Outdoor-rated power strip(s) - Outdoor-rated extension cord(s) @@ -137,13 +151,13 @@ mounted at the site. - [PoE Injector/Splitter](https://www.newegg.com/p/2WG-00DK-00004) - [Ethernet to Ethernet adapter/coupler](https://www.newegg.com/p/0Y3-02J6-00001) - Pass-through Ethernet (RJ45) heads -- [USB Type C to Ethernet adapter](https://www.ebay.com/itm/132225990432?epid=910384900&hash=item1ec9487f20:g:FhgAAOSwqiVdyN) +- [USB Type C to Ethernet adapter](https://www.ebay.com/itm/132225990432) ## Tools ### Networking -- [Ethernet cable crimper](https://www.homedepot.com/p/Klein-Tools-Compact-Ratcheting-Modular-Crimper-VDV226-107/204732347?source=shoppingads&locale=en-US&srsltid=AfmBOopOP-5p-ibEZ6Xg-9GSiYkxoTyprixZLrUXPKiSeqJMjNqTxc5oPwU) +- [Ethernet cable crimper](https://www.homedepot.com/p/Klein-Tools-Compact-Ratcheting-Modular-Crimper-VDV226-107/204732347) - CAT5e cable stripper - [Ethernet cable tester](https://www.lowes.com/pd/Klein-Tools-Cable-Tester-Kit-with-Scout-Pro-3-Tester-Remotes-Adapter-Battery/5014306081) - Mobile hotspot diff --git a/docs/en/installations/install-planning.md b/docs/en/installations/install-planning.md new file mode 100644 index 0000000..3f55134 --- /dev/null +++ b/docs/en/installations/install-planning.md @@ -0,0 +1,99 @@ +# Install Planning + +## Building Assessment + +PCW regularly installs WiFi at a wide range of building types, such as rowhomes, multi-dwelling units (MDUs), community centers, and public spaces such as parks and gardens. + +Assessments generally take 15-30 minutes. Be sure to take lots of pictures for reference or planning. + +To assess a building for installation, we have to ask the following questions: + +* **Does the building have line-of-sight (LoS) to a PhillyWisper high site or close proximity to a current PCW mesh node?** + * Without direct LoS to a high site or existing node, the uplink radio's performance will be significantly degraded (if it can connect at all). + * Google Earth can be a useful tool for determining potential LoS, but in many cases a site visit may be necessary. + * Foliage from trees can cause significant interference - sites that are viable in the winter may be blocked by foliage in the summer. + * New construction also pops up suddenly. It is important to verify the conditions of the location in person, as Google maps etc may not have the latest surroundings up to date. + +* **Does the building have easy, safe, and simple roof/top floor access?** + * Are ladders required? Are there stairs/a roof access hatch? + * LiteBeams are ideally installed on the roof, either via pre-existing roof structure, j-arm mount on the wall, or non-penetrating roof mount. + * Do we have permission to mount on the building or on structures on the roof? + * PCW only installs on flat roofs, with rare exceptions. + +* **Is there access to power?** + * If outdoors, is the power source protected? + * Will the power source need to be used by something else? Is it accessible to others who could unplug our equipment? + * Are there pre-existing penetrations we can reuse to run power-over-Ethernet from indoors? + * PCW does not drill through roofs as they are too difficult to waterproof. + +* **Are there easy ways to mount access points?** + * eg: existing poles we could simply ziptie APs to VS bringing a non-penetrating roof mount or j-arm. + * How much cable will we have to run? + * What sort of access points will be necessary? Some are not weatherproof and can only be used indoors. + * Is there a chance mounting access points could damage the roof or walls? + * Is there pre-existing Internet infrastructure (previous coaxial or fiber installations) we need to be mindful of? Cables running in parallel can interfere with each other, degrading performance for both connections + +* **If maintenance is required, will we be able to return in the future?** + +Here are some considerations when thinking about outdoor vs. indoor power: + +* PCW prefers to use indoor power where possible, especially in residential homes. Using outdoor power creates higher risk for water-related issues with our equipment. +* Using indoor power requires us to run cable into a building. In most cases where we use outdoor power, this is because the cable run indoors is significantly more complicated. +* If there is existing outdoor power that we hope to use, it’s important to determine if it’s available for our usage, or needed for other outdoor equipment. +* Any outdoor power under consideration must have an outdoor-rated outlet cover. + +As an example, this is an ideal install site: + +
+ An ideal roof install location +
An ideal roof install location in Kensington
+
+ +* The roof is clear of debris and is flat, with plenty of space for non-penetrating roof mounts. +* The building is taller than almost every other building in the area, giving it free LoS to both PhillyWisper high sites and other potential PtP/PtMP sites. +* There is power on the roof, in this case covered GFCIs. + +## Access Point Placement + +Where an access point goes matters as much as which access point it is. This page covers how PCW +decides where to put APs — the difference between a hub and a node, and what to consider when a +node meshes wirelessly rather than being wired in. + +### Hubs and nodes + +Mesh nodes are installations where we do not use a Litebeam, but instead set up a wireless access +point that meshes from a nearby access point wired to a router and Litebeam at a local hub. + +Whether a site can be a hub is decided during the [building assessment](#building-assessment) — +a hub needs line-of-sight to a PhillyWisper high site. A node does not, but it does need a good +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. + + + +### 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) +is the reference we work from. The points that come up most often on PCW installs: + +* **Mesh networks should be supplemental** - Although mesh networks can operate comparably to a hard-wired network, connection quality and speed can be greatly affected by radiofrequency (RF) noise and obstructions between APs such as walls, trees, or other structures. +* **Mesh 'hops' should be minimized** - A meshed AP should only have one 'parent' - each mesh 'hop', or mesh connection between APs, results in a significant performance decrease. Ideally, there should be a maximum of two 'hops' - e.g, a mesh AP meshes with another mesh AP, which then meshes to a hard-wired AP. +* **Limit concurrent connections to a 'parent'** - Similarly, meshing too many APs to the same 'parent' creates additional RF noise and performance demands on the parent, resulting in decreased performance and stability. +* **Ensure strong signal strength between meshed APs** - Ideally, a meshed AP will have clear line-of-sight (LoS) to its mesh parent. A signal strength of -60 dBm is recommended for ideal performance. Ensure minimal obstructions between the meshed AP and the parent, such as walls, trees, furniture, etc. + +### Outdoor placement + +Outdoor APs should be mounted where they are radio-visible to the mesh APs at the home installs in +range, and high enough to clear whatever is around them. On [solar nodes](solar.md), that usually +means the AP sits at the top of the mast with the panel and enclosure mounted below it. + +For how to configure an AP once it is placed, see the +[Configure Unifi APs](../device-configuration/configure-ap-mesh.md) guide. diff --git a/docs/en/installations/installations.md b/docs/en/installations/installations.md index 1896cfe..339475c 100644 --- a/docs/en/installations/installations.md +++ b/docs/en/installations/installations.md @@ -11,9 +11,9 @@ Philly Community Wireless seeks to build community-owned and community-operated Most installations proceed in the following order: -1. **Building Assessment** - A new address is submitted to us. We check if the address has [line of sight (LoS)](https://en.wikipedia.org/wiki/Line-of-sight_propagation) to a PhillyWisper high site using Google Earth and other mapping tools, and we conduct both remote and in-person building assessments as part of developing an install plan. For more information, please see [Building Assessments](buildingassessment.md) page. +1. **Building Assessment** - A new address is submitted to us. We check if the address has [line of sight (LoS)](https://en.wikipedia.org/wiki/Line-of-sight_propagation) to a PhillyWisper high site using Google Earth and other mapping tools, and we conduct both remote and in-person building assessments as part of developing an install plan. For more information, please see [Install Planning](install-planning.md) page. 2. **Install Planning** - If there is LoS, we communicate with the resident or community organization to determine their connectivity needs, as well as needs of neighbors and the general area. This helps us determine what sort of access points and networking equipment to bring, as well as how much cable we will need. Once the logistics for the initial install are determined, an install date is set! -3. **Establish uplink** - On the day of the install, PCW will begin by installing the uplink radio pointing back at a PhillyWisper high site, usually a [LiteBeam](https://store.ui.com/us/en/products/litebeam-5ac). This provides the internet connection. +3. **Establish uplink** - On the day of the install, PhillyWisper will begin by installing the uplink radio pointing back at a PhillyWisper high site, usually a [LiteBeam](https://store.ui.com/us/en/products/litebeam-5ac). This provides the internet connection. 4. **Deploy access points** - Once the uplink is set up, we can begin running cable on the roof or through the building and deploying WiFi access points as needed, either indoors or outdoors. During residential installs, we either broadcast a private network for the resident to use from the same access points broadcasting the public PCW network, or provide an additional router for the resident to have their own private network that gets its uplink from the PCW network. @@ -42,9 +42,9 @@ Typically, installs take between two and four hours to complete, but in certain Internet installations typically consist of a rooftop antenna, a power-over-Ethernet injector, a router, and a WiFi access point (all of which are typically Ubiquiti networking equipment). During installation, PhillyWisper and Philly Community Wireless take every effort to minimally impact buildings. At any given install site, our installation work will be customized to ensure the least invasive and most secure placement of networking equipment, according to industry standards. -For most locations, we first install a Ubiquiti LiteBeam radio antenna on the roof of the home, which receives signal from a nearby high site managed by PhillyWisper. To install the rooftop antenna, PhillyWisper technicians will access a high point and mount the small radio antenna (see attached images of various mounting techniques below) that they precision aim at the closest source tower. We never penetrate the roofing system itself when mounting the antenna, and wherever possible we utilize preexisting structures (chimneys, vent pipes, etc). If preexisting structures aren't an option, we use a non-penetrating roof mount, which is properly weighed down and rests on a rubber mat on top of your roof. +For most locations, we first install a Ubiquiti LiteBeam radio antenna on the roof of the home, which receives signal from a nearby high site managed by PhillyWisper. To install the rooftop antenna, PhillyWisper technicians will access a high point and mount the small radio antenna (see the images of various mounting techniques below) that they precision aim at the closest source tower. We never penetrate the roofing system itself when mounting the antenna, and wherever possible we utilize preexisting structures (chimneys, vent pipes, etc). If preexisting structures aren't an option, we use a non-penetrating roof mount. -The rooftop radio is powered via outdoor-rated Ethernet cable that runs down the building exterior and into the home (our equipment uses Power over Ethernet, so we can power outdoor devices with Ethernet from an indoor outlet). We make sure the wire run is as inconspicuous as possible and ensure there is plenty of tension on the wire so that it doesn't flap in the wind. If there are any preexisting penetrations entering the building from previous ISPs, they will use that if possible and caulk when finished. +The rooftop radio is powered via outdoor-rated Ethernet cable that runs down the building exterior and into the home. We make sure the wire run is as inconspicuous as possible and ensure there is plenty of tension on the wire so that it doesn't flap in the wind. If there are any preexisting penetrations entering the building from previous ISPs, we will use that if possible and caulk when finished. ## Installation Examples @@ -94,7 +94,7 @@ The powered Ethernet cable is wired to a Ubiquiti EdgeRouter-X (or possibly anot
Ubiquiti EdgeRouterX
-Finally, a Ubiquiti Mesh AP ("bunny ears" because look at them!) is connected to the router and allows devices in its radio signal range to connect to the network. The bunny ears should be installed in a location that is radio-visible to the mesh APs at the home installs in range. +Finally, a Ubiquiti Mesh AP ("bunny ears" because look at them!) is connected to the router and allows devices in its radio signal range to connect to the network.
- The full solar mesh node at Colobo Gardens: the access point atop the bamboo mast, with the solar panel mounted on the roof below
The full solar mesh node at Colobo Gardens: the access point atop the bamboo mast, with the solar panel mounted on the roof below
- The solar panel on its angled mount at the roof edge, with the wiring running down to the enclosure
The solar panel on its angled mount at the roof edge, with the wiring running down to the enclosure
@@ -38,7 +38,7 @@ PCW installed a solar mesh node in Norris Square Neighborhood Projects Colobo Ga The weather-proof enclosure holds everything that is not the panel or the access point: the battery, the charge controller, and the PoE injector that carries power up to the AP over a single Ethernet run.
- The open enclosure, with the battery, charge controller and PoE injector labelled
Inside the enclosure at Colobo Gardens
diff --git a/docs/en/resources.md b/docs/en/resources.md index 257d30b..f9c9658 100644 --- a/docs/en/resources.md +++ b/docs/en/resources.md @@ -1,6 +1,5 @@ --- title: Resources - --- # Resources @@ -28,10 +27,6 @@ title: Resources [Portable Network Kit Setup Guide](https://www.communitytechny.org/portable-network-kits), Community Tech NY -[Wireless Networking in the Developing World](http://wndw.net). 3rd Edition. Copenhagen, 2013. - -[The Community Network Manual: How to Build the Internet Yourself](https://bibliotecadigital.fgv.br/dspace/handle/10438/25696) - [Meshnet DWeb Camp 2019](https://dweb-camp-2019.github.io/meshnet/) ## Policy & Organizing Models @@ -68,6 +63,6 @@ Sanchez, Alvaro. "[Toward Digital Inclusion: Broadband Access in the Third Feder Shaffer, Gwen. "[Common Sense: An Examination of Three Los Angeles Community WiFi Projects That Privileged Public Funding Over Commons-Based Infrastructure Management](https://doi.org/10.2139/ssrn.2941920)." Rochester, NY: Social Science Research Network, March 28, 2017. -Solomon, Rory. [_Meshiness: Mesh Networks and the Politics of Connectivity_](http://search.proquest.com/pqdtglobal/docview/2408892960/abstract/479AB38D8B044610PQ/1)_._ Ph.D., New York University, 2020. +Solomon, Rory. [_Meshiness: Mesh Networks and the Politics of Connectivity_](http://search.proquest.com/pqdtglobal/docview/2408892960/abstract/479AB38D8B044610PQ/1). Ph.D., New York University, 2020. Thakur, Dhanaraj, and Teddy Woodhouse. "[Meaningful Connectivity: A New Standard to Raise the Bar for Internet Access](https://web.archive.org/web/20260220230151/https://a4ai.org/meaningful-connectivity/)." Alliance for Affordable Internet, 2020. diff --git a/docs/es/device-configuration/troubleshoot-devices.md b/docs/es/device-configuration/troubleshoot-devices.md index abb4a8a..42e18c1 100644 --- a/docs/es/device-configuration/troubleshoot-devices.md +++ b/docs/es/device-configuration/troubleshoot-devices.md @@ -8,6 +8,18 @@ title: Solución de problemas de dispositivos Unifi No todos los dispositivos funcionarán perfectamente. Además, los dispositivos instalados al aire libre estarán expuestos a los elementos, principalmente al calor y la humedad, y se desgastarán naturalmente con el tiempo. Dicho esto, los puntos de acceso para exteriores a menudo han durado 5 años o más. En Filadelfia, rara vez tenemos un clima tan severo que dañe nuestros radios. +## Mantenimiento y solución de problemas + +Estas son algunas consideraciones para el trabajo de mantenimiento y solución de problemas: + +* Empiece por identificar el problema. ¿Qué evidencia podemos usar para entender por qué el equipo podría no estar funcionando correctamente? + * Revise la fuente de alimentación. + * Asegúrese de que todo el equipo esté bien conectado. + * Busque daños por agua. + * Revise la configuración en el Controlador. +* Pruebe siempre primero la solución más sencilla. +* No dude en programar una visita de seguimiento si un problema no se puede resolver el mismo día. + ## Indicadores LED de estado de los AP Unifi Cada AP Unifi tiene un LED que indica su estado actual. @@ -55,7 +67,7 @@ Consulte [esta página](https://help.ui.com/hc/en-us/articles/204910134-Understa **Observaciones**: No hay luces; el dispositivo está fuera de línea o no aparece en UISP. **Posibles causas y soluciones**: -* **Conexión de alimentación o cable Ethernet defectuoso (si usa PoE)** - Pruebe el ERX con otra fuente de alimentación de 9 V y compruebe si el ERX se conecta. Pruebe cambiar a una fuente de alimentación de 9 V diferente. Si usa PoE, asegúrese de que el voltaje sea el correcto. +* **Conexión de alimentación o cable Ethernet defectuoso (si usa PoE)** - Pruebe el ERX con otra fuente de alimentación de 12 V y compruebe si el ERX se conecta. Pruebe cambiar a una fuente de alimentación de 12 V diferente. Si usa PoE, asegúrese de que el voltaje sea el correcto. ## Comandos de terminal útiles para redes * `ipconfig` (Windows)/`ifconfig` (Unix) - muestra las interfaces de red e información relacionada: dirección IP, máscara de subred y puerta de enlace predeterminada. diff --git a/docs/es/glossary.md b/docs/es/glossary.md index ed114e5..3b9ac0d 100644 --- a/docs/es/glossary.md +++ b/docs/es/glossary.md @@ -43,7 +43,7 @@ pase el cursor sobre cualquier término subrayado con puntos para ver su definic : La marca de equipos wifi que usa PCW; una familia de puntos de acceso inalámbricos, conmutadores (switches), routers, controladores, teléfonos VoIP y productos de control de acceso. [Línea de productos Unifi](https://techspecs.ui.com/unifi) (en inglés) **EdgeRouter-X (ERX)** -: El router que PCW usa como conmutador (switch); un conmutador transfiere datos entre dispositivos. [Página del producto EdgeRouter X](https://store.ui.com/us/en/pro/category/wired-edge-max-routing/products/er-x) (en inglés) +: El router que PCW usa. [Página del producto EdgeRouter X](https://store.ui.com/us/en/pro/category/wired-edge-max-routing/products/er-x) (en inglés) **Power over Ethernet (PoE) — alimentación a través de Ethernet** : Transmisión de energía eléctrica junto con los datos por el cableado Ethernet, de modo que un dispositivo exterior pueda recibir electricidad desde un tomacorriente interior. [Página del producto: inyector PoE](https://store.ui.com/us/en/pro/products/poe-24) (en inglés) diff --git a/docs/es/index.md b/docs/es/index.md index ce1b6c6..aacf929 100644 --- a/docs/es/index.md +++ b/docs/es/index.md @@ -2,17 +2,17 @@ title: Inicio --- -# El proyecto PCW + +# ¡Bienvenido a la documentación de Philly Community Wireless! -**Philly Community Wireless** (PCW) es un proyecto para desarrollar redes de malla de propiedad comunitaria en North Philly. Somos un grupo de trabajo de organizadores, tecnólogos, académicos, maestros de escuelas públicas y personal del Ayuntamiento de Filadelfia. Durante una época de distanciamiento social y enseñanza en línea, aproximadamente la mitad de los estudiantes de las escuelas públicas de la ciudad carecen de conexión wifi en casa. En ciertos vecindarios, aún más residentes carecen de conexión a Internet. Buscamos abordar la brecha digital de **la ciudad con tecnologías de red de malla operadas y propiedad de la comunidad.** +**Philly Community Wireless** (PCW) está construyendo redes inalámbricas de Internet controladas por la comunidad en Filadelfia. Nuestro objetivo es ofrecer un acceso básico a Internet para todos, mejorando la calidad de vida hoy y preparando a las comunidades para un mañana más saludable y próspero. Con la ayuda de [**PhillyWisper**](https://phillywisper.net/), un proveedor de servicios de Internet inalámbrico que defiende la neutralidad de la red, estamos instalando Internet activamente en **Norris Square**, **Fairhill** y **Kensington**, en espacios públicos y privados del norte de Filadelfia. Puede ver el alcance geográfico de nuestra red en nuestro [mapa web](https://phillycommunitywireless.org/networkmap). -Las redes de malla permiten compartir una única conexión a Internet entre un grupo más amplio de usuarios con muy poco costo o infraestructura necesaria. Con la ayuda de **PhillyWisper**, un proveedor de servicios de Internet inalámbrico que defiende la neutralidad de la red, estamos trabajando para instalar dos sitios piloto en **Kensington y Fairhill**. A partir de ahí, planearemos talleres de diseño participativo y capacitación técnica para la comunidad que los capacitará para mantener y hacer crecer esta conexión de red gratuita. - -## Los documentos de PCW -Esta página de documentos proporciona información técnica en desarrollo y guías para replicar la configuración y distribución del proyecto de routers y antenas para construir una red de malla. +Nuestra red comunitaria inalámbrica de malla nos permite compartir conexiones a Internet entre un grupo más amplio de usuarios, con muy poco costo de infraestructura. Esta página de documentación ofrece información técnica y guías para personas u organizaciones que quieran contribuir a la configuración e instalación de routers y antenas de la organización, o replicarlas en otro lugar, para construir una red pública inalámbrica de malla a gran escala. Si está buscando una **descripción no técnica del proyecto** o está interesado en suscribirse a la cobertura de PCW, visite nuestra [página principal](https://phillycommunitywireless.org). +Si tiene más preguntas, no dude en escribirnos a info@phillycommunitywireless.org. + ## Por dónde empezar @@ -29,9 +29,13 @@ Si está buscando una **descripción no técnica del proyecto** o está interesa **Instalaciones** -- [Evaluación del edificio](installations/buildingassessment.md) -- [Ubicación de los puntos de acceso](installations/ap-placement.md) +- [Principios rectores](installations/handbook/overview.md) +- [Fundamentos de seguridad](installations/handbook/safety-basics.md) +- [Seguridad en azoteas, escaleras y taladros](installations/handbook/risks-rooftop-ladder-drill.md) +- [Seguridad en edificios y eléctrica](installations/handbook/safety-buildings-electrical.md) +- [Planificación de la instalación](installations/install-planning.md) - [Hardware](installations/hardware.md) +- [Cableado y montaje](installations/cabling-and-mounting.md) **Redes y configuración de dispositivos** diff --git a/docs/es/installations/ap-placement.md b/docs/es/installations/ap-placement.md deleted file mode 100644 index 102ea94..0000000 --- a/docs/es/installations/ap-placement.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Ubicación de los puntos de acceso ---- - - -!!! note "Traducción preliminar" - Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/ap-placement/) es la referencia. - -# Ubicación de los puntos de acceso - -El lugar donde se coloca un punto de acceso importa tanto como el modelo de punto de acceso que se utiliza. Esta página explica cómo PCW -decide dónde colocar los APs: la diferencia entre un hub (nodo central) y un nodo, y qué tener en cuenta cuando un -nodo se conecta en malla de forma inalámbrica en lugar de por cable. - -## Hubs y nodos - -Los nodos de malla son instalaciones en las que no usamos una antena LiteBeam, sino que colocamos un punto de acceso -inalámbrico que se conecta en malla a un punto de acceso cercano, el cual está conectado por cable a un router y a una LiteBeam en un hub local. - -Si un sitio puede ser un hub se decide durante la [evaluación del edificio](buildingassessment.md): -un hub necesita línea de visión con un sitio alto de PhillyWisper. Un nodo no la necesita, pero sí requiere un buen -enlace inalámbrico de regreso a un hub, que es el tema del resto de esta página. - -## Consideraciones al instalar un nodo de malla - -La guía de Ubiquiti [Considerations for Optimal Wireless Mesh Networks](https://help.ui.com/hc/en-us/articles/115002262328-Considerations-for-Optimal-Wireless-Mesh-Networks) -(consideraciones para redes de malla inalámbricas óptimas, en inglés) es nuestra referencia de trabajo. Los puntos que surgen con más frecuencia en las instalaciones de PCW son: - -* **Las redes de malla deben ser complementarias**: aunque una red de malla puede funcionar de manera comparable a una red cableada, la calidad y la velocidad de la conexión pueden verse muy afectadas por el ruido de radiofrecuencia (RF) y por obstáculos entre los APs, como paredes, árboles u otras estructuras. -* **Se deben minimizar los "saltos" de la malla**: un AP de malla debe tener un solo "padre". Cada "salto" de la malla, es decir, cada conexión en malla entre APs, provoca una disminución significativa del rendimiento. Lo ideal es un máximo de dos "saltos"; por ejemplo, un AP de malla se conecta a otro AP de malla, que a su vez se conecta a un AP cableado. -* **Limite las conexiones simultáneas a un mismo "padre"**: del mismo modo, conectar demasiados APs en malla al mismo "padre" genera más ruido de RF y más exigencias de rendimiento sobre ese AP, lo que reduce el rendimiento y la estabilidad. -* **Asegure una señal fuerte entre los APs de malla**: lo ideal es que un AP de malla tenga línea de visión (LoS) despejada con su AP padre. Se recomienda una intensidad de señal de -60 dBm para un rendimiento óptimo. Procure que haya los menos obstáculos posibles entre el AP de malla y el padre, como paredes, árboles, muebles, etc. - -## Ubicación en exteriores - -Los APs de exterior deben montarse donde tengan visibilidad de radio con los APs de malla de las instalaciones domésticas que estén -dentro de su alcance, y a una altura suficiente para sobrepasar lo que haya a su alrededor. En los [nodos solares](solar.md), eso normalmente -significa que el AP va en la parte superior del mástil, con el panel y la caja montados debajo. - -Para saber cómo configurar un AP una vez colocado, consulte la guía -[Configurar APs Unifi](../device-configuration/configure-ap-mesh.md). diff --git a/docs/es/installations/buildingassessment.md b/docs/es/installations/buildingassessment.md deleted file mode 100644 index d8a2373..0000000 --- a/docs/es/installations/buildingassessment.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Evaluación del edificio ---- - - -!!! note "Traducción preliminar" - Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/buildingassessment/) es la referencia. - -PCW instala wifi con regularidad en una gran variedad de edificios, como casas en hilera, edificios multifamiliares (MDUs), centros comunitarios y espacios públicos como parques y jardines. - -Para evaluar si un edificio es adecuado para una instalación, debemos hacernos las siguientes preguntas: - -* **¿Tiene el edificio línea de visión (LoS) hacia un sitio alto de PhillyWisper, o está muy cerca de un nodo de malla de PCW existente?** - * Sin LoS directa hacia un sitio alto o un nodo existente, el rendimiento de la radio de enlace ascendente (uplink) se reducirá considerablemente (si es que logra conectarse). - * Google Earth puede ser una herramienta útil para determinar si existe una posible LoS, pero en muchos casos puede ser necesaria una visita al lugar. - * El follaje de los árboles puede causar interferencias importantes: ¡los lugares que funcionan en invierno pueden quedar bloqueados por el follaje en verano! - * Además, las construcciones nuevas aparecen de repente. Es importante verificar en persona las condiciones del lugar, ya que Google Maps y herramientas similares pueden no tener actualizado el entorno. - -* **¿El acceso a la azotea o al último piso del edificio es fácil, seguro y sencillo?** - * ¿Se necesitan escaleras de mano? ¿Hay escaleras o una escotilla de acceso a la azotea? - * Lo ideal es instalar las LiteBeam en la azotea, ya sea en una estructura existente del techo, con un soporte tipo J (J-arm) en la pared o con un soporte de techo no penetrante. - * ¿Tenemos permiso para instalar equipos en el edificio o en las estructuras de la azotea? - * PCW solo instala en techos planos, salvo raras excepciones. - -* **¿Hay acceso a electricidad?** - * Si la toma está en el exterior, ¿está protegida? - * ¿Será necesario usar la toma de corriente para otra cosa? ¿Tienen acceso a ella otras personas que podrían desconectar nuestro equipo? - * ¿Hay perforaciones existentes que podamos reutilizar para llevar la alimentación a través de Ethernet (PoE) desde el interior? - * PCW NO perfora techos, ya que es muy difícil impermeabilizarlos. - -* **¿Hay maneras fáciles de montar los puntos de acceso?** - * Por ejemplo: postes existentes a los que podríamos simplemente sujetar los APs con amarres plásticos (zip ties), en lugar de traer un soporte de techo no penetrante o un soporte tipo J. - * ¿Cuánto cable tendremos que tender? - * ¿Qué tipo de puntos de acceso se necesitarán? Algunos no son resistentes a la intemperie y solo pueden usarse en interiores. - * ¿Existe la posibilidad de que el montaje de los puntos de acceso dañe el techo o las paredes? - * ¿Hay infraestructura de Internet existente (instalaciones anteriores de cable coaxial o de fibra óptica) que debamos tener en cuenta? Los cables que corren en paralelo pueden interferir entre sí y reducir el rendimiento de ambas conexiones. - -* **Si se necesita mantenimiento, ¿podremos regresar en el futuro?** - -Por ejemplo, este es un lugar ideal para una instalación: - -
- Un lugar ideal para una instalación en azotea -
Un lugar ideal para una instalación en azotea en Kensington
-
- -* La azotea es plana y está libre de escombros, con mucho espacio para soportes de techo no penetrantes. -* El edificio es más alto que casi todos los demás edificios de la zona, lo que le da LoS despejada tanto hacia los sitios altos de PhillyWisper como hacia otros posibles sitios PtP/PtMP. -* Hay electricidad en la azotea; en este caso, tomacorrientes GFCI con tapa protectora. diff --git a/docs/es/installations/cabling-and-mounting.md b/docs/es/installations/cabling-and-mounting.md new file mode 100644 index 0000000..278b288 --- /dev/null +++ b/docs/es/installations/cabling-and-mounting.md @@ -0,0 +1,45 @@ + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/cabling-and-mounting/) es la referencia. + +# Cableado y montaje + +Siga el orden de las operaciones: no fije los cables hasta que el tendido esté completo y probado; no asegure los soportes hasta que los cables se hayan tendido. + +## Tienda el cable Ethernet de extremo a extremo + +- Tienda el cable a lo largo de la ruta prevista, midiendo la longitud necesaria. +- Si el tendido del cable pasa entre el interior y el exterior, determine por dónde. + - Busque agujeros preexistentes que podamos usar para evitar taladrar cuando sea posible. + - Busque tendidos de cable anteriores junto a los que se pueda taladrar, manteniendo uniforme el cableado alrededor del edificio. + - Si es necesario taladrar, consulte [Al taladrar en interiores](handbook/risks-rooftop-ladder-drill.md#al-taladrar-en-interiores). +- Mientras tiende el cable, sujételo temporalmente a objetos existentes para ayudar a guiarlo donde sea necesario. +- Corte el cable una vez determinada la longitud, dejando holgura adicional en ambos extremos. + +## Crimpe y pruebe el Ethernet + +- PCW crimpa el cable Ethernet según el patrón de crimpado T568B, que es el más utilizado. Consulte la [sección sobre Ethernet del Book de NYC Mesh](https://wiki.nycmesh.net/books/3-hardware-firmware/page/ethernet-cable) para más información. +- Cuando termine de ordenar los hilos del cable, páselos por conectores RJ45 pasantes con el lado de la ventana hacia usted. Asegúrese de que el RJ45 quede lo más metido posible sobre la funda de goma del cable. +- Pruebe el Ethernet con el probador Klein Tools y asegúrese de que el cable pase la prueba. + - Nota: la fila superior visible en la pantalla del probador muestra el extremo del Ethernet conectado al extremo principal del probador. La fila inferior muestra el extremo del Ethernet conectado al extremo remoto (la pieza que se separa). + +## Pruebe los dispositivos + +- Conecte los dispositivos al cable crimpado. Asegúrese de que estén recibiendo la cantidad correcta de energía por PoE. +- Pruebe para asegurarse de que el dispositivo esté recibiendo datos y de que el Wi-Fi funcione. + - Las luces blancas y/o azules suelen ser buena señal. + - Se pueden usar teléfonos para comprobar que un dispositivo esté emitiendo Wi-Fi. + - Los dispositivos aparecerán en el controlador UniFi de PCW y deberían indicar “Adopted”. + +## Monte los puntos de acceso y fije el cable + +- Instale el soporte del punto de acceso, si usa un J-arm o una placa de montaje. + - Nunca taladramos un techo para montar equipos. Si usa un soporte de techo no penetrante, este soporte debe armarse antes o mientras se tiende el cable Ethernet. +- Coloque los puntos de acceso en sus soportes. + - Siempre procuramos dejar holgura adicional en el cable Ethernet. Esta holgura debe enrollarse con cuidado y sujetarse al soporte (o cerca de él) con bridas o cinta aislante. + - En algunos casos, los cables deben colocarse de modo que formen un “bucle de goteo” justo antes de que el Ethernet entre en un dispositivo. [Obtenga más información sobre los bucles de goteo aquí](https://support.huawei.com/enterprise/en/doc/EDOC1100278610/f5d86b9c/guide-to-making-drip-loops). +- Asegure el cable Ethernet lo mejor posible para evitar daños (por el viento, etc.) con el tiempo. Estas son algunas buenas prácticas para fijar cables con grapas: + - Fije los cables de la forma más discreta posible. En interiores, eso a menudo significa tender los cables junto a los zócalos, los marcos de las puertas o donde las paredes se unen con el techo. + - Use grapas con tornillo en exteriores. Coloque una grapa cada 1-2 pies. + - Para ladrillo, concreto y otros materiales más duros, pretaladre con brocas Tapcon y luego coloque Tapcons (tornillos azules) en las grapas de plástico negras, retirando los tornillos originales. + - Para instalaciones en interiores, es preferible usar “grapas de plástico” (es decir, clavos con sujetacables de plástico), por su facilidad y porque hacen agujeros más pequeños. Use grapas negras con cable negro y grapas blancas con cable blanco. diff --git a/docs/es/installations/handbook/assessment-planning.md b/docs/es/installations/handbook/assessment-planning.md deleted file mode 100644 index 9617848..0000000 --- a/docs/es/installations/handbook/assessment-planning.md +++ /dev/null @@ -1 +0,0 @@ -# Evaluación y planificación diff --git a/docs/es/installations/handbook/etiquette.md b/docs/es/installations/handbook/etiquette.md deleted file mode 100644 index 23329e2..0000000 --- a/docs/es/installations/handbook/etiquette.md +++ /dev/null @@ -1 +0,0 @@ -# Normas de conducta en el sitio diff --git a/docs/es/installations/handbook/install-day-and-maintenance.md b/docs/es/installations/handbook/install-day-and-maintenance.md deleted file mode 100644 index 7413d4f..0000000 --- a/docs/es/installations/handbook/install-day-and-maintenance.md +++ /dev/null @@ -1 +0,0 @@ -# El día de la instalación y el mantenimiento diff --git a/docs/es/installations/handbook/overview.md b/docs/es/installations/handbook/overview.md index 766a89a..b9e85c8 100644 --- a/docs/es/installations/handbook/overview.md +++ b/docs/es/installations/handbook/overview.md @@ -1 +1,89 @@ -# Descripción general + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../../installations/handbook/overview/) es la referencia. + +# Principios rectores + +El objetivo de PCW es realizar un trabajo exitoso y de calidad de la manera más segura y eficiente posible, a la vez que facilitamos el aprendizaje de nuestra comunidad. Estos son algunos principios rectores que ayudan a alcanzar ese objetivo. + +## Mantenerlo simple + +La navaja de Occam: mantenga las cosas simples. No haga nada inseguro que no sea necesario. Intente hacer la versión más sencilla de cada tarea. Reduzca en lo posible las variables que introducen factores nuevos o complicados. Cada instalación ya implica una amplia gama de variables: el espacio físico, las personas involucradas, el equipo y las herramientas que se usan, el entorno, y más. Teniendo en cuenta todo lo que hay que gestionar durante una instalación, no introduzca varias cosas nuevas o experimentales a la vez. Haga los cambios de forma iterativa. + +Cada instalación debe tener un producto mínimo viable (MVP), identificado durante la fase de preparación. A veces esto significa simplemente poner en línea una LiteBeam de PhillyWisper. A veces significa instalar un solo punto de acceso (AP). + +Haga una pausa para pensar. En cada punto de decisión, deténgase y pregunte (a usted mismo y/o a sus compañeros instaladores): "¿Cuál es el propósito de hacer esto? ¿Hay una mejor manera de hacerlo que no estoy viendo de inmediato?". + +Considere siempre qué podemos hacer para minimizar y evitar riesgos, tanto individual como colectivamente. + +Reducir la velocidad puede ayudar a mantener el control y la atención en el sitio. No haga movimientos rápidos (p. ej., correr, saltar) y no se apresure en las tareas. + +## Mantener la concentración + +Concéntrese en la instalación. No se deje absorber por personas o acontecimientos externos al trabajo que se está realizando. + +La conciencia situacional es un componente crítico para mantenerse seguro. Manténgase atento a lo que sucede a su alrededor tanto como sea posible. Las distracciones pueden aumentar la posibilidad de lesiones. + +## Comunicarse + +Priorice el trabajo en equipo y mantenerse en sintonía. Haga contacto visual al hablar entre ustedes. Use la técnica de "repetir en bucle" (looping) para asegurar la comprensión: escuche a la otra persona y luego repita lo que escuchó para confirmar que ambos entienden lo mismo. No cambie los planes sin comunicar esos cambios al equipo. Si se separan, usen los teléfonos para comunicarse. + +La comunicación es una parte crucial de la seguridad. Es imprescindible que todas las personas involucradas en una actividad de instalación o mantenimiento escuchen, hagan preguntas, alcen la voz si creen que algo podría cambiarse o si se sienten incómodas, y avisen antes de trasladarse a otro lugar. + +Avise al supervisor del sitio antes de abandonar el lugar de trabajo. + +No tenga miedo de decirle a alguien que no haga algo si cree que debería hacer una pausa o detenerse. + +## Cuidarse mutuamente + +El personal de PCW son los líderes y supervisan a todos los participantes. Darán indicaciones y comentarios. + +Pregunte repetidamente cómo se sienten las personas. Observe el entorno y use la conciencia situacional para identificar posibles puntos de dificultad sobre los que preguntar: el clima, las condiciones de trabajo, las alturas, los insectos, etc. Tenga refrigerios y agua a mano. + +## Aprender sobre la marcha + +Involúcrense unos a otros. Incluso un voluntario primerizo puede participar de manera significativa aprendiendo a crimpar, conectando un dispositivo, etc. Invite a todos a tener un rol en el trabajo. + +Haga una reunión de cierre después de las instalaciones o el trabajo de mantenimiento para reflexionar sobre el trabajo realizado, las áreas de mejora y las lecciones aprendidas. + + + +## Política de instalación + +Como miembro del personal o del equipo de voluntarios de PCW, usted representa a nuestra organización y al importante trabajo que hacemos: ampliar el acceso y la adopción de Internet, y abogar por una mayor inclusión digital. Ser respetuoso, proactivo y profesional al interactuar con los miembros de la comunidad es una contribución positiva que puede ayudar mucho a dejar una gran huella duradera y a apoyar el trabajo de PCW. + +Consulte también: [Código de conducta](https://phillycommunitywireless.org/code-of-conduct/) + +### Antes de una instalación o visita de mantenimiento + +Llegue a la sede (HQ) a la hora designada (normalmente 1 hora antes de la hora de inicio programada en el sitio). Si va con retraso, debe comunicar su nueva hora estimada de llegada al personal de PCW por Slack. Es posible que los voluntarios que lleguen con más de 15 minutos de retraso no puedan participar. + +En la sede (HQ), antes de cargar el/los auto(s), repase el plan de instalación y haga una revisión de seguridad. Repase los posibles riesgos asociados con el trabajo del día. Establezca una comprensión del nivel de comodidad de cada persona con escaleras, alturas, taladros y otros elementos del trabajo en el sitio. Todos los participantes de la instalación deben ayudar a empacar y cargar el equipo. Por favor, no traiga sus propias herramientas a una instalación. Si nos falta una herramienta, no dude en decírnoslo. + +### Durante la instalación o visita de mantenimiento + +Nuestro trabajo de instalación o mantenimiento se realiza en espacios comunitarios. Todos los participantes de la instalación deben ser amables, corteses y considerados al entrar en el espacio de otra persona. Si el trabajo es principalmente en interiores, consulte con el anfitrión si debemos quitarnos los zapatos mientras estamos dentro de su casa, especialmente durante el invierno. + +Todos los miembros del equipo de instalación del personal deben presentarse verbalmente al anfitrión. El personal puede presentar a los voluntarios, o los voluntarios pueden presentarse ellos mismos. El personal de PCW debe explicar al anfitrión del sitio información básica sobre el plan de instalación o mantenimiento, comunicar un cronograma estimado y luego preguntar si el anfitrión tiene alguna pregunta antes de comenzar. + +Cuide su lenguaje y su nivel de ruido. No toque nada en el espacio del anfitrión, grande o pequeño, sin preguntar. Normalmente es evidente si un anfitrión prefiere que se le pregunte cada vez, o si da una instrucción general (p. ej., "Preferiría que no toquen nada" o "¡No hace falta volver a preguntar!"). Mantenga un espacio de trabajo ordenado; recoja la basura sobre la marcha. + +Priorice el "modo de trabajo" por encima de todo lo demás. Todos los participantes deben responder a las indicaciones y comentarios. Evite el uso personal del teléfono siempre que sea posible. Cada miembro del equipo de instalación debe tener un teléfono cargado y mantenerse en contacto con los miembros del personal de PCW por Slack o Signal. + +Las políticas y los flujos de trabajo de PCW pueden diferir de sus experiencias anteriores. Agradecemos los comentarios, pero tenga en cuenta que cualquier cambio en nuestros protocolos de instalación requerirá más discusión. + +### Cierre de la instalación o visita de mantenimiento + +Limpie cualquier desorden que se haya hecho. Si se movieron objetos dentro del espacio, asegúrese de volver a ponerlos en su lugar. Al empacar, tenga cuidado de no dejar ninguna herramienta, equipo u otro objeto. Tome fotos del trabajo realizado ese día. Recuerde que estas fotos pueden compartirse en nuestros canales de comunicación públicos, así que intente tomar fotos visualmente agradables. + +Asegúrese de despedirse del anfitrión. Si no está presente, envíele un mensaje de texto o un correo electrónico para darle las gracias. En la mayoría de las ocasiones, los participantes de la instalación deben desempacar en grupo al volver a la sede (HQ), asegurándose de que las bolsas de herramientas estén en buen estado y reabastecidas para la próxima instalación. + + +### Difusión + +Los materiales de difusión deben llevarse a todas las instalaciones. Una vez terminado el trabajo de instalación: + +- Se deben colocar calcomanías en los dispositivos instalados. Estas incluyen nuestras calcomanías de "Do Not Touch – Community Internet" y las calcomanías circulares de PCW de 3" o 4", según el tamaño del dispositivo. +- Si hay personas en la calle, avíseles que ahora hay Wi-Fi gratuito allí. Entrégueles una postal informativa general de PCW si les interesa. + + diff --git a/docs/es/installations/handbook/phases-overview.md b/docs/es/installations/handbook/phases-overview.md deleted file mode 100644 index 5de025a..0000000 --- a/docs/es/installations/handbook/phases-overview.md +++ /dev/null @@ -1 +0,0 @@ -# Descripción general de las fases de instalación diff --git a/docs/es/installations/handbook/risks-rooftop-ladder-drill.md b/docs/es/installations/handbook/risks-rooftop-ladder-drill.md index cb6c2bb..01a8105 100644 --- a/docs/es/installations/handbook/risks-rooftop-ladder-drill.md +++ b/docs/es/installations/handbook/risks-rooftop-ladder-drill.md @@ -1 +1,96 @@ -# Seguridad en azoteas, escaleras y con taladros + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../../installations/handbook/risks-rooftop-ladder-drill/) es la referencia. + +# Seguridad en azoteas, escaleras y taladros + +## Azoteas + +Nuestro trabajo de instalación y mantenimiento a menudo implica subir a las azoteas de los edificios. Independientemente del acceso a la azotea, su tamaño, su material, sus "bordes" u otros factores, PCW aplica las siguientes reglas y pautas para garantizar la seguridad en las azoteas. + +Manténgase alejado del borde de la azotea tanto como sea posible. No se asome por el borde para mirar hacia abajo o inspeccionar la zona para tareas como fijar cables, a menos que sea absolutamente necesario. Si se acerca al borde de una azotea por motivos de trabajo, baje su centro de gravedad cuanto más se acerque. Trabaje de rodillas, sentado o, si está justo al borde, acostado boca abajo. + +Nunca se mueva rápido en una azotea. No corra. + +Al subir objetos a la azotea con una cuerda, mantenga el peso por debajo de ~25 lb por bolsa. Las personas en la azotea que suban una bolsa deben estar sentadas o acostadas al hacerlo. + +Evite dejar caer objetos desde la azotea. Si monta equipo en el lateral de un edificio, trabaje en parejas, con una persona de apoyo sosteniendo el equipo físico mientras la otra usa una herramienta de fijación. + +Obtenga más información sobre las mejores prácticas de seguridad en azoteas en [este artículo](https://www.buildings.com/industry-news/article/10187943/best-practices-for-roof-safety) y en este [documento de OSHA](https://www.osha.gov/sites/default/files/publications/OSHA3755.pdf). + +## Escaleras + +PCW usa escaleras en la mayoría de nuestras instalaciones y visitas de mantenimiento. Tenemos tres tipos de escaleras: de tijera, telescópicas y extensibles plegables. + +Las escaleras telescópicas y las extensibles desplegadas deben colocarse con una proporción de 4 a 1, es decir, los pies de la escalera deben estar separados de la pared una distancia igual al 25 % de la altura total de la escalera. + + + +Quienes suban la escalera deben llevar zapatos con suela antideslizante. Solo una persona en la escalera a la vez. Una persona debe haber bajado y alejado de la escalera, a menos que la esté sujetando por seguridad, antes de que la siguiente persona la use. + +La forma más segura de subir una escalera es manteniendo tres puntos de contacto en todo momento. No haga movimientos bruscos ni rápidos. Los movimientos deben hacerse de un pie o una mano a la vez. El cuerpo de quien sube debe estar siempre de frente a la escalera. No se gire para darle la espalda a la escalera mientras esté en ella. + + + +Las escaleras no deben colocarse delante de puertas que puedan abrirse hacia la escalera. Si esto es necesario en algún momento, la puerta debe dejarse trabada abierta o vigilada por un miembro de PCW. + +Obtenga más información sobre las mejores prácticas de [seguridad con escaleras aquí](https://www.americanladderinstitute.org/page/BasicLadderSafety). + +## Taladros + +Los taladros son la única herramienta eléctrica que PCW usa en las instalaciones. Las herramientas eléctricas pueden ser inherentemente más riesgosas que otros tipos de herramientas, y deben tomarse en serio en todo momento. + +Mantenga la conciencia situacional. Las distracciones al taladrar o al estar cerca de un taladro encendido son una de las formas más fáciles de acabar en una lesión. + +Después de colocar una broca, pruebe la posición de la broca antes de usarla para hacer una perforación. Ponga el taladro en "avance" y apúntelo hacia el suelo, lejos de los demás, para comprobar que la broca gira correctamente y que no se tambalea ni "hace espiral". Los taladros deben mantenerse siempre en "neutro" cuando no se usan. + +Siempre revise y vuelva a revisar qué hay al otro lado de donde está taladrando. Asegúrese de usar la broca apropiada para el material. Consulte más información en la sección [Recomendaciones para taladrar en edificios](#recomendaciones-para-taladrar-en-edificios). + +Mantenga los taladros a baja velocidad y potencia cuando sea posible. Empiece bajo y aumente hasta llegar a la velocidad y el par necesarios. Retire el aserrín/los residuos de la perforación con regularidad. Durante o después del uso, deje que el taladro se enfríe antes de tocar una broca. + +Al usar el taladro en una escalera, suba primero la escalera y luego pida que alguien en el suelo le pase el taladro (cuando esa persona pueda alcanzarle/cuando su posición en la escalera esté al alcance de alguien en el suelo). + +Para obtener más información sobre cómo usar un taladro de forma segura, [vea este video de YouTube](https://www.youtube.com/watch?v=GGZ9zJkFOCg). + +### Recomendaciones para taladrar en edificios + +Las perforaciones en edificios, ya sea para pasar cables del interior al exterior o para montar cajas y brazos en J, son probablemente el punto en el que tenemos la mayor probabilidad de dañar un edificio. Taladre solo cuando sea necesario; busque siempre perforaciones y tendidos de cable preexistentes. + +#### Empiece con la mínima fuerza + +Empiece despacio y aumente gradualmente la velocidad/el par si no avanza. Puede añadir más fuerza ya sea a través del taladro o aplicando presión adicional desde atrás del taladro con la mano/el torso/el cuerpo. + +¿Cómo se ajustan la velocidad y el par en el taladro? Verá números e interruptores como estos en nuestros taladros inalámbricos Milwaukee: + +![Un taladro inalámbrico Milwaukee con el interruptor de velocidad trasero y el dial numerado del embrague resaltados en rojo.](../../../assets/images/installations/handbook/drill-speed-torque-controls.jpg) + +Estos dos controles regulan la velocidad y el par: + +- Velocidad (interruptor trasero): qué tan rápido gira el taladro. 1 es baja velocidad/alto par; 2 es alta velocidad/bajo par. +- Par (dial, técnicamente llamado "embrague"): cuánta fuerza se aplica. También controla el límite de par antes de que el taladro se detenga. + +#### Tenga en cuenta el material que está perforando + +Para agujeros pequeños y madera blanda, taladre rápido en lugar de despacio para evitar desgarrarlos. Para materiales duros y otros materiales blandos como plástico/cerámica/azulejos, taladre despacio para evitar la fricción, el calor y/o la vibración que destruyen el material. Ir despacio normalmente facilita que la perforación quede bonita/con bordes parejos. + +#### Taladre solo tan profundo como su tornillo o perno + +Hacer la perforación más larga que la longitud real del tornillo/perno deja un espacio vacío para el agua y la humedad. Puede rellenar un agujero con sellador y luego insertar/atornillar el tornillo, lo que rellenará los huecos del tornillo con sellador. Selle también bajo la cabeza del tornillo para evitar la entrada de humedad por la parte superior de la perforación. + +#### Elija la broca adecuada + +Las brocas para madera tienen una punta central afilada (punta de centrado) para un posicionamiento preciso, junto con espolones exteriores diseñados para cortar las fibras de la madera y lograr agujeros limpios y sin astillas. A veces también se les llama "broca de pala" (spade bit) porque se parecen a una pala. + +Las brocas para mampostería tienen una punta ancha y resistente de carburo de tungsteno que a menudo se parece a una punta de flecha. Al taladrar en concreto, lo más probable es que necesite hacer un agujero previo. Use la broca de mampostería adecuada (normalmente la broca Tapcon que corresponde al tornillo de mampostería que esté usando). Use el modo de percusión al hacer el agujero previo. Tenga en cuenta el tamaño/grosor de la broca: asegúrese de que coincida con el grosor del tornillo o sea ligeramente menor. + +#### Al taladrar en interiores + +Taladre cerca de los marcos de ventanas y puertas para mantenerse alejado de la climatización (HVAC), los cables eléctricos y cualquier tipo de tubería. También permite la distancia más corta al taladrar hasta el otro lado. + +Si no es ideal ni factible taladrar cerca de los marcos de ventanas y puertas, estas son algunas consideraciones: + +- Busque otras perforaciones o tendidos de cable para seguir una ruta similar. +- Revise qué hay a ambos lados de la zona para asegurarse de que esté despejada y para detectar posibles riesgos de causar daños. +- Piense en una ubicación que facilite el trabajo de PCW, para evitar ponernos en posiciones riesgosas. +- No taladre justo al lado de un tomacorriente o un cable eléctrico existente. +- Taladrar a través del piso solo debe considerarse si sabemos qué hay dentro del piso, o si podemos ver claramente por dónde se han pasado cables y otros elementos. Mida las distancias donde y cuando sea posible para asegurarse de que la perforación del piso coincida con lo esperado entre un piso y otro. diff --git a/docs/es/installations/handbook/risks-weather-environment.md b/docs/es/installations/handbook/risks-weather-environment.md deleted file mode 100644 index 829e78b..0000000 --- a/docs/es/installations/handbook/risks-weather-environment.md +++ /dev/null @@ -1 +0,0 @@ -# Riesgos climáticos y ambientales diff --git a/docs/es/installations/handbook/safety-basics.md b/docs/es/installations/handbook/safety-basics.md index c1c6cef..9ba8832 100644 --- a/docs/es/installations/handbook/safety-basics.md +++ b/docs/es/installations/handbook/safety-basics.md @@ -1 +1,71 @@ -# Seguridad básica + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../../installations/handbook/safety-basics/) es la referencia. + +# Fundamentos de seguridad + +Como organización apoyada por voluntarios, trabajamos con personas con distintos niveles de comodidad y experiencia. El personal de PCW se compromete a hacer todo lo posible para garantizar un entorno seguro para todos durante las instalaciones y el trabajo de mantenimiento. + +El personal de PCW es responsable de prepararse para la instalación o el mantenimiento, teniendo en cuenta los factores de riesgo del sitio de instalación y del entorno; de comunicar entre el personal los posibles riesgos antes de una visita de instalación, y reiterar esos riesgos a los participantes el día del trabajo; de mantener un liderazgo supervisor durante una instalación o visita de mantenimiento, y contar con políticas para gestionar los posibles desafíos; y de impartir lecciones integradas en la capacitación en el sitio (p. ej., "Usemos el taladro a baja velocidad aquí porque…" o "¿Quién va a sostener la escalera mientras los demás suben?"). + +Los voluntarios son responsables de mantenerse concentrados y en la tarea mientras están en el sitio. Los voluntarios también son responsables de comunicar necesidades, inquietudes y preguntas. Si un voluntario necesita tomar un descanso, atender una llamada, irse o apartarse por su cuenta de cualquier otra forma en cualquier momento durante una instalación o visita de mantenimiento, debe comunicarlo al personal de PCW. + +## Clima + +El mal tiempo o el clima extremo tienen un impacto directo en la seguridad del trabajo de PCW. Las instalaciones y el trabajo de mantenimiento se pospondrán si hay una alta probabilidad de mal tiempo, incluyendo calor extremo, lluvia, nieve, hielo, frío extremo, mala calidad del aire o niebla. + + + +Con calor, manténgase hidratado con agua y/o electrolitos, proteja la piel con protector solar y tome descansos en interiores o a la sombra. Reconozca los signos de exposición al calor, como mareos, náuseas, dolor de cabeza, confusión y respiración rápida y superficial. + +Con frío, proteja la piel con ropa de abrigo apropiada y tome descansos en interiores para entrar en calor. Camine con cuidado para evitar resbalones y caídas sobre el hielo; manténgase alejado de las zonas heladas cuando sea posible. Reconozca los signos de estrés por frío, como temblores incontrolables, habla arrastrada, movimientos torpes, fatiga y comportamiento confuso. + +Con viento, manténgase aún más lejos de los bordes de la azotea y mantenga distancia entre las personas. Guarde el equipo ligero dentro de una bolsa para que no se lo lleve el viento; no persiga objetos mientras esté en una azotea ni hacia la calle. Considere cancelar la instalación o el trabajo de mantenimiento si el viento está creando condiciones inseguras. + +Si empieza a llover, abandone de inmediato el trabajo en la azotea/al aire libre, y cancele la instalación o el trabajo de mantenimiento si es necesario. + +## Entorno + +Las instalaciones y el trabajo de mantenimiento de PCW se realizan en espacios comunitarios dentro de nuestra área de servicio, incluyendo viviendas particulares y sedes de organizaciones. Mantenerse atento y prudente respecto a las consideraciones de seguridad del entorno puede ayudarnos a reducir riesgos al trabajar en distintos vecindarios y lugares. + +Asegúrese siempre de mirar a ambos lados antes de cruzar una calle, incluso en una calle de un solo sentido. Nuestro trabajo nos lleva a subir escaleras y a entrar en espacios que a veces están desordenados. Fíjese bien dónde pisa para evitar tropezar en las escaleras o con objetos sueltos. + +Muévase en equipo o en parejas. El personal y los voluntarios de PCW no deben estar solos en la calle. Abandone de inmediato cualquier situación que sea incómoda o inapropiada. No hay motivo para dar su información personal, ni siquiera a los miembros de la comunidad de PCW, más allá de su nombre de pila. + +## Lista de verificación previa a la instalación o el mantenimiento + +Todos los participantes son responsables de traer: + +- Ropa/capas apropiadas para el clima +- Zapatos cerrados con suela antideslizante + +Además, el personal de PCW es responsable de empacar: + +- Botiquín de primeros auxilios +- Otro EPP: guantes, protección ocular y mascarillas +- Refrigerios y agua +- Protector solar + +## Transporte de equipo + +La mayor parte del equipo que PCW usa es ligero, y las bolsas deben empacarse de manera que ninguna sea especialmente pesada. Sin embargo, sí usamos escaleras grandes y, en ciertas instalaciones, bloques de concreto para lastrar nuestro soporte de techo no penetrante. Estas son algunas pautas para transportar equipo pesado y minimizar el riesgo de lesiones. + + + +Antes de levantar o cargar un objeto pesado o incómodo por su cuenta, pregúntese: ¿sería menos riesgoso hacerlo entre dos personas? ¿Hay otras formas de levantar, cargar o mover este objeto? (p. ej., usando una cuerda, un auto o una rampa). Antes de levantar, identifique también los puntos de agarre disponibles. Algunas cargas pueden no tener puntos de agarre adecuados; los guantes y/o cargar los objetos en equipo pueden reducir el riesgo de lesiones. + +Levantar objetos durante mucho tiempo o con alta frecuencia (de forma repetitiva) puede causar tensión o lesiones, incluso si la carga es ligera. Trabajar en equipo, rotar las tareas y tomar descansos regulares puede ayudar a reducir el riesgo de lesiones. Las temperaturas frías pueden reducir la flexibilidad muscular, mientras que las temperaturas altas pueden provocar deshidratación, fatiga y una mayor carga metabólica, y la poca visibilidad o la mala iluminación pueden aumentar la probabilidad de tropiezos o caídas. Tenga especial cuidado de tomar descansos y rotar las tareas de carga en condiciones climáticas más extremas. + +Use la "zona de potencia" para levantar: cerca del cuerpo, entre la mitad del muslo y la mitad del pecho. Esta es la zona en la que los brazos y la espalda pueden levantar más con el menor esfuerzo. Cuando sea posible, evite colocar objetos bajos o en el suelo. Levantar objetos desde una ubicación cercana a la altura de su torso es menos riesgoso que desde un ángulo bajo. + +Antes de levantar o cargar un objeto, evalúe cómo mantener la columna en posición neutra (es decir, sin torcerse ni estirarse) durante todo el levantamiento. Mantenga la carga simétrica (sujétela con ambas manos o, en el caso de una mochila, con las correas en ambos hombros) y cerca del cuerpo. Tenga cuidado con los objetos que pueden caerse de una bolsa al levantarla. Cierre las bolsas antes de levantarlas cuando sea posible. + +## Protocolo en caso de lesiones + +Siga el protocolo "Revisar, Llamar, Atender": + +1. Revise y evalúe la escena. Busque peligros antes de acercarse a una persona lesionada. Pregúntele "¿está bien?" y evalúe la gravedad de la lesión. +1. Llame a los servicios de emergencia (911) en caso de condiciones que pongan en peligro la vida. Llame a cualquier contacto de emergencia de la(s) persona(s) lesionada(s). Llame al Director Ejecutivo de PCW para informar del incidente (consulte las tarjetas de emergencia en la bolsa de herramientas para la información de contacto). +1. Atienda a la(s) persona(s). PCW tiene un botiquín de primeros auxilios en nuestra bolsa de herramientas. Mantenga a la persona lesionada quieta y cómoda; no la mueva a menos que esté en peligro inmediato. + +Una vez que la escena sea segura, documente el incidente por cualquier medio posible. Escriba notas sobre lo ocurrido con tantos datos como sea posible: dónde, cuándo, qué pasó (si se sabe), qué se dijo o se hizo, quién estuvo involucrado. Tome fotos cuando sea apropiado. diff --git a/docs/es/installations/handbook/safety-buildings-electrical.md b/docs/es/installations/handbook/safety-buildings-electrical.md index 21a9101..bf59565 100644 --- a/docs/es/installations/handbook/safety-buildings-electrical.md +++ b/docs/es/installations/handbook/safety-buildings-electrical.md @@ -1 +1,70 @@ + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../../installations/handbook/safety-buildings-electrical/) es la referencia. + # Seguridad en edificios y eléctrica + +## Notas sobre la infraestructura de Internet preinstalada + +PCW trabaja a menudo en entornos que ya cuentan con infraestructura de Internet preexistente. Al hacer nuestras instalaciones, podemos estar cerca de cableado/infraestructura de red/etc. existentes que podrían verse afectados o dañados por el trabajo de nuestra instalación. + + + +### Comercial + +En edificios comerciales que ya tienen Internet instalado, es posible que vea algo como esto: + +![Una caja de empalme de fibra óptica montada en una pared sobre un amplificador de línea gris, con cables coaxiales que salen de ella.](../../../assets/images/installations/handbook/fiber-enclosure-and-line-amplifier.jpg) + +Arriba se muestra una caja de fibra óptica, usada con un sistema híbrido de fibra y coaxial. La caja negra de arriba contiene la fibra del proveedor de fibra, y el amplificador de línea convierte las señales de fibra óptica (haces de luz) en señales eléctricas de radiofrecuencia que se transportan por cable coaxial hacia abajo. Probablemente estará conectada a algo como esto: + +![Una caja metálica abierta que contiene un derivador (tap) coaxial y divisores, con cables coaxiales etiquetados que salen hacia los abonados.](../../../assets/images/installations/handbook/coax-tap-and-splitter-box.jpg) + +Arriba se muestra un derivador (tap) coaxial y uno o varios divisores: es como un switch, pero para coaxial. Recibe su conexión de Internet de subida a través de los cables coaxiales grandes de abajo, y luego los dispositivos a los que está conectado cada cable coaxial etiquetado van a cada abonado individual. + +## Techos y techado + +Como principio rector, nunca taladramos en las partes del techo sobre las que podemos pararnos. + +El aspecto más importante de nuestro trabajo en techos es no permitir la entrada de humedad, que puede acumularse y dañar un edificio desde dentro hacia fuera sin ser visible hasta que aparece una gotera u otro daño. Aprender sobre la anatomía del techo puede ayudarnos a entender la mejor manera de montar nuestro equipo sin comprometer la integridad del techo. Obtenga más información sobre las partes del borde de un techo (tapajuntas, goterón, fascia, sofito) en [esta guía](https://roofs.wiki/Roof_Anatomy_and_Parts_Explained). + + +## Sistemas de seguridad/extinción de incendios + +Al trabajar en cuartos de telecomunicaciones o mecánicos, a menudo estamos muy cerca de alarmas y sistemas de extinción de incendios. En general, si un cable/conducto es de color rojo, es probable que esté relacionado con un sistema de extinción o una alarma de incendios, aunque no es una regla absoluta. + +### Espuma cortafuego (también llamada "Fireblock" o "Firestop") + +La espuma cortafuego suele instalarse sobre/dentro de los conductos para ayudar a evitar que el fuego se propague entre los pisos de un edificio. La espuma se expande y se endurece al exponerse a altas temperaturas, creando un sello. Para cumplir con la normativa, la espuma/el cortafuego debe formar un sello completo alrededor de la perforación. + +Generalmente se instala en los conductos así: cortafuego arriba, y luego aislamiento o lana mineral que también sirve de respaldo/relleno, mientras que el cortafuego es lo que impide la propagación real del humo y el fuego. + +![Espuma cortafuego naranja que sella la parte superior de un conducto metálico, con aislamiento amarillo visible en su interior.](../../../assets/images/installations/handbook/firestop-on-conduit.jpg) + +En esta imagen, el cortafuego es la espuma naranja en la parte superior del conducto; observe el aislamiento amarillo visible debajo, dentro del propio conducto. + +### Puertas cortafuego + +Nunca taladramos a través de las puertas cortafuego ni justo al lado de ellas, ya que esto viola su integridad cortafuego. + +## Electricidad + +Aunque PCW trabaja principalmente con cables y dispositivos de bajo voltaje (50 V o menos), a menudo estamos en entornos donde nos encontramos muy cerca de voltajes/amperajes más altos. + +### Tipos comunes de cable eléctrico + +Romex: la corriente en interiores suele transportarse por este cable plano no metálico (NM). El Romex tiene un código de colores según el calibre y el amperaje. Obtenga más información sobre el código de colores en [este boletín de NEMA](https://www.nema.org/docs/default-source/technical-document-library/type-nm-b-cable-jacket-color-coding-for-conductor-size-idenification.pdf). + + + +### El conducto y usted + +En exteriores, el cable eléctrico suele ir encerrado en algún tipo de conducto. A menudo vemos conducto flexible de PVC, o conducto recto de acero. + + + +### Cómo evitar interferencias de radiofrecuencia entre cables eléctricos + +Evite pasar cables de telecomunicaciones y eléctricos por las mismas perforaciones (mantenga al menos 2 pulgadas de separación). Si los cables de telecomunicaciones y eléctricos tienen que cruzarse, crúcelos en perpendicular para minimizar la interferencia (el único punto de contacto es donde se cruzan, en lugar de ir en paralelo). El Ethernet usa pares trenzados también para ayudar a lidiar con las interferencias. Usar cable apantallado (FTP) ayuda a reducir la interferencia aún más. + +Consulte también: [Códigos aplicables | Departamento de Licencias e Inspecciones | Ciudad de Filadelfia](https://www.phila.gov/departments/department-of-licenses-and-inspections/resources/applicable-codes/) diff --git a/docs/es/installations/hardware.md b/docs/es/installations/hardware.md index 733de62..37f780f 100644 --- a/docs/es/installations/hardware.md +++ b/docs/es/installations/hardware.md @@ -51,12 +51,12 @@ se puede montar en el sitio.
Dibujo lineal de un punto de acceso redondo para montar en el techo, visto de frente como un disco liso con un anillo interior estrecho. -
Redondo, de techo o pared
nanoHD, U6 Lite, U6+, U6 Pro, U7 Lite, U7 Pro
+
Redondo, de techo o pared
nanoHD, U6 Lite, U6+, U6 Pro, U7 Lite, U7 Pro
Dibujo lineal de un punto de acceso empotrado en la pared, una pequeña placa rectangular con un puerto Ethernet en su borde inferior. -
Placa empotrada en la pared
UAP-AC-IW, U7 In-Wall
+
Placa empotrada en la pared
UAP-AC-IW, U7 In-Wall
-- [Ubiquiti UAP-nanoHD](https://store.ui.com/us/en/products/uap-nanohd) -- [Ubiquiti UAP-AC-Inwall](https://store.ui.com/us/en/products/uap-ac-iw) -- [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6-extender) -- [Ubiquiti U6+](https://store.ui.com/us/en/products/u6-plus) -- [Ubiquiti U6 Lite](https://store.ui.com/us/en/products/u6-lite) -- [Ubiquiti U6 Pro - 'UFO AP' (AP "OVNI")](https://store.ui.com/us/en/category/wifi-flagship/products/u6-pro) -- [Ubiquiti U7 Lite](https://store.ui.com/us/en/products/u7-lite) -- [Ubiquiti U7 Pro](https://store.ui.com/us/en/products/u7-pro) -- [Ubiquiti U7 Pro Max](https://store.ui.com/us/en/products/u7-pro-max) -- [Ubiquiti U7 In-Wall](https://store.ui.com/us/en/products/u7-iw) -- [Ubiquiti U7 Long Range](https://store.ui.com/us/en/products/u7-lr) -- [Ubiquiti UAP-BeaconHD](https://store.ui.com/us/en/products/uap-beaconhd) +También se usan en interiores: [Ubiquiti U6 Extender](https://store.ui.com/us/en/products/u6-extender), [Ubiquiti U7 Pro Max](https://store.ui.com/us/en/products/u7-pro-max), [Ubiquiti U7 Long Range](https://store.ui.com/us/en/products/u7-lr). ### Conmutadores (switches) - [Ubiquiti USW Flex Mini](https://store.ui.com/us/en/products/usw-flex-mini) - [Ubiquiti USW Flex](https://store.ui.com/us/en/category/switching-utility/products/usw-flex) +- [Ubiquiti NanoSwitch](https://store.ui.com/us/en/products/n-sw) - un switch de exterior de cuatro puertos; tres de sus puertos suministran PoE pasivo de 24 V. Se usa de vez en cuando.
Puertos del USW Flex Mini. El puerto 1 recibe la entrada PoE (alimentación a través de Ethernet) y alimenta el switch, así que es el que va de regreso hacia el router.
+
+
+ Dibujo lineal de un Ubiquiti NanoSwitch, una carcasa plana y rectangular de esquinas redondeadas, con un punto de montaje redondo y una pequeña luz de estado. +
NanoSwitch
Carcasa para exteriores
+
+
+ Dibujo lineal de la cara de puertos del NanoSwitch, que muestra cuatro puertos Ethernet en fila, cada uno con una luz de estado verde y una roja. +
Puertos del NanoSwitch
+
+
+ ### Routers - [Ubiquiti EdgeRouter X](https://store.ui.com/collections/operator-edgemax-routers/products/edgerouter-x) - [Ubiquiti EdgePoint R6](https://store.ui.com/collections/operator-edgemax-control-points/products/edgepoint-r6) - consulte el [documento de NYC Mesh](https://wiki.nycmesh.net/books/3-hardware-firmware/page/ubiquiti-edgepoint-r6) (en inglés) sobre esta alternativa al ER-X. @@ -118,6 +121,11 @@ se puede montar en el sitio. - [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) + + ### Soportes - [Soporte universal de brazo en J (Universal J-Arm Mount)](https://store.ui.com/collections/operator-airmax-and-ltu-accessories/products/universal-antenna-mount) @@ -133,6 +141,12 @@ se puede montar en el sitio.
Un inyector PoE alimenta un AP a través de su cable Ethernet, así que el AP no necesita un tomacorriente propio.
+Identifique qué voltaje y potencia de PoE (alimentación a través de Ethernet) necesitará el equipo. Notas sobre el voltaje: + +- Los ERX (y, por extensión, las LiteBeam) son de 24 V +- Casi todos los puntos de acceso son de 48 V + - El UAP-AC-Mesh (conocido coloquialmente como "Bunny Ears", orejas de conejo) acepta 48 V o 24 V + - Cable(s) Ethernet de largo corto a mediano - Regleta(s) eléctrica(s) apta(s) para exteriores - Extensión(es) eléctrica(s) apta(s) para exteriores @@ -141,13 +155,13 @@ se puede montar en el sitio. - [Inyector/divisor PoE](https://www.newegg.com/p/2WG-00DK-00004) - [Adaptador/acoplador de Ethernet a Ethernet](https://www.newegg.com/p/0Y3-02J6-00001) - Conectores Ethernet (RJ45) de paso (*pass-through*) -- [Adaptador de USB tipo C a Ethernet](https://www.ebay.com/itm/132225990432?epid=910384900&hash=item1ec9487f20:g:FhgAAOSwqiVdyN) +- [Adaptador de USB tipo C a Ethernet](https://www.ebay.com/itm/132225990432) ## Herramientas ### Redes -- [Crimpadora (ponchadora) para cable Ethernet](https://www.homedepot.com/p/Klein-Tools-Compact-Ratcheting-Modular-Crimper-VDV226-107/204732347?source=shoppingads&locale=en-US&srsltid=AfmBOopOP-5p-ibEZ6Xg-9GSiYkxoTyprixZLrUXPKiSeqJMjNqTxc5oPwU) +- [Crimpadora (ponchadora) para cable Ethernet](https://www.homedepot.com/p/Klein-Tools-Compact-Ratcheting-Modular-Crimper-VDV226-107/204732347) - Pelacables para cable CAT5e - [Probador de cable Ethernet](https://www.lowes.com/pd/Klein-Tools-Cable-Tester-Kit-with-Scout-Pro-3-Tester-Remotes-Adapter-Battery/5014306081) - Hotspot móvil diff --git a/docs/es/installations/install-planning.md b/docs/es/installations/install-planning.md new file mode 100644 index 0000000..0c7bc45 --- /dev/null +++ b/docs/es/installations/install-planning.md @@ -0,0 +1,103 @@ + +!!! note "Traducción preliminar" + Esta página es una traducción preliminar y está pendiente de revisión. Si encuentra un error, la [versión en inglés](../../../installations/install-planning/) es la referencia. + +# Planificación de la instalación + +## Evaluación del edificio + +PCW instala WiFi con regularidad en una amplia variedad de tipos de edificios, como casas adosadas, edificios multifamiliares (MDU), centros comunitarios y espacios públicos como parques y jardines. + +Las evaluaciones suelen tomar entre 15 y 30 minutos. Asegúrese de tomar muchas fotos como referencia o para la planificación. + +Para evaluar un edificio para una instalación, tenemos que hacernos las siguientes preguntas: + +* **¿Tiene el edificio línea de vista (LoS) a un sitio alto de PhillyWisper o está cerca de un nodo de malla actual de PCW?** + * Sin LoS directa a un sitio alto o a un nodo existente, el rendimiento del radio de enlace ascendente se verá significativamente degradado (si es que logra conectarse). + * Google Earth puede ser una herramienta útil para determinar la posible LoS, pero en muchos casos puede ser necesaria una visita al sitio. + * El follaje de los árboles puede causar una interferencia significativa: los sitios que son viables en invierno pueden quedar bloqueados por el follaje en verano. + * Las construcciones nuevas también aparecen de repente. Es importante verificar las condiciones del lugar en persona, ya que Google maps, etc., puede no tener los alrededores más recientes actualizados. + +* **¿Tiene el edificio un acceso fácil, seguro y sencillo a la azotea o al último piso?** + * ¿Se necesitan escaleras? ¿Hay escaleras fijas o una escotilla de acceso a la azotea? + * Lo ideal es instalar las LiteBeam en la azotea, ya sea mediante una estructura preexistente de la azotea, un soporte J-arm en la pared o un soporte de techo no penetrante. + * ¿Tenemos permiso para montar equipos en el edificio o en las estructuras de la azotea? + * PCW solo instala en techos planos, con raras excepciones. + +* **¿Hay acceso a electricidad?** + * Si está en el exterior, ¿está protegida la fuente de alimentación? + * ¿La fuente de alimentación tendrá que ser usada por otra cosa? ¿Es accesible para otras personas que podrían desenchufar nuestro equipo? + * ¿Hay perforaciones preexistentes que podamos reutilizar para llevar alimentación power-over-Ethernet desde el interior? + * PCW no perfora techos, ya que son demasiado difíciles de impermeabilizar. + +* **¿Hay formas fáciles de montar los puntos de acceso?** + * p. ej.: postes existentes a los que simplemente podríamos sujetar los AP con bridas, frente a traer un soporte de techo no penetrante o un J-arm. + * ¿Cuánto cable tendremos que tender? + * ¿Qué tipo de puntos de acceso serán necesarios? Algunos no son resistentes a la intemperie y solo pueden usarse en interiores. + * ¿Existe la posibilidad de que montar los puntos de acceso dañe el techo o las paredes? + * ¿Hay infraestructura de Internet preexistente (instalaciones anteriores de cable coaxial o fibra) que debamos tener en cuenta? Los cables que corren en paralelo pueden interferir entre sí, degradando el rendimiento de ambas conexiones. + +* **Si se requiere mantenimiento, ¿podremos volver en el futuro?** + +Estas son algunas consideraciones al pensar en electricidad exterior frente a interior: + +* PCW prefiere usar electricidad interior cuando es posible, especialmente en viviendas residenciales. Usar electricidad exterior crea un mayor riesgo de problemas relacionados con el agua en nuestro equipo. +* Usar electricidad interior nos obliga a tender cable hacia el interior de un edificio. En la mayoría de los casos en que usamos electricidad exterior, es porque el tendido de cable en el interior es significativamente más complicado. +* Si hay electricidad exterior existente que esperamos usar, es importante determinar si está disponible para nuestro uso o si se necesita para otros equipos exteriores. +* Toda fuente de electricidad exterior que se considere debe tener una tapa de tomacorriente apta para exteriores. + +Como ejemplo, este es un sitio de instalación ideal: + +
+ Un lugar ideal para una instalación en azotea +
Un lugar ideal para una instalación en azotea en Kensington
+
+ +* La azotea está libre de escombros y es plana, con mucho espacio para soportes de techo no penetrantes. +* El edificio es más alto que casi todos los demás edificios de la zona, lo que le da LoS libre tanto a los sitios altos de PhillyWisper como a otros posibles sitios PtP/PtMP. +* Hay electricidad en la azotea, en este caso tomacorrientes GFCI con tapa. + +## Ubicación de los puntos de acceso + +Dónde va un punto de acceso importa tanto como cuál es el punto de acceso. Esta página explica cómo PCW +decide dónde colocar los AP: la diferencia entre un hub y un nodo, y qué tener en cuenta cuando un +nodo se enlaza en malla de forma inalámbrica en lugar de estar conectado por cable. + +### Hubs y nodos + +Los nodos de malla son instalaciones en las que no usamos una Litebeam, sino que configuramos un punto de acceso +inalámbrico que se enlaza en malla desde un punto de acceso cercano conectado por cable a un router y a una Litebeam en un hub local. + +Si un sitio puede ser un hub se decide durante la [evaluación del edificio](#evaluacion-del-edificio): +un hub necesita línea de vista a un sitio alto de PhillyWisper. Un nodo no, pero sí necesita un buen +enlace inalámbrico de regreso a un hub, que es de lo que trata el resto de esta página. + +Consulte también la página de [instalaciones típicas](https://wiki.nycmesh.net/books/2-install-maintenance-guides/page/typical-installs) de NYC Mesh para ver cómo una red similar describe sus tipos de instalación. + + + +### Consideraciones al instalar un nodo de malla + +El artículo de Ubiquiti [Considerations for Optimal Wireless Mesh Networks](https://help.ui.com/hc/en-us/articles/115002262328-Considerations-for-Optimal-Wireless-Mesh-Networks) +es la referencia con la que trabajamos. Los puntos que surgen con más frecuencia en las instalaciones de PCW: + +* **Las redes de malla deben ser complementarias**: aunque las redes de malla pueden funcionar de forma comparable a una red cableada, la calidad y la velocidad de la conexión pueden verse muy afectadas por el ruido de radiofrecuencia (RF) y por obstrucciones entre los AP, como paredes, árboles u otras estructuras. +* **Los "saltos" de malla deben minimizarse**: un AP en malla solo debe tener un "padre"; cada "salto" de malla, o conexión de malla entre AP, produce una disminución significativa del rendimiento. Lo ideal es que haya un máximo de dos "saltos"; p. ej., un AP de malla se enlaza con otro AP de malla, que a su vez se enlaza con un AP cableado. +* **Limite las conexiones simultáneas a un "padre"**: de igual modo, enlazar demasiados AP al mismo "padre" crea ruido de RF adicional y mayores exigencias de rendimiento para el padre, lo que se traduce en menor rendimiento y estabilidad. +* **Asegure una intensidad de señal fuerte entre los AP en malla**: lo ideal es que un AP en malla tenga línea de vista (LoS) despejada a su padre de malla. Se recomienda una intensidad de señal de -60 dBm para un rendimiento ideal. Asegúrese de que haya la menor cantidad posible de obstrucciones entre el AP en malla y el padre, como paredes, árboles, muebles, etc. + +### Ubicación en exteriores + +Los AP exteriores deben montarse donde sean visibles por radio para los AP de malla de las instalaciones domésticas +dentro del alcance, y lo bastante altos para superar lo que tengan alrededor. En los [nodos solares](solar.md), eso normalmente +significa que el AP va en la parte superior del mástil, con el panel y la caja montados debajo. + +Para saber cómo configurar un AP una vez ubicado, consulte la guía +[Configurar los AP Unifi](../device-configuration/configure-ap-mesh.md). diff --git a/docs/es/installations/installations.md b/docs/es/installations/installations.md index 82b791b..1eee56d 100644 --- a/docs/es/installations/installations.md +++ b/docs/es/installations/installations.md @@ -16,9 +16,9 @@ Philly Community Wireless busca construir tecnologías de redes de malla inalám La mayoría de las instalaciones se realizan en el siguiente orden: -1. **Evaluación del edificio**: recibimos una nueva dirección. Verificamos si la dirección tiene [línea de visión (LoS)](https://en.wikipedia.org/wiki/Line-of-sight_propagation) con un sitio alto de PhillyWisper usando Google Earth y otras herramientas de mapas, y hacemos evaluaciones del edificio tanto a distancia como en persona para elaborar un plan de instalación. Para obtener más información, consulte la página [Evaluación del edificio](buildingassessment.md). +1. **Evaluación del edificio**: recibimos una nueva dirección. Verificamos si la dirección tiene [línea de visión (LoS)](https://en.wikipedia.org/wiki/Line-of-sight_propagation) con un sitio alto de PhillyWisper usando Google Earth y otras herramientas de mapas, y hacemos evaluaciones del edificio tanto a distancia como en persona para elaborar un plan de instalación. Para obtener más información, consulte la página [Planificación de la instalación](install-planning.md). 2. **Planificación de la instalación**: si hay LoS, nos comunicamos con el residente o la organización comunitaria para conocer sus necesidades de conectividad, así como las de sus vecinos y de la zona en general. Esto nos ayuda a decidir qué tipo de puntos de acceso y equipos de red llevar, y cuánto cable vamos a necesitar. Una vez definida la logística de la instalación inicial, ¡se fija la fecha de instalación! -3. **Establecer el enlace ascendente**: el día de la instalación, PCW comienza instalando la radio de enlace ascendente (uplink), por lo general una [LiteBeam](https://store.ui.com/us/en/products/litebeam-5ac), apuntada hacia un sitio alto de PhillyWisper. Esta radio proporciona la conexión a Internet. +3. **Establecer el enlace ascendente**: el día de la instalación, PhillyWisper comienza instalando la radio de enlace ascendente (uplink), por lo general una [LiteBeam](https://store.ui.com/us/en/products/litebeam-5ac), apuntada hacia un sitio alto de PhillyWisper. Esta radio proporciona la conexión a Internet. 4. **Instalar los puntos de acceso**: una vez establecido el enlace ascendente, podemos empezar a tender cable por el techo o por dentro del edificio e instalar puntos de acceso wifi según se necesiten, ya sea en interiores o en exteriores. En las instalaciones residenciales, o bien transmitimos una red privada para el residente desde los mismos puntos de acceso que transmiten la red pública de PCW, o bien le proporcionamos un router adicional para que tenga su propia red privada, que obtiene su enlace ascendente de la red de PCW. @@ -47,9 +47,9 @@ Por lo general, las instalaciones tardan entre dos y cuatro horas, pero en algun Por lo general, una instalación de Internet consiste en una antena en la azotea, un inyector PoE (alimentación a través de Ethernet), un router y un punto de acceso wifi (normalmente, todos son equipos de red Ubiquiti). Durante la instalación, PhillyWisper y Philly Community Wireless hacen todo lo posible por afectar los edificios lo menos posible. En cada lugar, adaptamos nuestro trabajo de instalación para que la colocación de los equipos de red sea lo menos invasiva y lo más segura posible, de acuerdo con los estándares de la industria. -En la mayoría de los lugares, primero instalamos una antena de radio Ubiquiti LiteBeam en el techo de la casa, que recibe la señal de un sitio alto cercano administrado por PhillyWisper. Para instalar la antena en la azotea, los técnicos de PhillyWisper suben a un punto alto y montan la pequeña antena de radio (vea más abajo las imágenes de distintas técnicas de montaje), que apuntan con precisión hacia la torre más cercana. Al montar la antena nunca perforamos el sistema de techado y, siempre que es posible, aprovechamos estructuras existentes (chimeneas, tubos de ventilación, etc.). Si no es posible usar estructuras existentes, utilizamos un soporte de techo no penetrante, que lleva el lastre adecuado y descansa sobre una alfombrilla de goma encima de su techo. +En la mayoría de los lugares, primero instalamos una antena de radio Ubiquiti LiteBeam en el techo de la casa, que recibe la señal de un sitio alto cercano administrado por PhillyWisper. Para instalar la antena en la azotea, los técnicos de PhillyWisper suben a un punto alto y montan la pequeña antena de radio (vea más abajo las imágenes de distintas técnicas de montaje), que apuntan con precisión hacia la torre más cercana. Al montar la antena nunca perforamos el sistema de techado y, siempre que es posible, aprovechamos estructuras existentes (chimeneas, tubos de ventilación, etc.). Si no es posible usar estructuras existentes, utilizamos un soporte de techo no penetrante. -La radio de la azotea se alimenta con un cable Ethernet apto para exteriores que baja por la fachada del edificio y entra en la casa (nuestros equipos usan PoE, así que podemos alimentar los dispositivos de exterior por Ethernet desde un tomacorriente interior). Nos aseguramos de que el recorrido del cable sea lo más discreto posible y de que el cable quede bien tensado para que no se sacuda con el viento. Si hay perforaciones existentes por donde entraban al edificio los cables de proveedores de Internet (ISP) anteriores, se usarán si es posible y se sellarán con masilla al terminar. +La radio de la azotea se alimenta con un cable Ethernet apto para exteriores que baja por la fachada del edificio y entra en la casa. Nos aseguramos de que el recorrido del cable sea lo más discreto posible y de que el cable quede bien tensado para que no se sacuda con el viento. Si hay perforaciones existentes por donde entraban al edificio los cables de proveedores de Internet (ISP) anteriores, se usarán si es posible y se sellarán con masilla al terminar. ## Ejemplos de instalación @@ -99,7 +99,7 @@ El cable Ethernet alimentado se conecta a un Ubiquiti EdgeRouter-X (o posiblemen
Ubiquiti EdgeRouterX
-Por último, un AP de malla Ubiquiti (las "orejas de conejo"; ¡mírelo y verá por qué!) se conecta al router y permite que los dispositivos dentro del alcance de su señal de radio se conecten a la red. Las orejas de conejo deben instalarse en un lugar con visibilidad de radio hacia los APs de malla de las instalaciones domésticas que estén a su alcance. +Por último, un AP de malla Ubiquiti (las "orejas de conejo"; ¡mírelo y verá por qué!) se conecta al router y permite que los dispositivos dentro del alcance de su señal de radio se conecten a la red.
- El nodo solar de malla completo en Colobo Gardens: el punto de acceso en lo alto del mástil de bambú, con el panel solar montado en el techo debajo
El nodo solar de malla completo en Colobo Gardens: el punto de acceso en lo alto del mástil de bambú, con el panel solar montado en el techo debajo
- El panel solar en su soporte inclinado en el borde del techo, con el cableado que baja hasta la caja
El panel solar en su soporte inclinado en el borde del techo, con el cableado que baja hasta la caja
@@ -43,7 +43,7 @@ En 2021, PCW instaló un nodo solar de malla en Colobo Gardens, de Norris Square La caja resistente a la intemperie contiene todo lo que no es el panel ni el punto de acceso: la batería, el controlador de carga y el inyector PoE (alimentación a través de Ethernet), que lleva la alimentación hasta el AP a través de un solo cable Ethernet.
- La caja abierta, con la batería, el controlador de carga y el inyector PoE rotulados
El interior de la caja en Colobo Gardens
diff --git a/docs/es/resources.md b/docs/es/resources.md index 7f6682f..9627a3d 100644 --- a/docs/es/resources.md +++ b/docs/es/resources.md @@ -1,6 +1,5 @@ --- title: Recursos - --- @@ -33,10 +32,6 @@ title: Recursos [Portable Network Kit Setup Guide](https://www.communitytechny.org/portable-network-kits), Community Tech NY -[Wireless Networking in the Developing World](http://wndw.net). 3.ª edición. Copenhague, 2013. - -[The Community Network Manual: How to Build the Internet Yourself](https://bibliotecadigital.fgv.br/dspace/handle/10438/25696) - [Meshnet DWeb Camp 2019](https://dweb-camp-2019.github.io/meshnet/) ## Modelos de política y organización @@ -73,6 +68,6 @@ Sanchez, Alvaro. “[Toward Digital Inclusion: Broadband Access in the Third Fed Shaffer, Gwen. “[Common Sense: An Examination of Three Los Angeles Community WiFi Projects That Privileged Public Funding Over Commons-Based Infrastructure Management](https://doi.org/10.2139/ssrn.2941920).” Rochester, NY: Social Science Research Network, March 28, 2017. -Solomon, Rory. [_Meshiness: Mesh Networks and the Politics of Connectivity_](http://search.proquest.com/pqdtglobal/docview/2408892960/abstract/479AB38D8B044610PQ/1)_._ Ph.D., New York University, 2020. +Solomon, Rory. [_Meshiness: Mesh Networks and the Politics of Connectivity_](http://search.proquest.com/pqdtglobal/docview/2408892960/abstract/479AB38D8B044610PQ/1). Ph.D., New York University, 2020. Thakur, Dhanaraj, and Teddy Woodhouse. “[Meaningful Connectivity: A New Standard to Raise the Bar for Internet Access](https://web.archive.org/web/20260220230151/https://a4ai.org/meaningful-connectivity/).” Alliance for Affordable Internet, 2020. diff --git a/includes/abbreviations.es.md b/includes/abbreviations.es.md index 6dfb6ab..9bbe832 100644 --- a/includes/abbreviations.es.md +++ b/includes/abbreviations.es.md @@ -2,7 +2,7 @@ *[NPRM]: Soporte de techo no penetrante — un soporte con lastre que nos permite instalar sin perforar el techo. *[Non-Pen]: Soporte de techo no penetrante — un soporte con lastre que nos permite instalar sin perforar el techo. *[PoE]: Alimentación a través de Ethernet — enviar energía eléctrica junto con los datos por un cable Ethernet, para que un dispositivo exterior no necesite su propio tomacorriente. -*[ERX]: EdgeRouter X — el router de Ubiquiti que PCW usa como switch, para mover datos entre dispositivos. +*[ERX]: EdgeRouter X — el router de Ubiquiti que PCW usa. *[PtP]: Punto a punto — un enlace entre exactamente dos nodos que se comunican directamente. *[PtMP]: Punto a multipunto — un punto de acceso central que da servicio a varias estaciones remotas. *[AP]: Punto de acceso — un dispositivo inalámbrico que sirve de portal para que otros dispositivos se unan a la red. diff --git a/includes/abbreviations.md b/includes/abbreviations.md index 1ae4ed1..07831b8 100644 --- a/includes/abbreviations.md +++ b/includes/abbreviations.md @@ -2,7 +2,7 @@ *[NPRM]: Non-penetrating roof mount — a ballasted mount that lets us install without drilling into a roof. *[Non-Pen]: Non-penetrating roof mount — a ballasted mount that lets us install without drilling into a roof. *[PoE]: Power over Ethernet — passing electric power along with data on an Ethernet cable, so an outdoor device needs no outlet of its own. -*[ERX]: EdgeRouter X — the Ubiquiti router PCW uses as a switch, moving data between devices. +*[ERX]: EdgeRouter X — the Ubiquiti router PCW uses. *[PtP]: Point-to-point — a link between exactly two nodes communicating directly with each other. *[PtMP]: Point-to-multi-point — one central access point serving multiple remote stations. *[AP]: Access point — a wireless device that acts as a portal for other devices to join the network. diff --git a/mkdocs.dev.yml b/mkdocs.dev.yml index e36b3e5..a1165b5 100644 --- a/mkdocs.dev.yml +++ b/mkdocs.dev.yml @@ -12,19 +12,15 @@ nav: - For Volunteers: - Installations: - - Overview: installations/handbook/overview.md - - Install Phases Overview: installations/handbook/phases-overview.md - - Assessment & Planning: installations/handbook/assessment-planning.md - - Building Assessments: installations/buildingassessment.md - - Access Point Placement: installations/ap-placement.md - - Hardware: installations/hardware.md - - Etiquette On Site: installations/handbook/etiquette.md - - Install Day & Maintenance: installations/handbook/install-day-and-maintenance.md + - Guiding Principles: installations/handbook/overview.md - Safety: - Safety Basics: installations/handbook/safety-basics.md - - Building & Electrical Safety: installations/handbook/safety-buildings-electrical.md - Rooftop, Ladder & Drill Safety: installations/handbook/risks-rooftop-ladder-drill.md - - Weather & Environmental Risks: installations/handbook/risks-weather-environment.md + - Building & Electrical Safety: installations/handbook/safety-buildings-electrical.md + - Install Planning: installations/install-planning.md + - Hardware and Cabling: + - Hardware: installations/hardware.md + - Cabling and Mounting: installations/cabling-and-mounting.md - Wireless: - Fixed Wireless: wireless/fixed-wireless.md - WiFi: wireless/wifi.md diff --git a/mkdocs.yml b/mkdocs.yml index 0ce501a..5a0ffc2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -42,15 +42,6 @@ draft_docs: | /*/device-configuration/unpoller.md /*/device-configuration/useful-software.md /*/device-configuration/wireless-settings.md - /*/installations/handbook/assessment-planning.md - /*/installations/handbook/etiquette.md - /*/installations/handbook/install-day-and-maintenance.md - /*/installations/handbook/overview.md - /*/installations/handbook/phases-overview.md - /*/installations/handbook/risks-rooftop-ladder-drill.md - /*/installations/handbook/risks-weather-environment.md - /*/installations/handbook/safety-basics.md - /*/installations/handbook/safety-buildings-electrical.md /*/software-infrastructure/overview.md /*/wireless/fixed-wireless.md /*/wireless/wifi.md @@ -77,16 +68,21 @@ plugins: For Volunteers: Para voluntarios For network users: Para usuarios de la red Installations: Instalaciones + Guiding Principles: Principios rectores + Safety: Seguridad + Safety Basics: Fundamentos de seguridad + "Rooftop, Ladder & Drill Safety": Seguridad en azoteas, escaleras y taladros + Building & Electrical Safety: Seguridad en edificios y eléctrica + Install Planning: Planificación de la instalación + Hardware and Cabling: Hardware y cableado + Cabling and Mounting: Cableado y montaje Installation Overview: Descripción general de la instalación - Building Assessment: Evaluación del edificio - Building Assessments: Evaluación del edificio Configure routers running EdgeOS: Configurar routers con EdgeOS Manual configuration: Configuración manual Troubleshoot Unifi Devices: Solución de problemas de dispositivos Unifi Hardware: Hardware Solar: Solar Solar Mesh Nodes: Nodos solares de malla - Access Point Placement: Ubicación de los puntos de acceso Green Technology Resources: Recursos de tecnología verde Networking and Device Configuration: Redes y configuración de dispositivos Set a Static IP Address: Configurar una IP estática @@ -100,15 +96,6 @@ plugins: Further reading: Lecturas adicionales # Labels only in mkdocs.dev.yml's nav, for draft pages. Overview: Descripción general - Install Phases Overview: Fases de instalación - Assessment & Planning: Evaluación y planificación - Etiquette On Site: Normas de conducta en el sitio - Install Day & Maintenance: Día de instalación y mantenimiento - Safety: Seguridad - Safety Basics: Seguridad básica - Building & Electrical Safety: Seguridad en edificios y eléctrica - "Rooftop, Ladder & Drill Safety": Seguridad en azoteas, escaleras y taladros - Weather & Environmental Risks: Riesgos climáticos y ambientales Wireless: Inalámbrico Fixed Wireless: Inalámbrico fijo WiFi: Wifi @@ -128,9 +115,15 @@ nav: - For Volunteers: - Installations: - - Building Assessments: installations/buildingassessment.md - - Access Point Placement: installations/ap-placement.md - - Hardware: installations/hardware.md + - Guiding Principles: installations/handbook/overview.md + - Safety: + - Safety Basics: installations/handbook/safety-basics.md + - Rooftop, Ladder & Drill Safety: installations/handbook/risks-rooftop-ladder-drill.md + - Building & Electrical Safety: installations/handbook/safety-buildings-electrical.md + - Install Planning: installations/install-planning.md + - Hardware and Cabling: + - Hardware: installations/hardware.md + - Cabling and Mounting: installations/cabling-and-mounting.md - Networking and Device Configuration: - Set a Static IP Address: device-configuration/configure-computer.md - Configure routers running EdgeOS: