"Community" hardware unit
  • 29 Jul 2022
  • 3 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

"Community" hardware unit

  • Dark
    Light
  • PDF

Article Summary

We provide preconfigured audio capture hardware that can be installed in the studio to capture and send a contribution stream as input for our streaming service. This page covers details for our "Community" hardware option.

When using our hardware, the customer is still responsible for ensuring the device has appropriate internet access to connect to our platform. Customers must follow the requirements & recommendations as listed by the Stream service requirement prior to installing our device. If the internet connection is configured correctly, the device will automatically start sending the contribution stream after power on.

Package contents

  • 1x Raspberry Pi
  • 1x Raspberry Pi power supply (2-pin plug)
  • 1x Focusrite Scarlett 2i2 USB audio device
  • 1x USB3-A to USB3-C cable

You will need

  • Audio cables not included. Device requires dual analog input via XLR connectors or ¼” TS JACK.
  • Using ¼” TS JACK is recommended. The Focusrite preamplifier stage is automatically configured for a microphone when using XLR connectors and may degrade audio quality.
  • Network cable not included.

Network requirements

The device must be connected with a network cable to a router that:

  • Assigns an IP address to the device using DHCP.
  • Complies with the network requirements listed in Stream service requirements.
  • Can connect and send audio to port 8000 of the customer specific IP.

Our device requires DHCP to be active on the router it connects to. The device ships with a label that indicates it's MAC address, which can be used to assign a specific IP for it on the router. DHCP is typically enabled by default on all consumer routers, please consult your router's manual for details.

Network recommendations

  • To enable logging from your device, it needs to be able to connect to logs.papertrailapp.com port 49960. This allows our support department to remotely diagnose any errors.
  • To enable remote access to your device, it needs to be able to connect to your customer specific IP on port 10170. This allows our technical team to remotely diagnose and fix any errors.

If either of these ports are blocked by a firewall it will not affect the stream audio but limits our ability to diagnose any problems.

Testing your network

Use a laptop or PC connected to the same network cable that you would use for the device and visit http://iono.fm:8000/ in a browser to confirm that port 8000 is open for access.

Using the device

The device is pre-configured to connect to the right endpoint and automatically start sending the stream whenever an internet connection is available.

When installing the device:

  1. Before attaching power to the device, follow these steps.
  2. Connect the audio output from your mixing desk to the front input ports of the Focusrite audio device.
  3. We recommend two ¼'' TS jack cables instead of XLR.
  4. Ensure both the input ports on the Focusrite device is set to LINE and not INST to disable the instrument pre-amp.
  5. Connect the Focusrite unit to the Raspberry Pi using the provided USB cable.
  6. Connect the device to a router with a network cable for an internet connection.
  7. Ensure the network requirements as listed above is in place.
  8. Power up the device by plugging in it's power cable from the included power supply.

Once powered up with all connections configured correctly the device will start streaming automatically.

It may take up to 4 minutes for the stream to become available on it's public endpoints after powering up the device.

Usage notes

  • No screen is needed or login required. The device runs automatically after power-up.
  • The device detects the network and audio device only on startup. After making any changes to your networking configuration or changing any cables, please restart the device by removing and reinserting the power cable.
  • Customers are liable for theft or electrical damage. Please ensure the device is installed in a secure location with surge protection in place.

Sending to the secondary input

By default the device will send AAC audio into the primary input on our platform.

When sending in a secondary contribution stream into our platform alongside the device, it is important to match the codec between the two. Failure to do so may cause active listeners to be disconnected when switching between the primary and secondary inputs.

  • We recommend configuring the hardware/software sending the secondary stream to also use AAC (any bitrate). For example, the BUTT documentation for sending AAC audio.
  • Alternatively, contact our support team to assist with changing the format being sent by your device. (Requires remote access to be available, see "Device recommendations" above)

What's Next