My IceCore notes

(Parent) Started 4Nov2019, updated 4Dec2019 – in work.

This note is a follow-up from My FPGA notes where the IceCore has been discussed extensively. This note is going to be with the hands-on experience, since I am at the moment (5Nov2019) awaiting two boards in the mail.

Fold handling

This blog note uses the Collapse-O-Matic WordPress plugin to handle text folding. In addition to expanding and closing them individually you may here:

Expand All
Collapse All

Status

Fig.6 – My IceCore box as of now (28Nov2019) (Pess for more pixels)

I now have made a box from two plastic trays, as I have come into a habit of doing. At the moment I have done very little soldering. I’ll draw some diagrams first, to make sure I get it right. In addition to the myStorm boards (below) it also contains some breakout boards from Adafruit and three buttons, available from the outside. I am so much looking forwards to this work!

The Adafruits boards are the following (standard disclaimer as for all of my blog notes):

  • Bi-Color (Red/Green) 24-Bar Bargraph Backpack Kit, with I2C (PID: 1721)
  • 16×8 1.2″ LED Matrix + Backpack – Ultra Bright Round White LEDs, with I2C (PID: 2038)
  • 10 Segment Light Bar Graph LED Display – White – KWL- R1025WB-Y, direct control of each LED, no mux’ing (PID: 1816)

To make a linear timer switch?

Fig.1 – Electromechanical timer switches. Everflourish and Theben (press for more pixels)

My goal is to make a timer switch with the IceCore FPGA board. In Verilog, doing circuit diagram drawing and using a hot soldering iron. The picture above shows the inspiration, the oldest ones I have in my box. There is no picture of any digital timer there, even if I have several. I don’t use them because they are so difficult to set up. Even changing between summer and winter time requires the paper manual.

For my timer switch I would need some buttons and a single 24 LED bargraph element mounted horizontally. So I just made up the term linear timer switch here. The ruler in the above picture is meant to show 24 LEDs which indicate that the switch will be on 08.00-11.00 and 18.00-24.00. 24 on the ruler?

Fig.2 – Linear timer scale 0..23

Shouldn’t it be 0 at the start instead, and no 24? The mechanical timers have 1..24, but that’s around a circle, and makes more sense there, because the numbers are across the index. Of ’24’ then ‘2’ is on the left side and ‘4’ on the right side of the midnight index. The only way I could do that with LEDs is to add a separate, skewed paper scale.

Fig.3 – Numbers around indices and wrap-around at midnight, as with circular layout

But perhaps with both 24 and 0, instead of the strange texting above. Like below. But then, the paper scale would become wider than the LEDs?

Fig.4 – Numbers around indices, but 0 at start of day = full 24 at midnight. Scale wider than LEDs

Some interesting matters to decide upon! Then I would need a 230V AC relay. It would become a prototype in a rather large box, expecting nothing but that future. I have no plans to make it a product, only to learn a lot. Especially FPGA and Verilog.

Credit: Mari

It was actually my wife Mari who helped me brainstorm what I might make. I told her about the radio chips in all the remote controls we had, ..not anything like that, but similar – and she reminded me of a timer switch where we have had comments on its ticking. Voila!

Unpacking

Fig.5b – Out of the sleeve.. No soldering done by me yet (press for more detail 7.2MB). Observe that female connector on the present MixMod testers  (9,10,11) shall be soldered underneath

---POS--- in the text below refers to the photo (above).

---POS--- ---PART---                                                            -Price-
          BlackIce Mx =                                                          $59.00
 1          BlackIce Mx carrier
 2          IceCore
 3, 4, 5  MixMod BreadBoard addon:        MixMod BreadBoard Triple (3 adaptors)  $14.95
 6, 7, 8  MixMod Prototype addon:         MixMod Prototype Triple pack           $14.95
 9,10,11  MixMod Tester (Extender) addon: MixMod Tester Triple (3 adaptors)      $14.95
12        MixMod 7-Segment Adaptor:       single MixMod 7-Segment Adaptor        $14.95
                                                                                $118.80
                                                                                -------
---POS--- ---PART---                                   
          BlackIce Mx =                                                          $59.00
13          BlackIce Mx carrier
14          IceCore
15        MixMod 7-Segment Adaptor:       single MixMod 7-Segment Adaptor        $14.95
                                                                                 $73.95
                                                                                -------
          Shipping                                                               $12.00
                                                                                -------
          SUM                                                                   $204.75 
                                                                                =======   

-----------NORWAY-------------------------------------------------------- $1 = 9.58 NOK
VAT        594 NOK    
Handling   158 NOK
           -------
SUM        748 NOK                      
           =======
                                                                             1961.63 NOK
                                                                             =========== 
TOTAL SUM  2709.63 NOK = $283.77
           ===========   =======

Important: Observe that female connector on the present (Nov2019) MixMod testers  (9,10,11) shall be soldered underneath. So this picture goes for some future version, according to @folknology.

My first impression is that the IceCore board, by visual inspection, looks like a very well designed and produced board. It does not feel fragile. Like any good board for home use it has silkscreen text, on both sides, even if there are only a few components on the bottom side. Nice. Plus, it is so small, only 50 * 50 mm. Much smaller than on the pictures 😜. It also has four 2.5 mm ⌀ fastening holes that are replicated on the carrier board. Nice II.

The package was made tracked for me, at no extra cost. This was nice since it took about nine days from UK to my post-in-shop office in Norway. However, there was no packing slip in the envelope (not box), so any customs authorities that might want to open and inspect would have to do the research themselves. This is possible, since all boards have their type in silkscreen. But a printout of the order from Tindie would not have hurt. The two BlacIce Mx boards were each in an anti-static bubble plastic envelope. All were taped well, and finally all had been slipped inside a larger anti-static plastic envelope. Then, a paper board to make it stiff (from a cat’s food box, so the seller most probably has a cat..). I was not impressed by the packaging. For $283 (total for me, including local VAT and handling) I think the risk (or rather consequence) would have been too high for me if something bad happened. Some of the connector’s pins were slightly bent; not a big problem. I have not tested the IceCore boards yet. Which I very much look forwards to!

This chapter was also posted at the Tindie shop where I bought the stuff, see https://www.tindie.com/products/Folknology/blackice-mx/. Except the photo.

The IceCore contents

  • Processor: ARMA STM32F730
  • FPGA: Lattice iCE40HX4K

BlackIce Mx = (IceCore + BlackIce Mx) @ BlackEdge

I will start with repeating a single paragraph from the previous note.

The heading’s formula is not as recursive as it looks:

@folknology writes at myStorm forum (here) that BlackIce Mx is composed of a core (IceCore) and a carrier (BlackIce Mx), these were built and designed to the BlackEdge standard. BTW ‘BlackIce Mx’ is commonly used to refer to the combination of these parts together which is a little confusing.. And @lawrie adds and BlackEdge is sometimes used to refer to the combination that includes the future ECP5 core, which is also confusing.

Also have a look at the BlackIce wiki [17] and BlackIce Mx eBook [18] in that blog note. Plus of course My FPGA notes (IceCore connections).

IceCore Getting Started's design

I follow the example from IceCore Getting Started at My FPGA notes [12]. Plus help on the myStorm forum, at IceCore getting _really_ Started on macOS where @folknology and @AndyCap helped. Observe I am always using Apple Mac and macOS.

Cloning the example code from GitHub

mymachine:~ teig$ git clone https://github.com/folknology/IceCore.git
Cloning into 'IceCore'...
remote: Enumerating objects: 104, done.
remote: Counting objects: 100% (104/104), done.
remote: Compressing objects: 100% (73/73), done.
remote: Total 1294 (delta 44), reused 71 (delta 26), pack-reused 1190
Receiving objects: 100% (1294/1294), 26.51 MiB | 8.40 MiB/s, done.
Resolving deltas: 100% (643/643), done.
Checking connectivity... done.
Plugging the IceCore to my machine and flashing it with new code

When I plug my micro USB cable to the rightmost connector on the IceCore the leftmost blue and the rightmost red LEDs are lit. In addition the center four LEDs are blinking. This is what it came with out of the box. Now we’ll reprogram it:

Downloading binary from Verilog example code

Open two terminal windows. The first goes like this:

Last login: Tue Nov 19 18:46:41 on ttys002
-bash: /private/tmp/com.apple.launchd..../org.macosforge.xquartz:0: Permission denied
Mountain Lion: X11 at http://support.apple.com/kb/HT5293 XQuartz-2.7.4.dmg
XQuartz (is X11) must be running
“Øyvind 2013.01.09 17:49 - running .profile C”
mymachine:~ teig$ bash
bash-3.2$ cat /dev/cu.usbmodem1421
<myStorm 0.601>

And the second Terminal window. This may be started any time, but the STM32 bootloader’s message <myStorm 0.601> must be present before the chip.bin is downloaded to it:

Last login: Tue Nov 19 20:34:38 on ttys003
-bash: /private/tmp/com.apple.launchd..../org.macosforge.xquartz:0: Permission denied
Mountain Lion: X11 at http://support.apple.com/kb/HT5293 XQuartz-2.7.4.dmg
XQuartz (is X11) must be running
“Øyvind 2013.01.09 17:49 - running .profile C”
mymachine:~ teig$ cd IceCore/Examples/blink
mymachine:blink teig$ ls
Makefile	blink.pcf	blink.v		chip.bin	chip.blif	chip.txt	chip.v		readme.txt
mymachine:blink teig$ cat chip.bin >/dev/cu.usbmodem1421
mymachine:blink teig$

Now the red LED shall blink. I will come back with compiling via make. This download also contains files like IceCore.sch (see below).

Flashing the code

@folknology wrote that “if you want it to be permanent switch the board into flash mode by pressing the mode button, the yellow LED will come on to indicate flash mode. Now when you program it, it writes to flash and will be permanent”.  This works!

Where is the USB connection and driver?

To check that the cable is ok for more than charging, start a Terminal window. Then run:

ioreg -p IOUSB

Among the other USB devices you should see the IceCore as something like this:

-o STM32 Virtual ComPort@14200000  <class AppleUSBDevice, id 0x10000bdd7, registered, matched, active, busy 0 (22 ms), retain 13>

Plus, if you, in the Terminal window do:

cd /
cd dev
bash-3.2# ls cu.usb*
cu.usbmodem1421

The driver for the IceCore i cu.usbmodem1421. It appeared when the unit was plugged in. Observe that macOS will return different values, but here ComPort@14200000 relates to cu.usbmodem1421. It’s plus 1 kind of (1420+1=1421). See USB driver @address plus 1? on the myStorm forum.

Current consumption

The IceCore draws 50-60 mA @ 5.04V USB. Rather impressing how little these millions of transistors need.

Building the code with make

The example source directories contain the makefile file. Open it in TextEdit just to see. You run it simply by typing make in Terminal. The log file is here:

195 – make blink log file – first part is initial build, and second part is the diff of the build logs:

I modified in blink.v from 24 to 26 and rebuilt. The diff log is in the second part of the file referred above. It now blinks 4 times slower. From a period of 1.34 s to 5.36 s. Even if I thought that this did not hint at a basic 25 MHz clk, it certainly does. Again, @lawrie helped me get things in place at the myStorm forum, see Blink example, clk frequency and blinking rate: the period is of course N+1 bits (25 and 27).

/******************************************************************************
*                                                                             *
* Copyright 2016 myStorm Copyright and related                                *
* rights are licensed under the Solderpad Hardware License, Version 0.51      *
* (the “License”); you may not use this file except in compliance with        *
* the License. You may obtain a copy of the License at                        *
* http://solderpad.org/licenses/SHL-0.51. Unless required by applicable       *
* law or agreed to in writing, software, hardware and materials               *
* distributed under this License is distributed on an “AS IS” BASIS,          *
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or             *
* implied. See the License for the specific language governing                *
* permissions and limitations under the License.                              *
*                                                                             *
******************************************************************************/

module blink(input clk, output led); /* clk is 25 MHz */

	reg [26:0] count; /* orig 24 */

	assign led = count[26]; /* orig 24 */

	always @(posedge clk)
		count <= count + 1;

endmodule

Also see Automatic generation of Makefile? on myStorm forum.

CAD/drawing tool iCircuit, Eagle, Fritzing or..?

This is for those who might use iCircuit (here) by Krueger Systems. The Comp_BlackIceMx.zip contains the following files:

Comp_BlackIceMx_MXn_generic.icircuit
Comp_BlackIceMx_MXn_generic.pdf
Comp_BlackIceMx_MX1.icircuit
Comp_BlackIceMx_MX1.pdf	
Comp_BlackIceMx_MX2.icircuit
Comp_BlackIceMx_MX2.pdf	
Comp_BlackIceMx_MX3.icircuit
Comp_BlackIceMx_MX3.pdf	
Drawing_100_TransparentIceBox.icircuit // Just to see how MX1-MX3 looks when used
Drawing_100_TransparentIceBox.pdf

However, I see in the IceCore.sch (dowloaded, see above) that it starts with

<!DOCTYPE eagle SYSTEM "eagle.dtd">
<eagle version="7.7.0">

which means that the IceCore people use Eagle (here). I read it is from CadSoft since its inception in 1988, but since 2016 as Autodesk. Trying to make an account on the Eagle pages I already had one, in the name of Autodesk of course. However, I see that it costs 191 NOK per month (but cheaper for you guys: UK 12£, US 15$) – ruled out for me. I don’t want subscriptions of that type and size. But there is a limited and free download (compare here – also referred to from the Norwegian page). I did download Autodesk_EAGLE_9.5.2_English_Mac_64bit.pkg and the install took more than 500 MB. I started it (with a log-on), and I do see that I probably should learn to input to it. But as a start I can now open the sch-files that come with IceStorm.

I already have Fritzing installed – but then, I like to draw diagrams with IEC symbols, not connection-type diagrams as starting points.

My open scratchpad

Connecting not yet existing boards

  1. I have queried about how 5V goes through on the myStorm forum (here)
  2. Level shifting needed for Adafruit 1721 and 2038 LED boards (above)
    1. Adafruit product 757 (here) is a bidirectional level shifter that also works with the pull-ups of the I2C bus
    2. Also a SparkFun BOB-12009 here (available from DigiKey in Norway)
    3. They both to follow NXP (Philips) application note AN10441 (here)
    4. There are circuit diagram examples from Adafruit products that have built-in level shifting, like displays (here).
    5. It is based on the N-channel BSS138 MOSFET, which does not seem to have any through hole versions (StackExchange: here). At Elfa Distrelec in SOT-23 as 300-41-274 (here). SOT-23 since I have Adafruit SMT breakout boards 1230 (here)
    6. I have an I2C isolater click board from MIKROE (here). It is based on an Texas Instriments ISO1540 (here). But this isolates as well as shifts levels

myStorm forum

Newest on the bottom. I am only listing those that I have started. I give summaries, but you need to go there to get the details and see who took the time to answer:

  1. Continues from here
  2. Kneading on which breadboard? There are four expander/extender breadboards. This topic also contains an overview of them all plus circuit diagrams:. More in the post:
    1. MixMod Breadboard
    2. MixMod Proto
    3. MixMod Tester (Extender)
    4. MixMod 7-Segment Adaptor
  3. Driving LEDs directly from ICE40 pins? – 5Nov2019
    1. Pin outputs are max. 3V3 @ max 8 mA (push to max-0.4V and also pull low to 0.4V)
    2. Direct connection of 24 LEDs @ 1k should then be ok (about 1mW per LED)
    3. There are no high current LED driving pins on the ICE40 that’s used on the Mx board
  4. I2C as in comm bus or something else? – 5Nov2019
    1. I2C or I2C is always, in any context Philips communication with SDA and SCL lines etc.
    2. Any I2C functionality from the ICE40 must be done in Verilog. Any pin may be used. There is a reference to an I2C “core” (as they call it) in the post
    3. The STM32 processor has SPI and I2C pins also on the BlackEdge connectors. There is a url to a diagram of the connections in the post
    4. Download of ICE40 configuration is via the USB PRG connector to the STM32 and then over SPI to ICE40. More in the post
    5. The Lattice documentation is difficult to read because they make it rather generic and then it’s difficult to extract what’s in it for me
  5. IceCore Getting _really_ Started on macOS – 19Nov2019
  6. USB driver @address plus 1? – 20Nov2019
  7. Automatic generation of Makefile? – 20Nov2019
  8. Blink example, clk frequency and blinking rate – 21Nov2019
  9. CAD or drawing tool? – 1Dec2019

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.