Inicio>Hardware

Configurar tu red Square Ubiquiti UniFi

Antes de comenzar

Esta guía de configuración está destinada a los comercios de Square que compraron el equipo recomendado de Ubiquiti Networking de Square (o de otro lugar) y desean configurar una red de tiendas que satisfaga las necesidades de su negocio y garantizar que el hardware y los servicios de Square funcionen sin problemas en esa red.

Important Note: Setting up and then maintaining a robust network for your store requires upfront time and some amount of maintenance over the course of expanding your business. Square recommends that you dedicate at least two hours to complete the steps in this guide. For more complex setups with many Access Points and hardwired equipment, you may need to dedicate at least a day, if not more, to build out a robust network. If this complexity feels overwhelming, we highly recommend hiring an IT professional who can help you follow the recommended setup in this guide.

Según el hardware que hayas comprado, es probable que tengas una combinación de los siguientes equipos que deberán instalarse, conectarse entre sí y configurarse con los ajustes correctos.

Hardware Options

Type Description Base option High-end option
Router Routers disperse the signal to devices on the network. In a typical network setup, the modem is connected to the router. UCG Cloud Gateway Ultra UCG Cloud Gateway Ultra Dream Machine SE Dream Machine SE
Switch Used to connect devices together on a network. The network switch acts as a wired extension point, and connects to the router, or other switches. USW Lite 16 PoE USW Lite 16 PoE USW Pro 24 PoE USW Pro 24 PoE
Access point Transmits and receives data over a wireless local area network (WLAN), Simply put: they allow your devices (POS, laptops, tablets, etc) to connect to Wi-Fi. UniFi U6+ Mesh UniFi U6+ for indoor use and UniFi U6 Mesh for outdoor use  
Other   Ethernet RJ45 Cable Ethernet RJ45 Cable (6ft) and Ethernet RJ45 Cable (10ft)  

Paso 1: Configura la tienda

Antes de comenzar a configurar tu equipo Ubiquiti, deberás asegurarte de haber seguido los siguientes pasos.

Ensure your Internet Service and Modem are properly installed

You’ll want to work with your ISP (Internet Service Provider) to ensure you have a reliable connection and the right modem equipment for your needs.

Having persistent and reliable connection(s) to the internet is key to a stable network. Before you set up your network and hardware, please ensure that the quality and speed of your internet connection is sufficient. For Square to work well, a minimum internet speed of 25Mbps down and 3Mbps up is required. Broadband speeds (100Mbps down and 20Mbps up) are preferred, as higher speeds may be required depending on the number of connected devices, building size and complexity of your network.

Ensure you have a space identified for your modem, router and switches

Network equipment is best set up when in a dedicated space, away from high traffic areas of your store. More advanced or larger stores will have a dedicated networking closet or office. Smaller stores should still try to identify a discrete area where these devices can be placed together. Regardless of where you place this equipment, it is important that it is in an easily accessible area which is climate controlled or well ventilated. Furthermore, if you have a number of Ethernet cables connecting various parts of the system, we recommend clean cable routing with well marked tagging.

Ensure you have Ethernet runs and mounting points installed for Wi-Fi access points

Ubiquiti access points generally require a dedicated Ethernet connection between your router or switch, and a position in your store where they can provide the best Wi-Fi coverage. Use the information below to help determine where you will place your Access Points. Square recommends working with a certified electrician or IT provider to help you install Ethernet runs once your final layout has been determined.

The required number of wireless access points needed for your business will depend on your square footage, layout and building materials. The advertised coverage area for Square’s recommended access point UniFi U6+ is 1,000 sq. ft., assuming a square or rectangular single-floor area with drywall. If your area has a more complex shape (L or H shape) or features a brick/concrete wall, you will need to increase the number of access points accordingly to improve coverage and signal strength.

Review tips on how to place your access points

  • Wireless access points require an Ethernet cable (Cat5e or better) connected to the main network router, but may be connected via a network switch if the main network router ports are all in use.
  • Recommended UniFi Access Points can be connected directly to the network switch with PoE (Power over Ethernet) ports like the Switch Lite 16 PoE or Switch Pro 24 PoE. Depending on your setup, you may require a PoE injector (included with our recommended outdoor access points U6 Mesh, or can be purchased separately here).

  • Install indoor wireless access points to maximize coverage. For open layouts, this means on the ceiling and in the center of the room, but wall-mounted access points can be appropriate when mounted against an outside wall facing inward. The antenna is located on the top of the wireless area and should always remain both unobstructed and away from other sources of radio frequency such as TVs, microwave ovens, espresso grinders, speakers, cameras, lights and more.

  • If you are unsure on the exact number or location of access points you need, you can roughly plan for:

  • One access point for each large room in your store, up to 1,000 sq. ft. coverage.

  • At least 35 feet in between each access point, to avoid over saturating your network.

  • More, rather than less, access points if you have a very busy environment with many POS devices, store devices, and guest devices.


Paso 2: Configura la puerta de enlace Ubiquiti (enrutador)

La mejor manera de configurar el hardware de Ubiquiti es a través de la aplicación móvil UniFi. Esto se puede descargar en Apple App Store o Google Play Store.

Además de la aplicación UniFi, Square también recomienda descargar la Ubiquiti WiFiman app como una excelente herramienta de prueba. La herramienta está disponible en las plataformas iOS y Android. Esta prueba se cubrirá al final de esta guía.

Esta guía asume que estás configurando una nueva red UniFi en una ubicación (sitio). Si ya tienes una red UniFi existente o estás implementando una nueva red en una nueva ubicación, asegúrate de configurar correctamente el sitio correcto en la aplicación UniFi antes de comenzar los siguientes pasos.

Step 1: Set up your Gateway

Start setting up your Gateway by plugging it into power, and plugging an Ethernet cable from your ISP modem into the WAN port on the gateway.

Step 2: Download the Unifi app

Download the Unifi app from Apple app store or Google play store. Create an account and log After creating an account and logging into the UniFi app.

Step 3: Setup new devices

Navigate to the Devices tab, where you will see a “New Device Found” pop up. Press the “Setup” button to begin the setup process. The app will then connect to the gateway, which may take a few minutes.

Step 4: Name your Gateway

Once connected, you will be prompted to name your gateway. In the example below, we are using the Cloud Gateway Ultra router.

2.1 2.2 2.3

Step 5: Complete Setup

Once the gateway is connected, you will be asked to verify your email. You will also have the option to restore from a backup. For new installations, you can skip this step and click “Next” The app will then confirm internet connectivity and perform a speed test. After this, it will proceed to install and update the UniFi OS until the “Setup Complete!” page is loaded.

2.4 2.5

Paso 3: Conecta y adopta otro equipo Ubiquiti (interruptores, puntos de acceso, etc.)

Connect your equipment

You’ll need to hardwire your UniFi Gateway directly to your switch and access points using Ethernet cables. Ubiquiti switches will need to be plugged into wall power and ideally placed nearby your gateway. If you are using a gateway which supports Power over Ethernet (PoE), like the Dream Machine Special Edition, you should plug the APs directly into the gateway, if you are using the Cloud Gateway Ultra you will need to plug the APs into your PoE-enabled switch or use optional PoE Injectors.

Note: Ubiquiti access points are powered using ‘Power over Ethernet’ (PoE). If you purchased a networking kit directly from Square, you should have either a gateway and/or a switch which has specific ports which support PoE. You’ll need to ensure your APs are plugged into these special ports.

More advanced setups may use PoE injectors, which is an extra device which can allow you to plug the AP directly into wall power, as well as an ethernet cable which is connected to your other Ubiquiti equipment. The U6 Mesh AP includes a PoE injector in the box, the U6+ AP does not but one can be purchased separately. If you are using PoE injectors in your setup, we still recommend hardwiring ethernet cables into the network, Square does not recommend setting up ‘mesh’ networks.

Add switches and access points

Once all your equipment is connected and powered on, reopen the UniFi app. Adoption is how the Unifi app adds switches and access points into your network. In the UniFi devices section, adopt any access points or resolve issues with switches. The menu options may vary depending on the type of device. To adopt a device, simply click on the device with the “Pending Adoption” orange box. This will start the adoption process automatically.

3.1 3.2

Once the adoption process is complete, you will see the devices listed in the devices section. Please note that the adoption process can take a few minutes and may require the devices to reboot automatically.

3.3

Paso 4: Configura tus redes - Configuración avanzada (opcional)

NOTA IMPORTANTE: Las instrucciones de este paso te guiarán a través de la creación de redes aisladas (VLAN) que garantizarán que tus dispositivos y accesorios de PDV Square estén en una red dedicada sin conflictos con otros dispositivos que puedan estar conectados a tu red. Si bien esto se recomienda para obtener la mejor experiencia de Square, la gestión de las VLAN es relativamente complicada de configurar y mantener a lo largo del tiempo. Recomendamos encarecidamente que los restaurantes que dependen de la impresión en red para las operaciones sigan los pasos de esta sección. Si no logras completar los pasos de esta sección, puedes saltar al Paso 5: Configurar la wifi.

Square aconseja crear hasta tres redes distintas. Square y otros dispositivos PDV deben estar en una red privada que esté protegida y separada de otros dispositivos.

How to modify a network

To modify and create networks, navigate to the “settings” tab at the bottom left of the app, and select Networks.

4.1 4.2

Network Template

The following Networks can be used as a template. The rest of this section will walk through how to build these networks for your store. For reference, “store” is a placeholder for the actual store name.

Network Name Description Wi-Fi Name (SSID) VLAN
Default Employee devices, security cameras, and other devices that are not Square/POS related. Store Operations Default (VLAN ID 1)
Store-Square Square devices, and peripherals like printers used with your point of sale. Store Square VLAN ID 2
Store-Guest (optional) Guest users, customers devices Store Guest VLAN ID 3

Default Network (Aka Store-Operations)

Modify the default network, select the “Default” network and scroll down and select the “IPv4’’ (you can ignore IPv6 and keep it disabled) option to “Manual” Change the following parameters and then “save” settings.

If settings are not specified, they should be left at their default values.

Parameter Required Value
Network Name Default
Isolate Network Toggle to “On”
IGMP Snooping Toggle to “On”
Multicast DNS Toggle to ”On”

4.3.2

Store-Square Network

Select “Add New” when on the Networks tab, scroll down and select the “IPv4” (you can ignore IPv6 and keep it disabled) option to “Manual” Change the following parameters and then “save” settings.

If settings are not specified, they should be left at their default values.

Parameter Required Value
Network Name Store-Square
VLAN ID 2
Isolate Network Toggle to “On”
IGMP Snooping Toggle to “On”
Multicast DNS Toggle to ”On”

4.4.1

Store-Guest Network

Select “Add New” when on the Networks tab, scroll down and select the “IPv4” (you can ignore IPv6 and keep it disabled) option to “Manual” Change the following parameters and then “save” settings.

If settings are not specified, they should be left at their default values.

Parameter Required Value
Network Name Store-Guest
VLAN ID 3
Guest Network Toggle to “On”
IGMP Snooping Toggle to “Off”
Multicast DNS Toggle to ”Off”

4.5 4.6

SSID / VLAN / Network Mapping Scheme

The creation of different networks/VLANs means that local network traffic will only be able to communicate with other devices on the same VLAN. It also means that each individual port on your gateway and/or switch(es) will need to be configured properly when adding any new device that is not meant to be used on the Default network. In this scenario, when you plug in any Square POS equipment, or hardwired accessories (like printers) in a switch, you will need to map that port to the correct Square VLAN.

The “Default” network, corresponding to VLAN 1, will be used to automatically assign security cameras, access points, networking equipment, and other devices to VLAN 1. No user intervention is required for this process. If users want to add an access point or an additional security camera, they simply need to plug it into any port not designated for Square devices.

As this is the “Default” network, it will automatically be configured on all switch ports. The out of the box settings have switch ports that are set to the “default” network and also allow tagged traffic. Any untagged traffic will be assigned to VLAN 1, the native VLAN.

The “Store-Square” network corresponding to VLAN 2 will facilitate Square and other POS equipment. To place the devices into the correct network, the settings for each switch port require changes to the correct network. This will be covered at the end of the section.
The “Store-Guest “ Network corresponding to VLAN 3 will be used for Guest Wi-Fi, there should be no requirement for physical switch ports.
This setup shown in the table and diagram below:

SSID / VLAN / Network Mapping Table

SSID Devices Types: **VLAN ID ** Network Name Port Type
Store Employees Store cameras, laptops and any non square devices. VLAN 1 Default Access
Store Square Square equipment and devices. VLAN 2 Store-Square Access
Store Guest Guest Devices VLAN 3 Store-Guest Access

Making Changes to Ports for Square and other POS Devices

When adding Square or other POS devices, the relevant switch port needs to be configured with the Store-Square Network. Below has an example on how this can be done.

Go to the “Devices’ menu, and select the USW Switch, then select port where you plan to plug in your Square or other POS device. Adjust the parameters as specified below and click “Save” to apply the settings. If a parameter is not listed, keep its default setting.

Parameter Required Value
Network Store-Square
Tagged VLAN Management Block All

4.7 4.8

Si configuraste una red/VLAN aislada para tus dispositivos de PDV, deberás seguir los pasos anteriores nuevamente para configurar correctamente el puerto para los nuevos dispositivos de PDV cableados agregados a tu red.

Paso 5: Configura tu wifi

Para configurar las redes Wi-Fi, dirígete a “Ajustes ->  “Wi-Fi”  ->  “Agregar nueva”. Asegúrate de aplicar los siguientes parámetros para cada SSID.

SSID: Store Operations

Scroll down and choose the “Advanced” option, then set it to “Manual.” Adjust the parameters as specified below and click “Save” to apply the settings. If a parameter is not listed, keep its default setting.

Parameter Required Value
Name Store Operations
Network Default
Band Steering Toggle to “On”
BBS Transition Toggle to “On”
UAPSD Toggle to “On”
Multicast Enhancement Toggle to “On”

5.1 5.2

SSID: Store Square

Scroll down and choose the “Advanced” option, then set it to “Manual.” Adjust the parameters as specified below and click “Save” to apply the settings. If a parameter is not listed, keep its default setting.

Parameter Required Value
Name Store Square
Network Store-Network (if you configured this in the previous step)
Band Steering Toggle to “On”
BBS Transition Toggle to “On”
UAPSD Toggle to “On”
Multicast Enhancement Toggle to “On”

SSID: Store Guest

Scroll down and choose the “Advanced” option, then set it to “Manual.” Adjust the parameters as specified below and click “Save” to apply the settings. If a parameter is not listed, keep its default setting.

Parameter Required Value
Name Store Guest
Network Store-Guest (if you configured this in the previous step)
Hotspot Portal Toggle to “On” (if you want your guests to login through a portal, see the next section for more details)
Band Steering Toggle to “On”
UAPSD Toggle to “On”


Paso 6: Ajustes opcionales

Enable Automatic Speed Test

To enable the automatic speed test, navigate to the Settings at the bottom right of the app screen and select the “Internet” option. Enable the “Automatic Speed Test” option. You can set the schedule to run “daily” and specify the time, it is recommended to be outside of business hours. Tap Save.

6.1 6.2

Create a Guest Hotspot Portal

UniFi access points allow for branded customization when guests connect to a hotspot, along with support for requiring authentication, such as through Facebook or by entering a password that is handed out to guests on site. Access via the app is limited at this time, you can configure settings via https://unifi.ui.com/ using the following guide.

To manage UniFi hotspots:

  1. Navigate to https://unifi.ui.com/ and login with your credentials.
  2. Open the ‘Site’ for the store you just set up.
  3. Navigate to the Insights tab, on the top of the page click ‘Hotspot’.
  4. Select “Landing Page” from the segmented control.

Branding

From UniFi’s Hotspot Portal’s Branding tab, you can customize the experience and ensure access follows branding for your business, including:

  • A hotspot login page title, such as “Store Guest Wi-Fi”
  • Adding a welcome message such as “Welcome to Store!”
  • Requiring guests to accept terms of service you define, by checking the box next to “Terms of Service”
  • Customizing the logo; background color or image; and text and button colors people will see
  • Defining a Landing Page for guests after they connect to your network, such as by directing them to an online menu.

Authentication

From UniFi’s Hotspot Portal’s Authentication tab, you can customize the experience and ensure guest access is only available to people who should have access. Access limits can include having a shared password that is handed out to guests, and requiring authentication with Facebook.

Follow Facebook’s steps to create an App ID and enter it in UniFi’s portal if you would like guests to authenticate with Facebook, and optionally collect guest emails.

Access Settings

From UniFi’s Hotspot Portal’s Settings tab, you can control how often guest access is allowed for, along with any websites that guests are allowed to access without authentication.

By default, a guest session lasts for 8 hours, and guests will have to re-authenticate afterwards.

It is recommended to check “Secure Portal” under “Landing Page Settings”, and to add your business website under Authorization Access > “Add Hostname, IP or Subnet”.

Paso 7: Configura los ajustes de tu punto de acceso - Configuración avanzada (opcional)

Los puntos de acceso (AP) UniFi ofrecen numerosos ajustes y opciones de control para optimizar el rendimiento en varios entornos. Las configuraciones se pueden compartir entre dispositivos del mismo modelo. Por ejemplo, se puede crear y aplicar una sola configuración a todos los AP Ubiquiti UniFi U6+, mientras que se puede crear una configuración diferente para los AP Ubiquiti UniFi U6 Mesh.

De forma predeterminada, los puntos de acceso (AP) deben ajustar automáticamente los canales y otros ajustes según sea necesario. Si no lograr configurar manualmente estos ajustes, es aceptable usar los ajustes predeterminados y omitir este paso por completo. Las siguientes instrucciones te guiarán sobre la optimización de los ajustes que a veces pueden mejorar el rendimiento en entornos de red más complicados.

Step 1

To modify the settings, go to the UniFi devices section (the second icon from the bottom left). Select your U6+ AP, go to the insights tab, and select RF Environment, scan, a warning message will appear, select scan again, wait for the process, this can take 5 minutes.

7.2 7.5

Step 2

Once the scan completes, for each of the 2.4GHz, 5GHz, and 6GHz if available frequencies, find the channel with the lowest utilization rate, tracking what MHz frequency the channel is located in.
Within 2.4GHz, channels 1, 6, and 11 are preferred because they do not overlap with each other.
Within 5GHz, Digital Frequency Scanning channels - channels between 52 and 144— should be avoided.

Step 3

To modify the settings, return to the Devices tab and select the U6+ AP again. Navigate to the Settings tab at the top right of the screen. In the Settings tab, find and select the “Radios” section. For each of the 2.4GHz, 5GHz, and 6GHz (if available) frequencies, select the Channel Width and Channel discovered in the RF Environment scan. This is only required if the Radio Scan varies substantially with the current selected channels.

Step 4

Set the Transmit Power to Auto or ‘Medium’ for each frequency (see below). If 6GHz frequencies are available, ensure ‘Meshing’ is selected. Under ‘Location,’ enter the room name of the access point, such as Kitchen or Office. Finally, select “save” at the top right corner.

If settings are not specified, they should be left at their default value.

Parameter Recommended Value
Channel Width Discovered from the Radio Scan 2.4GHz: HT20 is recommended 5GHz: HT40 is recommended unless your scan uncovers significant conflicting traffic
Channel Auto
Transmit power Auto In deployments with many APs: Medium
Band Steering On - Prefer 5 GHz

Copy AP Configuration

To avoid repeating these steps for each AP, you can use the “Copy Configuration” feature for other APs. Note that you will still need to update the “Location” parameter for each AP individually.

To copy AP configuration:

  1. From the Devices tab, select the U6+ AP.
  2. Navigate to the Settings tab and scroll down to Copy Configurations.
  3. Copy and paste the AP configuration to another AP device.

Paso 8: Prueba tu configuración

La aplicación WiFiman ofrece información completa sobre la latencia de la red, la intensidad de la señal y la congestión de los canales, junto con recomendaciones de optimización. Se recomienda usar esta aplicación para realizar pruebas después de completar la configuración de la red.

La aplicación se puede descargar gratis en Apple iOS y Android.

WiFiman App Features

When you open the app, it provides a comprehensive overview of your Wi-Fi connection along with tailored feedback. The main screen shows several key items:

  • Connection Overview: Displays the connection status with your ISP (Telstra Internet in my case) and the devices connected to the network.
  • Wi-Fi Signal: Indicates the current signal strength, showing a strong signal at -50 dBm, which is optimal for most environments.
  • Channel Information: Displays the current channel (Channel 44) and Wi-Fi standard (Wi-Fi 6).
  • Speed Test Results: Shows the results of the most recent speed test, including download and upload speeds with a latency. It also provides a graph of the speed test performance over time.
  • Wi-Fi Speed Factors: Highlights important factors affecting your Wi-Fi speed. In this case, it shows the signal strength and the channel width (40 MHz). The app suggests increasing the channel width for better performance, which is particularly useful in environments with minimal congestion.
  • Additional Features: The bottom menu provides access to various tools such as signal analysis, network scanning, device discovery, and teleport (remote access or management).

8.1.1

The Signal Analysis Tab

This is useful for conducting a site walk to check AP handover/roaming, signal strength, throughput, and latency.

8.2 8.3

UniFi App Features

Within the UnFi App, there are 3 Ties: Speed Test, Topology, and Wi-Fi Signal. These features are also available from the WiFiman APP directly.

8.4 8.5