What is the basic6 platform?
The basic6 platform provides ‘Connectivity as a Service’ upon which users build their own application or work with us to tailor their IoT solution, without concerns for the infrastructure supporting it. The Basic6 platform is designed for ease of use, scalability and tight security and has open architecture flexible enough to be customized and integrate multiple 3rd party best-in-breed building blocks.
Why basic6’s IoT platform?
✓ Simple and scalable
✓ Simple self-registration gets you started right away
✓ Access, program, and update your devices from anywhere
✓ Three quick steps to configure your IoT devices to the B6 Platform
✓ Scales up to multiple thousands of devices
✓ No additional hardware required to deploy and scale your app
Features and Flexibility
✓ Real-time bi-directional communication
✓ Real-time monitoring and control of connected devices
✓ Open architecture allows customization of components, cost management
✓ Control and manage entire device deployment from a centralized, single-screen management interface
✓ Devices are easily clustered and configured together to perform tasks, real-time data exchange and updates
Security and Customizability
✓ Deploy devices behind firewalls
✓ Communication via encrypted and secure WebSockets
✓ Duplexed communication enables configuration of devices with immediate and actionable sensor data
✓ Customizable to fit beacon or sensor deployments
✓ On-demand health check of all devices
✓ If a device loses WiFi or power, it automatically becomes available once reconnected or powered on
Who can use the platform?
The basic6 platform can be used by anybody, from hobbyists and students to engineers to companies. b6Launch can be used for deployments of any size - from initial launch to full deployment. b6Industry refers to customization of the platform and engaging basic6 to customize your IoT solution.
Which boards does basic6 support?
basic6 officially supports the Arduino Yun and Yun Shield along with Raspberry Pi and BeagleBone Black. Official support for other boards is in the works. Do you have one in mind? Contact us and we’ll let you know where we stand!
Where are the programs I write stored?
User programs are stored in the cloud and can only be accessed by logging into the basic6 website.
Who can see my applications?
Nobody but you. Applications are not public and require a login in order for them to be visualized.
How is everything saved?
All sketches are automatically saved after upload (Arduino only).
Is the process secure?
Yes. The channel your device connects over is SSL-secured from the Linux board to our servers. We run no kind of server on your device.
Can I damage my board if I use basic6?
The installation of basic6 will not harm your board. However, basic6 takes no responsibility for any damage incurred to the board resulting from the misuse of connected electronic parts.
OK! I'm in!
After signing up:
1. You receive a user name and Device Token which you enter in a supplied device configuration script
2. Follow the steps in the quick start guide for your board type
3. Your device(s) is configured and ready for use
There are multiple types of accounts that can be activated depending on how you want to use the basic6 platform.
Maker account (Free): configure up to 5 boards and 1GB data transfer
Small account ($7.99/m): use up to 15 boards and 3GB data transfer
For more pricing, please go to our pricing page.
How do I pay?
All accounts start out as Launch accounts, so getting started doesn’t require a credit card. When you upgrade to more devices and data, you’ll pay by credit card: American Express, Visa, MasterCard or Discover, paid monthly on a pay-as-you-grow basis. We keep it simple, you’ll upgrade accounts when you need to manage more devices, data, or would like to upgrade your support plan. For plan, information, and billing information, please refer to the Pricing page.
Now I've started?
1. You receive a user name and Device Token which you enter in a supplied device configuration script.
2. Follow the steps in the quick start guide for your board type.
3. Your device(s) is configured and ready for use.
My board does not appear in the console after configuration, what can I do?
The most likely way to solve this issue is to re-generate a device token and re-install the provided basic6 technology. If you have any trouble after reinstalling, please contact us directly at email@example.com with ‘Installation’ in the subject line.
After signup, every basic6 user account receives a single, unique Device Token that is used for authentication across all connected devices. A device is initially registered via a combination of basic6 account credentials and device token. Once the process has completed, the device token is removed in favor of a device password, with no trace of the device token remaining on the individual devices.
Can I change my device token?
The device token can be quickly changed if there is any fear of compromise.
How do I replace it?
In the upper right portion of the screen, click on the user name and select Account from the drop down listing. On the left side of the Account screen select Device Token followed by the Generate button in the lower right. Just copy and save the new token.
What does the Execute Command do?
The Execute Command control allows you to send Linux commands directly to your device, and is particularly useful in most deployment scenarios when it is not possible to establish an SSH connection. Using this feature, any number of devices can be managed.
What happens if the command requires user input?
Currently, basic6 cannot execute commands that require user input.
How do I see my device’s Action History?
You can see the output of issued Programs and commands by "right clicking" on a device and selecting Action History. You can also click on the provided "Last Action Status" link provided in the device details display.
What will Action History show?
A device’s Action History will show sortable fields for Action Run, Status of Action, Last Update Time (when action executed). Clicking on an individual action such as Push Program or Command will yield info such as the run program name and/or results of command execution.
How do I find out if a Command has Run? (All Devices)
The result of any command sent to the device through Execute Command can be viewed by clicking on the provided link found in Last Action Status as seen below:
Simply select the Executed Command to Open and view output. The example below shows the output when the “date” command is run.
How do I get Device Status?
To get the latest status of your devices after you have sent your command, click on the refresh icon on the upper right screen of the device display.
How do I add/configure another device?
Utilizing the same method and credentials utilized in the initial configuration process (user name and device token), a user can configure multiple devices in sequence.
How do I know what version of basic6 is running on my devices?
Simply click on a selected device within the device container listing. Within the middle display screen you will see a field (toward the bottom of the screen) named Type. This displays currently installed version information.
How do I create a Device Group?
To create a group, click on the paper clip icon. You should see a popup that will ask for the new group name. Once you have created the group, you can add devices to that group using the '+' icon.
What does Push Program do?
The "Push Program" control allows you create custom computer programs (or sketches) and send them to your device(s) for processing. When you press the "Push Program" control, you will be presented with a popup dialog that will display your library of programs. You can add or delete programs from your library by using the "Add" and "Delete" buttons.
How can I Read/Write Files? (Raspberry Pi)
In order to write a file to the RPi using the “Execute Command” function, you can use the following:
1. Write command
echo “the info that you want in your text file” >> filename.extension
2. Read command
In order to read the file that you just wrote, you can use the command:
However, if you want to edit the file, the easiest would be to overwrite the file with the new data by using the write command again.
Also to note is that the execute command window can currently only fit 1024 characters which is the limiting factor on the size of the file that you can create.
What is a .hex File?
It is a single file, which contains the specific bytes that need to be written to the program memory of the chip on the Arduino board.
How do I create a .hex file output folder?
We have provided a document that walks you through the required steps: customizing a Hex file output.
Can I edit a File within basic6?
Right now, no. All file edits must take place outside of basic6. Any changes to files can be easily saved and re-uploaded to the Program Library.
What File Directory is Used? (All Devices)
It is also important to note that Execute Command runs out of the following directory on the device “/basic6/b6tech-X.X/” where X.X is the version number.
Is the process secure?
The channel your device connects over is SSL-secured from the Linux board to our servers. We run no kind of server on your device.
How do I access my Program Library?
If you want to quickly access your library of programs, there is a shortcut to get to this list. On the header, next to the Filter Devices search box, there is a drop-down that allows you to change between the current Device view or the Programs view. Simply select one or the other to navigate between the two views. basic6 provides a few built in sketches for your use.
basic6 account information is entered upon initial signup. If any of these entries need to be updated, proceed to the upper right portion of the screen, click on the user name and select Account from the drop down listing. On the left side of the Account screen select My Profile. Any of the field entries can be edited and saved.
In the upper right portion of the screen, click on the user name and select Account from the drop down listing. On the left side of the Account screen select Change Password. Enter current password followed by entry of new and confirming passwords. Click Save to process.
In the upper right portion of the screen, click on the user name and select Account from the drop down listing. On the left side of the Account screen select Delete Account. Click Yes to the right of “Are you sure you want to delete your account?” Please note that all device connectivity and login credentialing will be deleted.
Adding a Payment Method
After you select an upgraded plan, click the New Payment Method button and follow the steps. Please note basic6 does not store any card information.
Adding an Additional Card
In Settings, under Payment Methods, click on the Add button and follow the steps.
Setting Default Payment
In Settings>Payment Methods, choose the card you would like to be the default and click the "Make Default" button.
Deleting a Payment Method
In Settings>Payment methods, click on the card you'd like to delete and click Delete!
How often do I get billed?
If you are on the Maker Plan, you will not be billed and no credit card is required. All other plans are billed monthly on the first day of the month. All billing is on a prorated basis—meaning that if you were to sign up June 15th —you would only be billed for the 15 remaining days in the month.
What Device Plan am I on?
By default, all new users start with the Maker Plan which allows you to connect up to 5 devices with up to 1GB of data transfer per month. Plans can be upgraded for more data and devices. In UserName>Account>Plan you'll see your current plan.
How do I update my current device plan?
If you find that you need to add more devices than allowed in your current plan, you can upgrade the maximum devices in the plan section of your account. In the "Switch" section, select your new plan and follow the steps for payment. You will be notified via email of the successful Plan change.
How do I downgrade a device plan?
Under Account>Plans, select the new plan and then Downgrade>Cancel Current Plan. You'll receive a confirmation email.
What happens if I downgrade my plan?
If a user downgrades a plan to Maker, they will ONLY have access to the first five (5) devices that were configured to the account.