Only CoWorkr partners who maintain their own hardware will need to program hardware on the occasion that a firmware update is available.
Hardware includes CoWorkr Hubs and Sensors
CoWorkr Hubs are updated over-the-air (OTA) wherein as long as the Hub has a strong cellular connect, a full update can be made remotely. If a hub misses regular updates, a hard update using a SD Card may be required.
CoWorkr Sensors require being programmed directly using a programmer cable and Mac computer. Sensors can not be programmed over the air as CoWorkr Sensors only communicate 1 way (from the sensor to the hub).
1.3.1 Programming CoWorkr V2 Sensors
The CoWorkr sensor can be programmed using the Texas Instruments XDS200 "Debug Probe". This is a cable that connects your computer to your sensor over USB. The following steps will program your sensor.
- Download and install Texas Instruments CCS 7 or newer - Note: this is a large (700mb) file, you may consider using the "offline" option for installation if you have a slow connection. Ensure the CCS 7.0 is installed in the Mac OS applications/ti/ directory.
- Request the latest firmware version folder from firstname.lastname@example.org or your contact. This folder should then be placed on your computer's desktop.
- Remove the sensor board from the plastic enclosure. This can be done by releasing the snap-fit clasp from the side. note: be careful with the board, the sensor will be exposed.
- Insert a battery into the board. The LEDs will blink if the battery is sufficiently charged.
- Attach the XDS200 female adapter to the board's pins as shown in the image.
- note: be care, pins can easily bend and may damage the board.
- Once the XDS200 is attached to the sensor board's pin connection, open the programming folder from your desktop, open the desired firmware version, then double click the program script. The script file will be titled with the firmware type and XDS200 name, for example, "programIR_XDS200".
- This will open and run a small program in your Terminal application. When the programming is done, you'll receive a "Completed" notification at the end of the Terminal's command prompt.
- If any errors occur in the process, check the cable connection and the battery.
- After programming, make sure to remove the battery to reset the sensor board. Reinsert the battery now to turn back on or leave the battery out until the sensor is ready to use.
- Place the sensor board back in its enclosure.
1.3.2 Programming CoWorkr Hubs
The CoWorkr hubs are generally updated over the air (OTA) but if several updates are missed, one may need to be updated manually. This requires reflashing the microSD card used in the hub. These instructions are for the "Pi" based versions of the CoWorkr hubs. "Beagle Bone" versions of the CoWorkr hubs are no longer supported.
- Download the latest CoWorkr software for your Pi Hub from your contact at CoWorkr. note: This file is over 300 mb
note: this requires the use of a computer that has a SD card slot or a SD card reader attached, this also requires having an existing or new micro SD card with at least 16 gigabytes of storage
Do not skip any steps in this process
- Decompress the .XY Hub file that you downloaded. This can be done by double clicking on the file to expand it into a .IMG file. If your computer does not know how to decompress this file, please try using "The Unarchiver" - free software for expanding files.
- Insert your micro SD card into a SD card adapter and insert the SD card adapter into your computer or SD card reader.
- Open Etcher, choose the Hub .IMG file for the "Select Image" option
- Select the new micro SD card for the "Select Drive" option. Click "Flash"
- Once Etcher has finished, Eject the Micro SD card. Make sure that the hub is disconnected from its power source. Insert the MicroSD card into your Pi hub.
- Once the card is inserted, you may power the hub back on.
- You may check for the newly online hub at asia.coworkr.co/hubs or us.coworkr.co/hubs based on your region.
- Under the menu headers, click "App Start" to sort by the most recently turned on hubs to help identify your newly flashed hub.
- Once hubs have been successfully programmed, they can be assigned to your new workplace.