# UDR2 Digirule 2U Firmware Updater User Manual 8 January 2021 --- ## Introduction UDR2 is a utility used to install firmware updates on the Digirule 2U. Versions are available for Linux, Mac OS and Windows. This manual should be considered a supplement to the *Digirule 2U User Manual*. --- ## Getting Started Before running the utility, you need to download from the Digirule 2U website the hex file for the firmware you want to install. Example firmware file: `dr2u.firmware.22sep2020.hex` You also need to know the name of the USB device on your computer to which the Digirule 2U is connected. ### Linux `ls /dev/tty*` Example device name: `/dev/ttyUSB0` ### Mac `ls /dev/tty.*` Example device name: `/dev/tty.usbserial-DM038QQY` ### Windows `mode` , or use Device Manager Example device name: `COM3` And finally, the Digirule 2U must be in the proper mode to receive the firmware. Please refer to the *Digirule 2U User Manual* section *Updating the Firmware* for details on the exact procedure. --- ## Running the Utility The general syntax to invoke the utility is: `udr2 [options] <file device` The utility supports the following command-line options: | Option | Function | | ------ | -------- | | `--program` | program and verify (default) | | `--verify` | verify only (do not update) | Invoking the utility is slightly different depending on which operating system you use. All of these examples assume that the utility resides in the current working directory. ### Linux ``` pi@rpi0:~ $ ./udr2 < dr2u.firmware.22sep2020.hex /dev/ttyUSB0 Digirule 2U Firmware Updater | 18 Dec 2020 | KD0GLS Loading hex file... OK Opening port... OK Erasing flash... OK Writing flash............................... OK Verifying flash................................ OK Restarting Digirule... OK Closing port... OK ``` ### Mac ``` User@imac:~ $ ./udr2 < dr2u.firmware.22sep2020.hex /dev/tty.usbserial-DM038QQY Digirule 2U Firmware Updater | 18 Dec 2020 | KD0GLS Loading hex file... OK Opening port... OK Erasing flash... OK Writing flash............................... OK Verifying flash................................ OK Restarting Digirule... OK Closing port... OK ``` ### Windows ``` C:\> udr2 < dr2u.firmware.22sep2020.hex COM3 Digirule 2U Firmware Updater | 18 Dec 2020 | KD0GLS Loading hex file... OK Opening port... OK Erasing flash... OK Writing flash............................... OK Verifying flash................................ OK Restarting Digirule... OK Closing port... OK ``` > Tip: If the port device name is `COM10` or greater, it must be specified as `\\.\COMnn` --- <center> <img "height=50" src="https://i.imgur.com/WSqeSrI.png"> </center>
Last changed by  
 
Brad Slattery
1260

Read more

Digirule 2U FAQs

30 April 2022 Introduction This document contains answers to questions that have either been asked previously or are quite likely to be asked in the future. Links to specific sections of the online versions of the User Manuals are provided where they are deemed appropriate. This is by no means an exhaustive list and new FAQs will be added when and if required. FAQs Battery

4/30/2022
Digirule 2U User Manual

30 April 2022 Description The Digirule 2U is an Open Source Hardware programmable 8-bit binary computer built into a 20 cm (8”) PCB ruler. Full details can be found here: bradsprojects.com/digirule2 Features and Specifications Microchip PIC18F46K20 8-bit microcontroller

4/30/2022
DLDR2 Digirule 2U Download Utility User Manual

8 January 2021 Introduction DLDR2 is a utility designed to make it easier to download programs from a Mac to the Digirule 2U. Specifically, its purpose is to work around a difficulty with configuring the serial port from the Mac command line. This manual should be considered a supplement to the Digirule 2U User Manual. Getting Started Before running the utility, you need to know the name of the USB device on your Mac to which the Digirule 2U is connected. ls /dev/tty.*

1/9/2021
ADR2 Digirule 2U Cross-Assembler User Manual

8 January 2021 Introduction ADR2 is a traditional style command line cross-assembler for the Digirule 2U. Its purpose is to translate assembly language program source into machine code for downloading to the Digirule 2U. Versions are available for Linux, Mac OS and Windows. The assembler has the following features: Supports the entire Digirule 2U instruction set Supports directives for control of the assembly and listing process Supports definition of symbolic names to represent memory addresses and constants

1/9/2021
Read more from Brad Slattery
Published on HackMD