Hardware
Last updated
Last updated
In Ginjer, the “Hardware” page allows administrators to define new configurations for device hardware, which are essential for system-wide use. This section outlines how to access and utilize the "Hardware” page effectively.
To access the “Hardware” page, click on the “Hardware” button on top in “Setup” navigation bar.
Ginjer already has pre-configured device hardware that can be used in your solutions and projects at any time. Devices marked with a green check icon represent SenRa™ verified devices which have been pre-integrated with SenRa’s LoRaWAN® Network and tested in the field. Note: Pre-configured devices cannot be modified in the system
To add a new device hardware in Ginjer, follow these steps:
Navigate to the Hardware Page:
Click on “Setup” in the top navigation bar.
Select the “Hardware” .
Add a New Hardware:
Click on the “Create hardware” button located at the top right of the screen.
Fill Out the Add Harware Dialog:
Hardware Name: Enter the name of the device.
Hardware Type: Select the device type (LoRaWAN/BLE/Wi-Fi).
Description: Provide a brief description of the device.
Model Number: Enter the device model number.
Manufacturer: Select the manufacturer from the drop-down list.
Tag: Choose a tag from the drop-down list.
GPS Supported: Toggle the “GPS Supported Device” button to enable or disable GPS support .
Save the New Hardware:
After filling in all required fields, click on the “Save” button.
You can also filter devices by “Manufacturer” and “Tag”. Simply select the desired values and the view will automatically update with your filtered list. Alternatively, you can use the “Search” field to filter based on keywords.
To configure a device hardware in Ginjer, follow these steps:
Locate and Configure Device:
Navigate to the “Hardware” page.
Find the hardware you want to configure and hover on the card to see configure button.
Hardware attributes provide additional configuration logic that is not directly provided by the device payload or sensed by the device. Follow these steps to add attributes:
Open Attributes Tab:
In the configuration settings of the selected hardware, go to the “ Attributes” tab.
Add a New Attribute:
Click on the “Create Attribute” button.
Populate Device Attribute Fields:
Label: This label will be visible in the Add/Edit Device dialog in the Project Details Devices section. This appears only if the device being added has a Hardware attribute configured.
Key: This key will be used in the outputs coding section as a variable.
Type: Choose between “Text” or “Toggle.” The type determines whether the user needs to provide a value or set a flag when adding a device to a project. The selected type will display either a text field or toggle button in the Add/Edit Device dialog in the Project Details Devices section.
Default Value: (For “Text” type only) This value will be set by default in the “Text” field associated with the Attribute when adding a new device to a project. This field appears only if the device being added has a attribute configured.
Save Changes:
After populating all the fields, click on the “Save” button to save your changes.
Hardware outputs in Ginjer are functions created to decrypt a device’s payload using the raw data decoding logic provided by the manufacturer. These outputs allow Ginjer’s solutions to display data graphically and process it analytically. For information on creating solutions, please refer to the Solution section.
Adding Outputs
To add outputs, follow these steps:
Navigate to Hardware Configuration:
Go to the hardware you want to configure.
Select the “Outputs” tab.
Add New Output:
Click on the “Add Output” button.
In the “Add Output” dialog, choose the desired output from the “Output” drop-down list.
Create Output Function:
After selecting the output, an empty function will be created with two passed variables: packet and deviceAttributes.
Save Output:
After defining your output function, click the “Save” button.
The new output will appear in the “Outputs” tab.
Finalize Configurations:
To complete all output configurations, click on the “Save” button located in the top right of the screen.
Hardware controllers, also known as Downlink Interfaces, are used to send downlink commands to instruct the device to perform specific actions. Follow these steps to add and configure device controllers in Ginjer:
Steps to Add Controllers
Navigate to Hardware Configuration:
Go to the hardware you want to configure.
Select the “Controllers” tab.
Add a New Controller:
Click on the “Add Controller” button.
In the “Add Controller” dialog, choose the desired downlink interface from the “Downlink” drop-down list.
To add custom labels to the Downlink list, refer to the Labels section before adding your controller.
Write the Controller Function:
After selecting your Downlink interface, write the controller function according to the required logic.
Save the Controller:
Once you have completed writing your function, click the “Save” button.
The new controller will appear in the “Controllers” tab.
Finalize Controller Configurations:
To complete all controller configurations, click the “Save” button located in the top right of the screen.
In Ginjer, each hardware card contains three buttons that appear when you hover over the card. These buttons allow you to manage the hardware efficiently. The buttons available are:
Edit Button: Allows you to edit the device hardware details.
Configure Button: Enables you to configure the device hardware.
Delete Button: Lets you delete the device hardware.
Hover Over the Image of the card containing the hardware for which you want to change the image.
Click on camera icon
Upload or Drag and Drop the image
Save the changes to update the image associated with the hardware card.
