####[All Guides](wiki:/guides) | [Software Guides](wiki:/guides/software-guides) | [Hardware Guides](wiki:/guides/hardware-guides) | [Troubleshooting Guides](wiki:/guides/troubleshooting) | [Contact](wiki:/contact)
How to use the JBox manager to set up your monitor, diagnose and troubleshoot your JBox
------------------
### Access
------------------
#### Connection
- First make sure there is a physical connection to the device in the LAN port using an ethernet cable.
- Now ensure that the external machine has configured the port to be a DHCP client to automatically accept an IP address assignment from the JBox
#### Windows | #### Linux
------------- | -------------
1. Go to the Start Menu with the search field. Search “Ethernet settings”, go to the Control Panel page that is shown in the search list [image:60 size:medium] | 1. Open a terminal window
2. Go to the dropdown settings menu that will be called “Ethernet <number>”. Click “Edit” on “IP Assignment” - a dialog box will appear [image:59 size:medium] | 2. Ensure dhclient is installed - apt install dhclient
3. Select “Automatic Assignment”, click “Save” [image:61 size:medium] | 3. Run ip addr and identify the interface that is connected to the JBox
4. Automatic IP Assignment is now enabled on your connection to the JBox | 4. Run dhclient <interface>
- | 5. Run ip addr and ensure that an IP has been assigned to the interface in the range of 10.172.152.200 - 10.172.152.250
#### Login
- Open an internet browser
- Go to this link: http://10.172.152.1
- A page will appear with the Juggle Energy logo with a login form
[image:62 size:medium]
- The password to login is printed on a label stuck on the JBox named “Web password”.
- Enter the password and click “Log in”
- A page with a sidebar with various navigation options will appear with the main page being a form to enter Plant details, which is the first step of the “Setup Wizard”.
[image:63 size:medium]
### Setup Wizard
------------------
Setup Wizard is for configuring the JBox for the first time in specific steps. Some of these settings are synchronised with the Juggle Portal, so some data may be out of date on the Juggle Portal until there is a 4G connection for the JBox.
#### Plant Details
Plant Details are needed for creating the plant on the Juggle Portal automatically.
- **Plant Name**: this defines the name the plant is referred to as. If there is more than one JBox on a site, then it is advised to give it a unique name from the others, e.g. “Juggle Energy West”.
- **Description**: this is useful to know if there is any extra information, e.g. special consideration or configuration for this plant.
**Required: Plant Name, Description, Address Line 1, Town/City, Postcode, Country**
#### 4G Modem Settings
- These settings should only need to be set using the dropdown field, for either Juggle EE or Juggle Roaming SIM cards.
- More advanced settings can be set if “Custom” is selected. Changes made won’t take effect until the JBox has rebooted.
#### Network
- The static IP and subnet mask of the JBox on the LAN port can be changed here.
- The JBox is designed for optimal performance with separate WAN and LAN ports. Using the '_WAN_ as _LAN_ port' option to create a 2-port switch is strongly discouraged unless absolutely necessary.
- DHCP server settings can be changed here.
#### RS485 Port Settings
- RS485 port settings can be changed here for each of the 4 RS485 ports on the J-Box.
#### Device Configuration
- There are two display modes that can be chosen in the top left of the page: Table View and Card View.
- Depending upon the tier of the J-Box you have ordered, you will be able to activate reading of the number of devices allowed for the tier. For J-Box LITE, this is a maximum of 4 devices. The "Pro" tiers allow up to 128 devices to be configured.
- There is an Advanced mode toggle in the top right corner of the page, which will show advanced options and settings. It is advised to keep this on Basic mode.
- Plant Details must be set before devices can synchronise to the Juggle Portal. Devices that fail to synchronise with the Juggle Portal will show a warning message. This means that the details set will not show on the Juggle Portal yet.
##### **Add Device**
Devices can be added using the “Add Device” button. The details form will appear as a dialogue.
[image:64 size:large]
Enabled | TCP/IP, RS485/ Serial | Device Serial | Device Type | Address (Unit) ID |
------------- | ------------- | ------------- | ------------- | -------------
This toggles the Enabled state of the device | this changes the communication type of the devices and will show their respective settings in this dialogue | This number uniquely identifies the device. Each JBox can only have one device with a given serial number | this is a selection field with a list of devices that is supported by the JBox. Metre type devices will show an extra field for the type of meter | this is the Modbus Address/Unit ID of the device
Meter Type | Maximum AC power or DC kW peak | Read Rate | TCP/ IP | PS845/ Serial
------------- | ------------- | ------------- | ------------- | -------------
this is a selection field to specify the role of the meter. PV Generation will show an extra field for Maximum AC Power or DC kW peak | for PV meters, a DC KW peak should be set | this is the interval at which the JBox will monitor the device. 5 minutes is default and advised | IP Address: this is the IP address of the device the JBox is communicating to over the LAN port. Port: this is the port that is being used to connect to (Modbus TCP is default 502) | Serial COM Port: this is a selection field that lists which COM port device is connected to. The COM port communication settings can be modified in the COM Port options page.
##### **Edit Device**
Clicking the options icon on the device card or row will show some options for the device.
[image:65 size:large]
[image:66 size:large]
Edit Device | Duplicate Device | Device Parameters List | Delete Device
------------- | ------------- | ------------- | -------------
this will show an edit dialogue with the same fields as the Add Device dialogue | this will show an Add Device dialogue with fields automatically filled with information from the device selected. The device serial is not filled and must be unique among devices on this JBox. Address/Unit ID will be automatically incremented | this will show a dialogue listing the available parameters the JBox will read. Each parameter has a toggle to provide custom configuration of the device. By default all parameters are being read | this will remove the device from the JBox. However, if it has failed to synchronise with the Juggle Portal, it will remain in an archived state until it has successfully synchronised that it has been deleted. If it is in the archived state, you may restore back from the deleted state before it synchronises
### Monitoring
------------------
[image:67 size:large]
#### JBox Status
This is the Juggle sync status.
(!) - means it hasn't synced configuration with Juggle Servers.
- Check or wait for the JBox to connect to the internet
- Check that the SIM is inserted
- (ABC:XXXXX) - means it has synced with Juggle Servers and knows the Plant ID.
[image:68 size:orig] | [image:69 size:orig] | [image:70 size:orig]
------------- | ------------- | -------------
This is the Juggle sync status. (!) means it hasn't synced configuration with Juggle Servers. Check or wait for the JBox to connect to the internet and that the SIM is inserted.(ABC:XXXXX)means it has synced with Juggle Servers and knows the Plant ID. | This is the signal strength status, the bars indicate strength. | Flashing SIM card icon means there is no SIM card detected. Try restarting the JBox via the power cable if the SIM card is inserted.
#### **Alarms**
This page will show a list of current alarms that are active and the history of alarm states. They are defined with an Alarm ID and which process on the JBox it has been raised from.
#### **4G Modem**
This will show the current status of the 4G modem with information read from the modem itself, which include: IMEI, ICCID of the SIM card, and RSSI. This page will periodically refresh the status.
#### **Networking**
This page will show a list of common connections the JBox will make to the internet. The IP can be tested manually from this page by clicking on the IP addresses.
- DHCP server leases will be shown here.
- IP Routes will be shown here.
#### **Devices**
This page will list the devices that are currently configured to the JBox and their current status. It will show the last time it read from the device. This list of error status messages can be read if the Errors button is clicked.
There is also a button that will open a dialogue showing the last read data for each parameter for that device. This will periodically refresh the data.
### Diagnostics
------------------
#### **Modbus Manual Request Tool**
This tool can be used to test a Modbus connection manually to diagnose connectivity or integration issues.
[image:71 align:right size:large]
- Select what type of communication it is with the “Is TCP/IP device” checkbox.
- Enter the IP and port or choose the COM port to send the request from.
- Enter the details of the request and click the “Read” button to make the request.
- The output of the request will appear in the Log list on the right side.
- This can also send write commands to the device by entering the value and clicking the “Write” button. This should be done with caution and with full knowledge of the device the request is being sent to.
### Troubleshooting
------------------
#### **Alarms**
The alarms will show some information about the inner workings of the system, which may help in diagnosing issues that arise.
Relaying these onto support@juggle.energy will help Juggle Members in resolving any issues.
#### **Errors**
These are shown from the devices monitoring page. Here are a list of known errors that might happen with a configured device:
TCP/ IP Devices | RS845/ Serial
------------- | -------------
**“Device <serial> is not pingable”**: this indicates that there is a network issue such that the JBox has no route to the device. It may be that either: the JBox or device’s IP address is in the wrong subnet, the device is not powered on, or there is no physical connection to the device from the JBox.| **“Failed to read registers for block offset <offset> with Modbus error: Bad file descriptor(errno: <error number>)**.”: this indicates that there is a serial issue with the device. Check the either, the COM port is correct, the wires are in the correct order in the terminals, the Address/Unit ID is correct, the device is powered or, the device is connected, the correct Modbus type is selected.
**“Device <serial> port not open”**: this indicates that the device is reachable, but the port that is being used is not open on the device. This can mean either: the device is powered on, but in a crashed state; the port configured on the device does not match what is configured on the JBox; or there is an external firewall interfering with the request to the device. |
**“Device <serial> has a Modbus server error. Check Unit ID is correct.”**: this indicates that the device is on with the port open, but no reply is being received from the requests sent to it. This is likely due to an incorrect Address/Unit ID configured for the device on the JBox, the wrong Modbus type is selected for the device in the JBox devices configuration, or that the device is malfunctioning or misconfigured. |
#### **4G Connectivity**
If there are issues with connectivity via the 4G modem, you should check the following
- There is an aerial attached to the device (SMA male aerial)
- The aerial is mounted vertically.
- The aerial is not touching anything.
- The aerial should be as high as possible.
- The aerial should not be in any form of metal enclosure or cage.
- An outdoor mounted aerial will give an improved signal. Please ask for details of outdoor-rated antennae.
- Check that the aerial cable is not kinked or cable-tied too tightly, as this is a coax cable and easily damaged.
- There is a SIM card installed in the JBox
- The 4G modem settings have been set and have rebooted the JBox since
- A single press of the RESET button on the JBox will toggle a buzzer that will periodically beep according to how good the connection is: the quicker the beep interval, the better the signal is. This will be useful when positioning the aerial.
- Pressing a second time will use the LED flashing as the indicator.
- Pressing a third time disables the indicator.
#### **Audible Beeps**
- **Single Beep** - JBox has successfully started up.
- **Triple Beep** - Has acquired internet connection. This may take a few minutes, once the SIM card is installed. Restart the JBox via the power cable if the SIM card has been inserted after the JBox has started.
- **Slowing Triple Beep** - Did not acquire internet connection within 5 minutes. Check SIM is inserted, or needs to restart via the power cable.
If you require any help with the JBox please reach out to our [support.](wiki:/contact)
Feedback
This article was last modified: 18 Dec 2025, 1:39 p.m.